C✳CODEZ.WIN
🌐 简体中文

Skill 多语言阅读指南

kql用途、用法与原始来源

掌握 KQL 语言,编写正确高效的 Kusto 查询语言 (KQL) 查询。内容涵盖语法陷阱、连接模式、动态类型、日期时间陷阱、正则表达式模式、序列化、内存管理、结果大小控制以及高级函数(地理、向量、图)。无论何时编写、调试或审查 KQL 查询(即使是简单的查询),都应运用此技能,因为“陷阱”部分可以避免最常见的错误,这些错误会浪费工具调用并导致代价高昂的重试级联。触发条件:KQL、Kusto、ADX、Azure 数据资源管理器、Fabric 实时智能、EventHouse、日志分析、日志分析、数据探索、时间序列、异常检测、汇总、WHERE 子句、连接、扩展、投影、let 语句、解析运算符、提取函数以及任何提及管道前向查询语法的内容。

原文采集时间:

来源仓库
microsoft/skills
SKILL.md
.github/skills/kql/SKILL.md
仓库 Star
3,157
仓库最近更新
2026/10/31
能力分类
数据
最近采集时间

许可:MIT

流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill,不属于实测评测。

下面的用途和操作片段来自上游文档,由本站整理并翻译,和另行标注的 Codez 编辑分析分开展示。

这个 Skill 能做什么

掌握 KQL 语言,编写正确高效的 Kusto 查询语言 (KQL) 查询。内容涵盖语法陷阱、连接模式、动态类型、日期时间陷阱、正则表达式模式、序列化、内存管理、结果大小控制以及高级函数(地理、向量、图)。无论何时编写、调试或审查 KQL 查询(即使是简单的查询),都应运用此技能,因为“陷阱”部分可以避免最常见的错误,这些错误会浪费工具调用并导致代价高昂的重试级联。触发条件:KQL、Kusto、ADX、Azure 数据资源管理器、Fabric 实时智能、EventHouse、日志分析、日志分析、数据探索、时间序列、异常检测、汇总、WHERE 子句、连接、扩展、投影、let 语句、解析运算符、提取函数以及任何提及管道前向查询语法的内容。

如何使用:上游操作流程

KQL精通

> 自己试试:全部✅该技能的示例可以针对公共帮助集群运行:>https://help.kusto.windows.net, 数据库Samples(包含)StormEvents,SimpleGraph_Nodes/Edges,nyc_taxi等等)。

原文片段 · L6 ↗

1KQL基础知识

Kusto 查询语言 (KQL) 是一种用于探索数据的管道前向查询语言。它是 Azure 数据资源管理器 (ADX)、Microsoft Fabric 实时智能 (EventHouse)、Azure Monitor 日志分析、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。注意:接近 bin 边界的值可能会落在相邻的 bin 中——为了提高精度,请考虑检查相邻的 bin 或重叠范围。

原文片段 · L85 ↗

开始使用前

  1. 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档,只复制 SKILL.md 可能漏掉依赖。
  2. 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境,本站不假定存在通用的安装命令。
  3. 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作,应逐项核对后再授权。
  4. 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高,都不能证明结果正确。

Skill 文件与目录格式规范 ↗

继续阅读原始文档

翻译与介绍范围

本页从固定版本的上游 SKILL.md 整理用途与操作片段,译文使用辅助翻译。它不是完整手册,也不代表经过兼容性实测;使用前请核对原文及其引用文件。

介绍依据下方列出的固定版本;当前仓库动态和目录采集时间单独展示。

固定版本来源
阅读原文 ↗
原文采集时间
来源提交版本
00d66a64919edca5bca2c673373444e36a4b5461
原文 SHA-256
ffc1f17ed69d34dd5e8130cf1fc4adf9f3ea27410e8aa90f0cc1e5385f315ce2
返回完整 Skill 目录