Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-database-migration -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/azure-database-migration/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-database-migration/

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-firewall-manager Guides Azure Firewall Manager configuration, security policies, and architectural choices. Useful when setting up secured virtual hubs, DDoS plans, or WAF. CX Codex +1 180installs azure-traffic-manager Expert skill for Azure Traffic Manager: traffic routing, profile architecture, IaC with ARM/Bicep/Terraform. Covers endpoint configuration, routing methods, and troubleshooting degraded profiles. CX Codex +1 178installs azure-maps A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure Maps expertise into the agent context. Covers geocoding, routing, traffic, weather tiles, security patterns, and Web/REST SDK integration. CX Codex +1 178installs azure-aks-edge-essentials azure-aks-edge-essentials — a skill for Claude Code helps troubleshoot and configure AKS Edge Essentials and AKS Arc clusters on Windows Server. Resolves cluster recovery issues, network routing, and Arc onboarding. CX Codex +1 177installs azure-virtual-network-manager Get guidance on Azure Virtual Network Manager configuration, security, and troubleshooting. Use it for network groups, IPAM pools, UDRs, and security admin rules. CX Codex +1 176installs azure-blueprints Skill for Azure Blueprints work: migrate after service retirement, debug deployment errors, automate via CLI and PowerShell. CX Codex +1 176installs azure-firmware-analysis This Claude Code skill guides development tasks for Azure Firmware Analysis. It covers firmware findings, access controls, upload automation, and workspace deployment. CX Codex +1 175installs azure-resiliency Expert guidance for Azure resiliency: design zone-resilient topologies, run Zone Down drills, configure backup policies, and set up RBAC roles. CX Codex +1 174installs

More in the catalog

Project sponsors

Companies that keep this analytics open