SuperAPI AI 工具集

eventhouse-cli

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能负责 Fabric Eventhouse 与 KQL 数据库的架构与摄取管理,以及只读 KQL 分析。它是一个模式分发器,本身不含操作步骤,需先按请求选择模式,再用文件读取工具完整读取对应的 references/<mode>.md 后再执行命令。

主要能力:authoring 模式处理 KQL 管理命令(.create、.alter、.ingest、.drop)、策略、映射、函数与物化视图;consumption 模式执行只读 KQL(where、summarize、join、render)、用 .show 发现架构并监控摄取健康。consumption 只能发只读 KQL 和 .show,任何改变状态的 dot-command 必须切到 authoring 模式。

使用方式:先解析工作区与条目 ID,通过列出并用 JMESPath 过滤获得,不得猜测 GUID。所有 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: eventhouse-cli,az rest 用 --headers "x-ms-fabric-skill=eventhouse-cli",包括每次 LRO 轮询、fabric_lro 与重试。authoring 模式最终必须发出一个状态变更调用,例如 POST .../v1/rest/mgmt 携带 .create-merge table、.alter 或 .ingest 命令,仅展示命令不算执行。

适用场景:KQL 表达或存储在 KQL 数据库中的内容用本技能;流式拓扑用 eventstream-cli;针对 Warehouse 或 Lakehouse SQL 端点的 T-SQL 用 sqldw-* 技能。

限制:模式边界严格,跨模式需逐个处理并分别读取参考;模式不明确时应提一个简短澄清问题。参考文件应一次性完整读取,避免重复打开或 grep。具体端点、载荷形状与模板在对应参考文件中,本资料未提供完整细节。