azure-database-migration — Claude Code skill: migration and setup
This skill guides Azure Database Migration Service planning and troubleshooting. Use it to compare migration scenarios, check constraints, or investigate connection failures.
CC-BY-4.0 177 installs ★ 818 updated 2026-10-25
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a claude-codeWhat azure-database-migration does
The skill brings together guidance for Azure Database Migration Service migrations. It helps select a supported approach and investigate connection timeouts or migration failures. Its coverage includes MySQL, PostgreSQL, MongoDB, hybrid workloads, and moving SSIS packages to Azure SQL.
A topic index points the agent to local references, while Microsoft Docs content is fetched through mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. Network access is required for remote documentation. Without it, those references cannot be retrieved. The skill also covers migration security and includes PowerShell guidance for automating MySQL transfers.
What it helps with
- choose an Azure DMS tool and migration scenario
- diagnose a source connectivity failure or timeout
- check migration constraints for PostgreSQL, MongoDB, or SQL Managed Instance
- plan a MySQL migration workflow with PowerShell
- find guidance for moving SSIS packages to Azure SQL
Example prompts for the agent
- Help me choose a supported Azure Database Migration Service scenario for this database move.
- Investigate why the source connection times out during an Azure DMS migration.
- Find the steps for moving SSIS packages to Azure SQL with Azure DMS.
How to install azure-database-migration
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a claude-code2Manually: put the files in place
~/.claude/skills/azure-database-migration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-database-migration/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a codex2Manually: put the files in place
.agents/skills/azure-database-migration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a cursor2Manually: put the files in place
.cursor/skills/azure-database-migration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-database-migration2Manually: put the files in place
.github/skills/azure-database-migration/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-database-migrationManually: put the files in place
.devin/skills/azure-database-migration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-database-migration
How do I install azure-database-migration in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a claude-code. The skill file is at ~/.claude/skills/azure-database-migration/SKILL.md.
What does azure-database-migration do?
It helps plan Azure Database Migration Service work, select migration scenarios, and troubleshoot failures, constraints, and security concerns. It also includes guidance on MySQL automation and SSIS package transfers.
Does azure-database-migration need network access?
Yes. It retrieves Microsoft Docs material using mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage, so remote documentation requires network access.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-database-migration description: Expert knowledge for Azure Database Migration Service development including troubleshooting, decision making, limits & quotas, security, integrations & coding patterns, and deployment. Use when planning Azure DMS migrations for MySQL, PostgreSQL, MongoDB, SSIS-to-Azure SQL, or hybrid workloads, and other Azure Database Migration Service related development tasks. Not for Azure Migrate (use azure-migrate), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-08-31" generator: "docs2skills/1.0.0" --- # Azure Database Migration Service Skill This skill provides expert guidance for Azure Database Migration Service. Covers troubleshooting, decision making, limits & quotas, security, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities. ## How to Use This Skill > **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown. ## Category Index | Category | Lines | Description | |----------|-------|-------------| | Troubleshooting | L34-L41 | Diagnosing and fixing Azure DMS migration failures, MySQL-specific issues, classic DMS problems, and source database connectivity errors and timeouts. | | Decision Making | L42-L47 | Guidance on choosing Azure migration tools and understanding which database migration scenarios Azure Database Migration Service supports and how to select the right approach. | | Limits & Quotas | L48-L55 | Migration-specific limits, unsupported features, and constraints when using Azure DMS to move MySQL, PostgreSQL, SQL Managed Instance, MongoDB, and hybrid deployments. | | Security | L56-L61 | Security guidance for Azure DMS migrations, including SQL best practices (network, auth, encryption) and configuring custom RBAC roles for MySQL migration scenarios. | | Integrations & Coding Patterns | L62-L66 | Automating MySQL-to-Azure Database for MySQL migrations using Azure Database Migration Service with PowerShell scripts, parameters, and end-to-end workflow examples. | | Deployment | L67-L71 | Using Azure DMS to redeploy or migrate SSIS packages to Azure SQL Database or SQL Managed Instance, including configuration steps and migration considerations. | ### Troubleshooting | Topic | URL | |-------|-----| | Resolve common Azure DMS migration issues | https://learn.microsoft.com/en-us/azure/dms/faq | | Resolve known issues migrating to Azure MySQL | https://learn.microsoft.com/en-us/azure/dms/known-issues-azure-mysql-fs-online | | Troubleshoot common Azure DMS classic migration issues | https://learn.microsoft.com/en-us/azure/dms/known-issues-troubleshooting-dms | | Fix Azure DMS source database connectivity problems | https://learn.microsoft.com/en-us/azure/dms/known-issues-troubleshooting-dms-source-connectivity | ### Decision Making | Topic | URL | |-------|-----| | Select tools for Azure database migration | https://learn.microsoft.com/en-us/azure/dms/dms-tools-matrix | | Select supported Azure DMS migration scenarios | https://learn.microsoft.com/en-us/azure/dms/resource-scenario-status | ### Limits & Quotas | Topic | URL | |-------|-----| | Review online PostgreSQL to Azure Database for PostgreSQL migration limitations | https://learn.microsoft.com/en-us/azure/dms/known-issues-azure-postgresql-online | | Review online migration limits to Azure SQL Managed Instance | https://learn.microsoft.com/en-us/azure/dms/known-issues-azure-sql-db-managed-instance-online | | Understand Azure DMS hybrid mode limitations and issues | https://learn.microsoft.com/en-us/azure/dms/known-issues-dms-hybrid-mode | | Review MongoDB to Azure Cosmos DB migration limitations with DMS | https://learn.microsoft.com/en-us/azure/dms/known-issues-mongo-cosmos-db | ### Security | Topic | URL | |-------|-----| | Apply security best practices for DMS SQL migrations | https://learn.microsoft.com/en-us/azure/dms/dms-security-best-practices | | Configure custom RBAC roles for MySQL migrations in DMS | https://learn.microsoft.com/en-us/azure/dms/resource-custom-roles-mysql-database-migration-service | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Automate MySQL to Azure MySQL migration with DMS PowerShell | https://learn.microsoft.com/en-us/azure/dms/migrate-mysql-to-azure-mysql-powershell | ### Deployment | Topic | URL | |-------|-----| | Redeploy SSIS packages to Azure SQL Database with DMS | https://learn.microsoft.com/en-us/azure/dms/how-to-migrate-ssis-packages | | Migrate SSIS packages to Azure SQL Managed Instance with DMS | https://learn.microsoft.com/en-us/azure/dms/how-to-migrate-ssis-packages-managed-instance |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills