SuperAPI AI 工具集

dataflows-authoring-cli

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:这是一个面向 Fabric Dataflows Gen2 的命令行写作技能,围绕 Fabric API 完成数据流的创建、更新、删除与刷新,并生成 mashup.pq、queryMetadata.json 等定义文件,支持在持久化前预览候选的 Power Query M。

主要能力:提供四类工作流——A 端到端新建数据流(发现或创建连接、创建数据流外壳、一次性写入 M 与连接绑定、校验、可选刷新);B 修改已有数据流(发现→构建→执行→验证);C 预览驱动的写作循环,先用 executeQuery 迭代候选 M 再通过 updateDefinition 持久化;D 配置输出目标,将查询结果写入 Lakehouse 表/文件、Warehouse、ADX 或 Azure SQL。工具栈为 az CLI、jq、base64、curl,创建流程还需 uuidgen。

必要用法:先按 COMMON-CLI.md 完成 az 登录与令牌获取,并通过列出工作区、再列出数据流的方式,借助 JMESPath 过滤定位工作区 ID 与数据流 ID。新建时通常先 POST 创建工作区下的数据流外壳,再以 POST updateDefinition?updateMetadata=true 写入 mashup.pq、queryMetadata.json、.platform 三部分,其中 connections[].connectionId 为包含 ClusterId 与 DatasourceId 的复合 JSON 字符串。绑定是否生效应以 getDefinition 校验为准,而非 GET /items/{id}/connections。刷新时首次需带 executeOption=ApplyChangesIfNeeded,并轮询 LRO。

适用场景:需要以命令行或自动化方式管理 Fabric Dataflows Gen2 定义、连接与输出目标的开发与运维场景。

限制:任何变更前必须确认足够的用户意图,若请求笼统须先提出结构化澄清问题再变更;不得从无关项推断需求。每次会话首次使用须先执行更新检查技能。若 Power BI 网关接口返回 401/403 或无 ClusterId,可降级为仅预览、不声明有效绑定、不刷新。是否支持图形界面、具体收费与价格资料暂未提供。