Agent skill

azure-database-migration

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, SQL Server/SSIS, SQL MI, or MongoDB 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).

View SKILL.md on GitHub Repository
Stars 485
Forks 45

Install this agent skill to your Project

npx add-skill https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-database-migration

Metadata

Additional technical details for this skill

generator
docs2skills/1.0.0
generated at
2026-02-28

SKILL.md

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

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-L39 Diagnosing and resolving Azure DMS classic migration failures and source DB connectivity issues (network, auth, firewall, TLS) during database migrations.
Decision Making L40-L46 Choosing the right Azure DMS tool and scenario for your source/target databases, plus FAQs on supported migrations, limitations, and how to use Azure Database Migration Service.
Limits & Quotas L47-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
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
Choose database migration tools with the Azure DMS matrix https://learn.microsoft.com/en-us/azure/dms/dms-tools-matrix
Answer common Azure Database Migration Service usage questions https://learn.microsoft.com/en-us/azure/dms/faq
Select supported Azure DMS migration scenarios https://learn.microsoft.com/en-us/azure/dms/resource-scenario-status

Limits & Quotas

Topic URL
Review migration limitations to Azure Database for MySQL https://learn.microsoft.com/en-us/azure/dms/known-issues-azure-mysql-fs-online
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

MicrosoftDocs/Agent-Skills

azure-blueprints

Expert knowledge for Azure Blueprints development including troubleshooting, architecture & design patterns, security, configuration, and integrations & coding patterns. Use when defining Azure Blueprints, mapping built-in compliance sets, automating via CLI/PowerShell/REST, or fixing assignment errors, and other Azure Blueprints related development tasks. Not for Azure Policy (use azure-policy), Azure Resource Manager (use azure-resource-manager), Azure Managed Applications (use azure-managed-applications), Azure Deployment Environments (use azure-deployment-environments).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-hdinsight

Expert knowledge for Azure HDInsight development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when working with HDInsight Spark/Hive/Kafka/HBase clusters, Ambari, VNet networking, or Azure SQL/Cosmos DB integration, and other Azure HDInsight related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure Databricks (use azure-databricks), Azure Stream Analytics (use azure-stream-analytics).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-advisor

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts, workbooks, RBAC access, bulk fixes, or Resource Graph/Kusto queries, and other Azure Advisor related development tasks. Not for Azure Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Service Health (use azure-service-health).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-cognitive-search

Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing indexes/skillsets, vector/semantic search, indexers, RAG knowledge bases, or secure data access, and other Azure AI Search related development tasks. Not for Azure Cosmos DB (use azure-cosmos-db), Azure Data Explorer (use azure-data-explorer), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-migrate

Expert knowledge for Azure Migrate development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using AppCAT/CAST, Site Recovery REST APIs, Azure Migrate appliance, Arc-based discovery, or Resource Mover, and other Azure Migrate related development tasks. Not for Azure Database Migration service (use azure-database-migration), Azure Site Recovery (use azure-site-recovery), Azure Virtual Machines (use azure-virtual-machines), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-maps

Expert knowledge for Azure Maps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Azure Maps web SDK, search/geocoding, routing/traffic, weather APIs, or migrating from Bing/Google Maps, and other Azure Maps related development tasks.

485 45
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results