用途:通过 az CLI 以只读方式监控、检查和查询已保存的 Fabric Dataflows Gen2,适合排查刷新历史、查看 Power Query M 代码、发现参数与连接信息。
主要能力:列出工作区与数据流;获取数据流属性;发现参数;通过 getDefinition 获取并解码定义(mashup.pq、queryMetadata.json、.platform);查看作业实例与刷新历史;执行单个查询并解析结果。
使用方式:先运行 az login,所有请求需带 --resource "https://api.fabric.microsoft.com"。用 list-then-filter 模式按 displayName 查找工作区与数据流 ID(无服务端名称过滤)。getDefinition 是 POST,可能返回 202 并需轮询 Location;定义内容为 base64,需解码后查看。executeQuery 返回 Apache Arrow IPC 流(Content-Type: application/vnd.apache.arrow.stream),不是 JSON,需用 pyarrow.ipc.open_stream() 解析;即使底层查询失败也可能返回 200,错误嵌在流元数据中。
限制:严格只读,禁止创建、更新或删除数据流及其定义,仅允许 getDefinition 与 executeQuery 两个读侧 POST。getDefinition 需要 Contributor 及以上角色,Viewer 会返回 403。非参数化数据流的 /parameters 会返回 4xx,应视为无参数。需处理分页、LRO 与 429 退避。
适用场景:数据流探索、参数与连接分析、刷新监控、查询结果预览。