SuperAPI AI 工具集

variable-library-cli

部署与运维

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能专门负责 Fabric Variable Library(变量库)相关事务,涵盖三方面:库定义(变量、默认值、类型、valueSets/*.json 覆盖文件、settings.json)、消费者引用中的变量库一侧,以及工作区中活动值集的项目状态与 CI/CD 行为。

主要能力与模式:技能是一个模式分发器,本身不含操作步骤。需先按请求选择唯一模式,再完整读取对应的 references/<mode>.md 后才可执行命令。authoring 用于创建或修改库定义(variables.json、settings.json、valueSets/<name>.json);consumption 用于把变量接入消费者项或解释消费者如何解析变量;operations 用于读取或切换活动值集,涉及阶段、Git 序列化与部署。

使用方式:所有 api.fabric.microsoft.com 调用必须携带请求头 x-ms-fabric-skill: variable-library-cli(az rest:--headers "x-ms-fabric-skill=variable-library-cli"),每次 LRO 轮询、fabric_lro 与重试都要带上。工作区与项 ID 需通过列举加 JMESPath 过滤获得,不得猜测 GUID。变更类模式最终必须发起状态写入调用:新建库为 POST /v1/workspaces/{ws}/items(type 为 VariableLibrary),修改为 POST /v1/workspaces/{ws}/items/{id}/updateDefinition;切换活动值集为 PATCH /v1/workspaces/{ws}/variableLibraries/{id},body 为 {"properties":{"activeValueSetName":"<name>"}},该操作不改 Git 文件、不出现在 Git diff 中。完成后应读回验证,operations 需用 GET /variableLibraries/{id}(通用 /items/{id} 不显示 properties)。

注意事项与限制:变量库有两个平面——Git 中的定义文件与工作区中的活动值集状态,二者不可混同。定义请求必须完全省略 format 字段,不得发送 format: null;不要使用 defaultValue、values 或 format;valueSets 覆盖值必须使用变量的原生 JSON 类型,不可字符串化。值集覆盖若与默认值相同应省略以免切断继承。读取布尔变量时用 str(value).lower() == "true",勿用 bool(value)。需求不明确(未给出变量、类型、默认值、值集)时应先澄清,不得编造配置。消费者的深层编写归属其他技能(pipelines、spark-cli、dataflows-cli、git-integration-operations-cli、deployment-pipelines-authoring-cli)。完整部署自动化建议使用 fabric-cicd;Variable Library 在内的具体端点、载荷模板等细节须读 references 文件,本简介未提供具体代码示例。