用途:通过 CLI 在 Microsoft Fabric 中创建和演进 Ontology(预览版)项,定义实体类型、属性(含时序属性)、关系类型,并绑定到数据源。
主要能力:Ontology 以 JSON 文件树形式作为项定义,通过 Create/Update 定义信封的 parts[] 数组(payloadType 为 InlineBase64)承载。支持实体类型(EntityTypes/{id}/definition.json)、数据绑定(DataBindings/{guid}.json)、关系类型(RelationshipTypes/{id}/definition.json)及上下文(Contextualizations)。属性 valueType 允许值:String、Boolean、DateTime、Object、BigInt、Double(整数用 BigInt,无 Guid 类型)。
使用方式:先运行 check-updates 技能(每会话一次)。使用 az login 获取令牌,控制平面 audience 为 https://api.fabric.microsoft.com。通过 JMESPath 过滤解析工作区、湖仓、Ontology 项 ID。createItem/updateDefinition 返回 202 与 x-ms-operation-id 头,建议轮询 https://api.fabric.microsoft.com/v1/operations/{operationId}。写入前须执行 preview-and-confirm。
限制:Ontology 为预览版,功能与格式可能变化。关系类型需两个已存在的实体类型。Eventhouse(KustoTable)源仅支持 TimeSeries 绑定,静态绑定须来自湖仓。属性名在单个实体类型内及跨实体类型需保持唯一与类型一致。部件路径必须用正斜杠。PowerShell 的 ConvertTo-Json 可能重排键,建议用 jq 构建 JSON。避免使用 certutil -encode 处理 InlineBase64。