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-L40	Diagnosing and fixing common Azure DMS and DMS classic migration failures, including connectivity to source databases, configuration issues, and typical error messages.
Decision Making	L41-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
Resolve common Azure Database Migration Service issues	https://learn.microsoft.com/en-us/azure/dms/faq
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
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

Files1

1 files · 18.2 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Safety

82

Quality

68

Clarity

78

Completeness

62

Summary

This skill provides expert guidance for Azure Database Migration Service (DMS), covering troubleshooting, decision making, limits, security, integrations, and deployment. It functions as a reference skill that directs agents to remote Microsoft Learn documentation via network calls, with a structured category index to locate relevant content.

Detected Capabilities

network accessdocumentation fetch via mcp_microsoftdocswebpage fetch as fallbackread_file operationsreference to external URLs

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure database migrationdms migration planningssis to azuremysql azure migrationazure dms troubleshootingsql server migration azure

Risk Signals

INFO

Network access to external domains (learn.microsoft.com, github.com)

compatibility field, all category URLs

INFO

Dependency on mcp_microsoftdocs MCP tool availability

compatibility field, 'How to Use' section

WARNING

Documentation links may become outdated (metadata.generated_at freshness check)

IMPORTANT note for Agent, line ~5

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

Plan SQL Server migration to Azure SQL Database or Managed Instance using Azure DMS
Migrate MySQL databases to Azure Database for MySQL with PowerShell automation
Troubleshoot Azure DMS connectivity and configuration issues
Choose appropriate database migration tools and scenarios from the DMS matrix
Migrate SSIS packages from on-premises SQL Server to Azure SQL Database or Managed Instance
Understand migration limitations and quotas for PostgreSQL, MySQL, and MongoDB migrations
Configure security best practices and custom RBAC roles for DMS migrations

Quality Notes

Skill provides clear category index with URL references for structured navigation
Well-defined scope: explicitly excludes related services (Azure Migrate, Azure SQL Database, SQL Managed Instance, SQL Server on VMs)
References external documentation via learn.microsoft.com; does not provide detailed how-to content inline
Metadata includes freshness check and fallback MCP tool suggestions for robustness
Category index references line ranges (L34-L71) but content is not provided in the skill file itself — appears to be a reference template rather than complete skill
Limitations: skill relies entirely on network access and external documentation availability; limited offline utility
No error handling instructions provided for network failure scenarios or deprecated documentation links

Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

azure-database-migration