用途:通过 Fabric Items REST API 只读消费 Microsoft Fabric 的 Event Schema Set(事件架构集),即集中管理事件类型与消息架构的目录。该技能仅支持读取,不执行任何写入操作。
主要能力:列出工作区中的事件架构集;获取单个事件架构集的属性(id、displayName、description、type、workspaceId、folderId、properties.oneLakeRootPath、sensitivityLabel.id、tags);调用 getDefinition 获取定义并 base64 解码,汇总 eventTypes 与 schemas;对配置做只读校验,如每个事件类型使用内联 schema 还是 schemaUrl、schema 格式与版本数量、eventTypeCategory 分布。
使用方式:使用 az cli 的 az rest 调用,必须携带 --resource https://api.fabric.microsoft.com;每次 api.fabric.microsoft.com 调用需带 x-ms-fabric-skill: eventschemaset-consumption-cli 头(az rest 用 --headers "x-ms-fabric-skill=eventschemaset-consumption-cli"),包括所有 LRO 轮询与重试。用 JMESPath 过滤解析工作区名到 ID、条目名到 ID。列表接口需处理 continuationUri/continuationToken 分页。getDefinition 是 POST,需发送空 JSON 体 --body '{}',否则可能返回 411;若返回 202 Accepted,需按 LRO 模式捕获 Location 头并轮询。解码时选取 .path != ".platform" 的部分,用 base64 -d(macOS 用 base64 -D)解码。
适用场景:查询工作区中的事件架构集清单、查看某架构集的 OneLake 路径与敏感度标签、解码定义并汇总事件类型与架构、获取指定 schema 版本、校验目录配置。
限制:该技能为只读,拒绝创建、更新、重命名、删除等写入请求,写入需使用 Fabric Event Schema Set 授权 REST API。Event Schema Set 及其 List、Get、GetDefinition 操作目前为预览版,行为与响应结构可能变化。官方文档称仅支持委派用户身份,服务主体与托管标识不受支持;预览期实际可能因租户而异,若 SP/MI 调用返回 401/403,应回退到 az login 用户身份。getDefinition 需要 Item.ReadWrite.All 权限,List 与 Get 需要读取权限。Eventstream 与 Eventhouse 均不同于 Event Schema Set,相关操作应使用对应技能。首次使用需运行 check-updates 检查更新。
工具栈:az cli、jq、curl(用于 fabric_lro 轮询 202 响应)。