用途：该技能用于对 Microsoft Fabric Eventhouse 中的 KQL 数据库执行只读查询，面向实时智能与时间序列分析场景。它不创建、修改或删除数据库对象；表管理、数据摄取与策略等写入操作需交由 eventhouse-authoring-cli 处理。
主要能力：通过 az rest 调用 Kusto REST API 运行 KQL 查询；发现工作区与项（含 ID）；发现表、列、函数、物化视图、策略、外部表与摄取映射；执行时间序列、Top-N、百分位与动态字段等常见消费模式查询；监控活动查询、近期命令与摄取失败；将结果导出为 JSON 或 CSV。
使用方式：需安装 az cli 与 jq。先用 Fabric REST API 解析工作区 ID 与 KQL 数据库的 queryServiceUri，再设置 CLUSTER_URI 与 DB_NAME。查询时向 ${CLUSTER_URI}/v1/rest/query 发送 POST，--resource 使用 https://kusto.kusto.windows.net。由于 KQL 中的管道符会破坏 shell 转义，必须把 JSON 请求体写入临时文件并用 --body @file 引用。探索数据时建议依次执行 .show tables、.show table <TABLE> schema as json、<TABLE> | take 10，再构造针对性查询。
适用场景：需要以 CLI 方式对 Eventhouse 做数据探索、时间序列聚合、跨数据库查询与结果导出的分析与运维场景。
限制与注意：查询须带时间过滤（如 where Timestamp > ago(...)）；大表避免 contains，优先 has；join 前先过滤两侧；时间序列 summarize 需配合 bin()；集群 URI 按项解析，不要硬编码。默认结果上限 500K 行，可用 set truncationmaxrecords = N 调整。403 需申请 KQL 数据库 viewer 角色；401 多为 --resource 受众错误。首次使用需先运行 check-updates 技能检查更新。