$ loading_
帮助将 Azure Synapse Spark 工作负载迁移到 Microsoft Fabric 并完成代码替换。
复制安装指令，让 AI 自动完成配置 · 推荐新手
请帮我安装 askskill 上的 "synapse-migration" 技能： 1. 下载 https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/skills/synapse-migration/SKILL.md 2. 保存为 ~/.claude/skills/synapse-migration/SKILL.md 3. 装好后重载技能，告诉我可以用了
请将这个 Azure Synapse Spark 笔记本迁移到 Microsoft Fabric Lakehouse，保留原有逻辑，并把所有 mssparkutils 调用改成 notebookutils，同时处理 env 到 runtime 的命名空间变化。
输出适用于 Fabric 的笔记本代码，并列出已替换的 API 与迁移注意事项。
请检查这段 Synapse 代码中的 Linked Services 用法，并改写为 Microsoft Fabric 的 Data Connections 或 OneLake Shortcuts 配置方式，说明每处替换原因。
输出完成替换后的代码或配置建议，并逐项说明 Linked Services 到 Fabric 的映射关系。
我准备把 Synapse Spark 工作区迁移到 Fabric。请根据现有的 Spark Pools、Lake Databases、Notebooks 和 Spark Job Definitions，给出迁移方案、优先级和风险清单。
输出结构化迁移计划，包含组件映射、执行顺序、兼容性风险与验证建议。
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 workspace details (including its ID) from a workspace name: list all workspaces, then use JMESPath filtering
- To find item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace, then use JMESPath filtering
mssparkutilsandnotebookutilsshare the same API surface in most cases — the namespace is the primary change- Linked Services have no direct REST API equivalent in Fabric — they are replaced by Data Connections (for external sources) and OneLake Shortcuts (for storage mounts)
These companion documents provide general Fabric REST patterns. Do NOT read them upfront — reference only when a specific phase requires a pattern not already covered in this skill's resource files:
az rest / az login CLI patterns, authentication recipessqldw-authoring-cli skill)Auth, API endpoints, and item payloads are fully documented in this skill's own files. The common docs above are fallback references only.
| Topic | Reference |
|---|---|
| Migration Orchestrator | migration-orchestrator.md |
| API-Driven Migration Workflow | § API-Driven Migration Workflow |
| Migration Workload Map | § Migration Workload Map |
| Spark Pool → Environment Migration | spark-pool-migration.md |
| Lake Database → Lakehouse Migration | lake-database-migration.md |
| External Hive Metastore → Lakehouse Migration | external-hms-migration.md |
| Notebook & SJD Migration | spark-item-migration.md |
| Library Compatibility (Synapse vs. Fabric RT 1.3) | library-compatibility.md |
| Connector Refactoring (Kusto, Cosmos DB, ADLS OAuth) | connector-refactoring.md |
mssparkutils → notebookutils API Mapping | utility-api-mapping.md |
| Linked Services → Data Connections / Shortcuts | connectivity-migration.md |
| Before/After Code Patterns (incl. Catalog API gaps) | code-patterns.md |
| Migration Report (with Fabric portal links) | migration-report.md |
| Migration Troubleshooting Guide | migration-gotchas.md |
| Validation & Testing | validation-testing.md |
| Security & Governance (Production Readiness) | security-governance.md |
| T-SQL & Spark Configuration Differences | § T-SQL & Spark Configuration Differences |
…
帮助你开发 Microsoft Fabric Spark 与数据工程流程，编写调试 Notebook 代码并管理湖仓资源。