SuperAPI AI 工具集

eventschemaset-cli

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能专门管理 Fabric 的 Event Schema Set 目录项,即事件类型与消息负载架构的注册表。它分为两种模式:authoring 负责创建、重命名/改描述、覆盖定义、删除;consumption 负责列出、搜索、查看属性,以及解码定义以枚举 eventTypes 和 schemas。

主要能力:authoring 对应 Create、Update、UpdateDefinition、Delete 操作;consumption 仅执行只读的 List、Get、GetDefinition。Create 与 UpdateDefinition 可能返回 202 Accepted(LRO),需捕获 Location 头并轮询至 Succeeded。

使用方式:先按请求选择唯一模式,再用文件读取工具完整读取对应的 references/authoring.md 或 references/consumption.md,之后才执行命令。所有 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: eventschemaset-cli 头(az rest 用 --headers "x-ms-fabric-skill=eventschemaset-cli"),包括每次 LRO 轮询、fabric_lro 和重试。工作区与项 ID 必须通过列出并过滤获得,不得猜测 GUID。authoring 模式必须以一次状态变更调用收尾,否则未持久化。

适用场景:列出或搜索 Event Schema Set、查看项属性、解码定义、获取 schema 版本、列出业务事件;创建、重命名、覆盖定义、删除 Event Schema Set,或向其中添加事件类型。

限制:该功能处于 Preview,行为、响应结构和可用性可能变化。文档标注仅支持委派(用户)身份,服务主体和托管身份列为不支持,但 Preview 期间 SP/MI 访问可能成功且取决于租户;遇到 401/403 应回退到委派用户身份。Delete 使用 ?hardDelete=true 时不可恢复,UpdateDefinition 会替换整个定义,执行前需确认。注意区分 EventSchemaSet 与 Eventstream、Eventhouse/KQL Database,后两者应分别使用 eventstream-cli 和 eventhouse-cli。