Локализованное руководство по чтению

kqlНазначение, использование и источник

Знание языка KQL для написания корректных и эффективных запросов Kusto Query Language. Рассматриваются синтаксические ошибки, шаблоны объединения, динамические типы, проблемы с датами и временем, шаблоны регулярных выражений, сериализация, управление памятью, дисциплина размера результата и расширенные функции (географические, векторные, графовые). Используйте этот навык при написании, отладке или проверке запросов KQL — даже простых — поскольку раздел об ошибках предотвращает наиболее распространенные ошибки, которые приводят к нерациональному использованию инструментов и дорогостоящим каскадам повторных попыток. Ключевые слова: KQL, Kusto, ADX, Azure Data Explorer, Fabric Real-Time Intelligence, EventHouse, Log Analytics, анализ логов, исследование данных, временные ряды, обнаружение аномалий, summarize, where clause, join, extend, project, let statement, parse operator, extract function, любое упоминание синтаксиса запросов с перенаправлением конвейера.

Источник получен: 2026-10-29

Репозиторий-источник: microsoft/skills
SKILL.md: .github/skills/kql/SKILL.md
Звёзды репозитория: 3,157
Последнее обновление репозитория: 2026-10-31
Категории Skills: Данные
Время последнего сбора: 2026-10-31 10:38 UTC+08:00

Лицензия: MIT

Оригинальный файл SKILL.md

Приведенные фрагменты описания рабочих процессов являются вспомогательными средствами для чтения, а не исполняемыми инструкциями от Codez. Для создания этой страницы не использовались сторонние инструменты.

Приведённые ниже фрагменты, описывающие цели и рабочие процессы, представляют собой исходный материал, систематизированный и переведённый для удобства чтения. Они отличаются от отдельно обозначенного редакционного анализа Codez.

Что делает этот навык

Как работает рабочий процесс на вышестоящем уровне

Мастерство KQL

> Попробуйте сами: Все✅Примеры из этой области знаний можно запускать в общедоступном кластере справки: >https://help.kusto.windows.netбаза данныхSamples(содержитStormEvents,SimpleGraph_Nodes/Edges,nyc_taxiи многое другое).

проход вверх по течению · L6 ↗

1Основы KQL

Kusto Query Language (KQL) — это язык запросов с прямой передачей данных для исследования данных. Он является собственным языком запросов для Azure Data Explorer (ADX), Microsoft Fabric Real-Time Intelligence (EventHouse), Azure Monitor Log Analytics, Microsoft Sentinel и других служб данных Microsoft.

проход вверх по течению · L11 ↗

Синтаксис пересылки конвейера

KQL-запросы представляют собой цепочку операторов, разделённых|Данные поступают слева направо:

проход вверх по течению · L15 ↗

проход вверх по течению · kql ↗

StormEvents                          // start with a table
| where State == "TEXAS"             // filter rows
| summarize count() by EventType     // aggregate
| top 5 by count_ desc              // limit results

Требования и настройка

5Требования к сериализации

Оконные функции требуют сериализованного (упорядоченного) ввода. Функции, требующие сериализации:row_number(),row_cumsum(),prev(),next(),row_window_session().

проход вверх по течению · L144 ↗

Ограничения и проверки качества

3Объединяйте шаблоны и подводные камни.

В операторах объединения KQL используются ограничения, отличающиеся от ограничений SQL.

проход вверх по течению · L81 ↗

Только равенство

Поддержка условий присоединения KQL.==Нет, !=, or function calls in join predicates. For range joins, pre-bin values: | extend bin_val = bin(Value,100), then join on bin_val. Примечание: значения, близкие к границам интервалов, могут попадать в соседние интервалы — для большей точности рекомендуется проверять соседние интервалы или перекрывать диапазон.

проход вверх по течению · L85 ↗

Начните с безопасного пробного периода.

Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.

Формат навыков и спецификация каталога ↗

Подробнее читайте в источнике.

Перевод и сфера применения

В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.

Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.

Закрепленный источник: Прочитайте оригинал ↗
Источник получен: 2026-10-29T09:32:23Z
Исходный коммит: 00d66a64919edca5bca2c673373444e36a4b5461
Исходный SHA-256: ffc1f17ed69d34dd5e8130cf1fc4adf9f3ea27410e8aa90f0cc1e5385f315ce2

Вернуться к полному каталогу навыков