SuperAPI AI 工具集

dataflows-cli

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能专门管理 Fabric Dataflow Gen2 项目,包括连接与凭据、Power Query M 编辑、输出目标、已保存定义、刷新历史,以及 Gen1 到 Gen2.1 的升级。它本身是模式分派器,不含具体操作步骤,需按请求选择模式后先完整读取对应的 references/<mode>.md 文件,再执行命令。

主要能力与模式:authoring 用于创建或修改数据流,如连接设置、凭据、M 编辑预览、输出目标、updateDefinition;consumption 用于只读读取已保存数据流,如 getDefinition、参数、刷新历史、执行已保存或临时只读 M 查询并解析 Arrow;upgrade 用于通过 save-as 与 rebind 将 Gen1 升级到 Gen2.1,或评估升级就绪度与风险。

使用方式:先解析工作区与项目 ID,通过列出并过滤而非猜测 GUID。所有 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: dataflows-cli 头,az rest 使用 --headers "x-ms-fabric-skill=dataflows-cli",包括每次 LRO 轮询、fabric_lro 与重试。每个会话只读一次模式参考文件,需要更深内容时再按参考表打开对应子文件。

限制与注意:consumption 为只读,不得变更任何内容;authoring 的 executeQuery 仅为预览,不写入,最终需调用 updateDefinition 持久化,新数据流需先创建项目;upgrade 的 save-as 仅支持 Gen1 到 Gen2.1,源为 Gen2 或代际不明时应停止并说明无公开升级端点。若请求跨模式,应逐段处理并显式说明模式切换。工作区与项目解析、认证、分页、LRO 轮询等通用事项需参考 COMMON-CLI.md 与 COMMON-CORE.md。