$ loading_
通过只读命令行监控、解析并查询 Fabric Dataflows Gen2 数据流。
复制安装指令，让 AI 自动完成配置 · 推荐新手
请帮我安装 askskill 上的 "dataflows-consumption-cli" 技能： 1. 下载 https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/skills/dataflows-consumption-cli/SKILL.md 2. 保存为 ~/.claude/skills/dataflows-consumption-cli/SKILL.md 3. 装好后重载技能，告诉我可以用了
请列出工作区中的 Fabric Dataflows Gen2 数据流，并解析指定数据流的定义文件，输出 mashup.pq、queryMetadata.json、.platform 内容摘要，以及可用参数清单。
返回数据流列表、定义文件解码结果摘要，以及参数名称、类型和用途说明。
查询这个数据流的最新刷新状态、最近 10 次刷新历史和相关作业历史，并标记失败时间、持续时长和错误信息。
输出最新刷新结果、历史记录表，以及失败任务的关键诊断信息。
对指定数据流执行读取查询：先按 QueryName 运行已保存查询并解析 Arrow IPC 结果，再用一个只读 customMashupDocument 执行临时查询，返回前 20 行数据。
返回解析后的查询结果数据表，并说明查询来源、字段结构和行数。
Update Check — ONCE PER SESSION (mandatory) The first time this skill is used in a session, run the check-updates skill before proceeding.
- GitHub Copilot CLI / VS Code: invoke the
check-updatesskill.- Claude Code / Cowork / Cursor / Windsurf / Codex: compare local vs remote package.json version.
- Skip if the check was already performed earlier in this session.
CRITICAL NOTES
- To find the workspace details (including its ID) from workspace name: list all workspaces and, then, use JMESPath filtering
- To find a dataflow by name: list all dataflows in the workspace and filter by
displayNameclient-side — there is no server-side name filtergetDefinitionis a POST, not GET — even though it reads data
| Task | Reference | Notes |
|---|
| Finding Workspaces and Items in Fabric | COMMON-CLI.md § Finding Workspaces and Items in Fabric | Mandatory — READ link first |
| Fabric Topology & Key Concepts | COMMON-CORE.md § Fabric Topology & Key Concepts | |
| Environment URLs | COMMON-CORE.md § Environment URLs | |
| Authentication & Token Acquisition | COMMON-CORE.md § Authentication & Token Acquisition | Wrong audience = 401; read before any auth issue |
| Core Control-Plane REST APIs | COMMON-CORE.md § Core Control-Plane REST APIs | Includes pagination, LRO polling, and rate-limiting patterns |
| Job Execution | COMMON-CORE.md § Job Execution | |
| Gotchas, Best Practices & Troubleshooting | COMMON-CORE.md § Gotchas, Best Practices & Troubleshooting | |
| Tool Selection Rationale | COMMON-CLI.md § Tool Selection Rationale | |
| Authentication Recipes | COMMON-CLI.md § Authentication Recipes | az login flows and token acquisition |
Fabric Control-Plane API via az rest | COMMON-CLI.md § Fabric Control-Plane API via az rest | Always pass --resource; includes pagination and LRO helpers |
| Job Execution (CLI) | COMMON-CLI.md § Job Execution | |
| Gotchas & Troubleshooting (CLI-Specific) | COMMON-CLI.md § Gotchas & Troubleshooting (CLI-Specific) | az rest audience, shell escaping, token expiry |
| Quick Reference | COMMON-CLI.md § Quick Reference | az rest template + token audience/tool matrix |
| Consumption Capability Matrix | DATAFLOWS-CONSUMPTION-CORE.md § Consumption Capability Matrix | Read first — shows what ops are available |
| REST API Surface (Consumption) | DATAFLOWS-CONSUMPTION-CORE.md § REST API Surface | List, Get, Parameters, getDefinition, Jobs |
| Dataflow Definition Exploration | DATAFLOWS-CONSUMPTION-CORE.md § Dataflow Definition Exploration | Decode mashup.pq, queryMetadata.json, .platform |
| Parameter Discovery and Analysis | DATAFLOWS-CONSUMPTION-CORE.md § Parameter Discovery and Analysis | Types, formats, M code patterns |
…