$ loading_
扫描并评估 Power BI Gen1 数据流升级为 Gen2.1 的就绪度，并通过 CLI 执行保存副本迁移。
复制安装指令，让 AI 自动完成配置 · 推荐新手
请帮我安装 askskill 上的 "dataflows-save-as-authoring-cli" 技能： 1. 下载 https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/plugins/fabric-authoring/skills/dataflows-save-as-authoring-cli/SKILL.md 2. 保存为 ~/.claude/skills/dataflows-save-as-authoring-cli/SKILL.md 3. 装好后重载技能，告诉我可以用了
请扫描指定 Power BI 工作区中的所有 Gen1 数据流，列出名称、ID、所属工作区，并标记哪些对象适合执行 Gen2.1 save-as 升级。
返回该工作区的 Gen1 数据流清单，并给出每个数据流的初步 save-as 可升级判断。
请对这个租户中的 Gen1 数据流执行 save-as readiness assessment，检查七类风险信号，包括增量刷新、BYOSA、Power Automate 触发器、管道依赖、链接实体、DirectQuery 和调用者非所有者，并输出 Markdown 和 JSON 快照。
输出包含风险信号、升级建议和优先级的 Save-As Readiness Snapshot 报告。
请使用 CLI 调用 SaveAsNativeArtifact API，将指定的 Gen1 数据流保存为 Gen2.1 副本，并在完成后验证数据完整性，同时检查是否仍存在残留的 Gen1 引用。
返回迁移执行结果、生成的新 Gen2.1 对象信息，以及迁移后验证与残留引用检查结论。
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 the item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace and, then, use JMESPath filtering
A save-as companion for creating upgraded Gen2.1 copies from Power BI Gen1 dataflows using readiness assessment and guarded execution.
We currently cannot perform an in-place migration of your dataflow. We can use save-as to create an upgraded Gen2.1 copy while preserving the original Gen1 dataflow.
| Task | Reference |
|---|
| Notes |
|---|
| Finding Workspaces and Items in Fabric | COMMON-CLI.md § Finding Workspaces and Items | Mandatory — READ link first |
| Fabric Topology & Key Concepts | COMMON-CORE.md § Fabric Topology | |
| Environment URLs | COMMON-CORE.md § Environment URLs | |
| Authentication & Token Acquisition | COMMON-CORE.md § Authentication | Wrong audience = 401 |
| Core Control-Plane REST APIs | COMMON-CORE.md § Core REST APIs | Pagination, LRO polling, rate limits |
| Tool Selection Rationale | COMMON-CLI.md § Tool Selection | |
| Authentication Recipes | COMMON-CLI.md § Auth Recipes | az login flows and token acquisition |
Fabric Control-Plane API via az rest | COMMON-CLI.md § az rest | Always pass --resource |
| Gotchas & Troubleshooting (CLI) | COMMON-CLI.md § Gotchas | az rest audience, shell escaping |
| Quick Reference | COMMON-CLI.md § Quick Ref | Token audience / tool matrix |
| Dataflow Definition Structure | DATAFLOWS-AUTHORING-CORE.md § Definition | 3-part format for Gen2 CI/CD |
| Consumption Capability Matrix | DATAFLOWS-CONSUMPTION-CORE.md § Capabilities | Read-only discovery patterns |
| Upgrade CLI Quick Reference | upgrade-cli-quickref.md | All az rest one-liners for scanning & save-as |
| Risk Assessment Guide | risk-assessment-guide.md | Risk signal detection logic & API calls |
| Tool | Role | Install |
|---|---|---|
az CLI | Primary: Auth (az login), REST API calls (az rest) against both Fabric and Power BI APIs. | Pre-installed in most dev environments |
jq | Parse and filter JSON responses (dataflow lists, risk signal extraction). | Pre-installed or trivial |
base64 | Decode dataflow definitions for inspection. | Built into bash / [Convert]::ToBase64String() in PowerShell |
Agent check — verify before first operation:
az --version 2>/dev/null || echo "INSTALL: https://aka.ms/install-azure-cli" jq --version 2>/dev/null || echo "INSTALL: apt-get install jq OR brew install jq"
…