SuperAPI AI 工具集

mlv-operations-cli

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:通过 Fabric REST API 管理现有 Microsoft Fabric 物化湖视图(MLV)的刷新计划、选定血缘执行定义和作业执行,适合需要程序化自动化或 CI/CD 的场景。

主要能力:计划管理(创建 Cron/Daily/Weekly/Monthly 刷新计划、列出、查询、更新、删除);作业执行(触发按需刷新、列出运行历史、查询状态与进度、取消运行中作业);MLV 执行定义(创建、列出、查询、部分更新、删除,删除时关联计划一并移除)。计划与按需刷新默认刷新整条 MLV 血缘;如需只刷新选定 MLV 或选定上游湖仓,需先创建执行定义并在 executionData 中传入 mlvExecutionDefinitionId。

必要用法:所有 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: mlv-operations-cli(az rest 用 --headers "x-ms-fabric-skill=mlv-operations-cli"),包括每次 LRO 轮询、fabric_lro 与重试。az rest 需传 --resource https://api.fabric.microsoft.com。每会话首次使用需先运行 check-updates 技能。基础 URL 为 https://api.fabric.microsoft.com/v1。计划端点形如 /workspaces/{workspaceId}/lakehouses/{lakehouseId}/jobs/refreshMaterializedLakeViews/schedules;按需触发返回 202 与 Location 头中的作业 ID。需 Workspace Contributor 或 Admin 角色,支持用户身份与服务主体/托管标识。

限制:无公开 API 可列出湖仓中的 MLV(返回 404),需用户显式提供湖仓 ID 与表名;无法获取可视化血缘、数据质量指标或校验 schema。单个湖仓最多 20 个计划,一条 MLV 血缘只能有一个活动刷新计划。API 使用结构化类型而非 cron 字符串;endDateTime 必填;localTimeZoneId 使用 Windows 时区名。作业历史可能将计划运行显示为 jobType: MaterializedLakeViews,但调度路径使用 refreshMaterializedLakeViews,不可混用。运行历史保留可能有限,逐视图状态需在 UI 查看。执行任何操作前需人工确认(除非提示含 I pre-approve 或 proceed without confirmation)。