用途:该技能负责 Fabric Eventstream 实时摄取拓扑的端到端管理,包括源、算子、目标、路由、保留与健康状态。它本身是模式分发器,不含具体操作步骤,需先按请求选择模式,再用文件读取工具完整读取对应的 references/<mode>.md,然后才执行命令。
主要能力:authoring 模式用于创建、更新、连线、暂停、恢复或删除 Eventstream 拓扑,例如创建 eventstream、部署拓扑、添加源、添加过滤算子、连接目标、更新定义;consumption 模式为只读,用于列出或检查 Eventstream、拓扑、保留、吞吐、节点健康或 Custom Endpoint 连接元数据。
使用方式:所有 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: eventstream-cli 头(az rest 用 --headers "x-ms-fabric-skill=eventstream-cli"),包括每次 LRO 轮询、fabric_lro 与重试。先通过列出并 JMESPath 过滤来解析工作区与 Eventstream 的 ID,不要猜测 GUID。authoring 的终止写入为 POST /v1/workspaces/{ws}/items 或 /eventstreams 创建、POST .../updateDefinition 持久化拓扑、无请求体的 POST .../pause 或带必填 JSON startType 请求体的 POST .../resume,或 DELETE .../eventstreams/{id}。consumption 无写入。
适用场景:创建或修改 Eventstream 拓扑、检查拓扑与运行状态、查看保留与吞吐设置、获取 Custom Endpoint 连接元数据。
限制:consumption 只读,任何创建、更新、删除、暂停、恢复都需切到 authoring 并先读对应参考文件。不要用 Eventstream API 查询已落地的事件数据,应使用 eventhouse-cli 的 consumption 模式;告警使用 Activator 相关技能。authoring 节点名保持字母数字 PascalCase(平台生成的 DefaultStream 除外)。获取 Custom Endpoint 凭据前需用户明确确认,除非用户在安全上下文中明确要求,否则不要打印原始密钥或连接字符串。若请求缺少源、目标、转换、保留或吞吐要求,应先提一个简短澄清问题,不要臆造拓扑。仅阅读参考文件或规划拓扑不算完成任务,必须执行状态变更调用并确认成功,必要时回读定义或运行时拓扑验证。