mcpField
A
azure-database-migration

azure-database-migration

github.com/microsoftdocsData & databases796175 installsUpdated 3d ago
Repository

About azure-database-migration

A guidance skill for Azure Database Migration Service users. It combines local quick references with remote documentation on migration choices, constraints, security, automation, and troubleshooting.

Key features

  1. 01Migration and connectivity troubleshooting
  2. 02Migration tool and scenario selection
  3. 03Database migration constraints
  4. 04Migration security and RBAC guidance
  5. 05PowerShell automation for MySQL migration
  6. 06SSIS package migration guidance

Use cases

  1. 01Diagnose source database connection failures
  2. 02Compare Azure database migration approaches
  3. 03Check online migration constraints
  4. 04Automate MySQL database migration

MCP support

The skill recommends retrieving remote documentation through mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as a fallback.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-database-migration

After installing, type/azure-database-migrationin Claude Code to confirm it loaded.

Details

From the project README

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

CategoryLinesDescription
TroubleshootingL34-L41Diagnosing and fixing Azure DMS migration failures, MySQL-specific issues, classic DMS problems, and source database connectivity errors and timeouts.
Decision MakingL42-L47Guidance on choosing Azure migration tools and understanding which database migration scenarios Azure Database Migration Service supports and how to select the right approach.
Limits & QuotasL48-L55Migration-specific limits, unsupported features, and constraints when using Azure DMS to move MySQL, PostgreSQL, SQL Managed Instance, MongoDB, and hybrid deployments.
SecurityL56-L61Security guidance for Azure DMS migrations, including SQL best practices (network, auth, encryption) and configuring custom RBAC roles for MySQL migration scenarios.
Integrations & Coding PatternsL62-L66Automating MySQL-to-Azure Database for MySQL migrations using Azure Database Migration Service with PowerShell scripts, parameters, and end-to-end workflow examples.
DeploymentL67-L71Using Azure DMS to redeploy or migrate SSIS packages to Azure SQL Database or SQL Managed Instance, including configuration steps and migration considerations.
Troubleshooting
TopicURL
Resolve common Azure DMS migration issueshttps://learn.microsoft.com/en-us/azure/dms/faq
Resolve known issues migrating to Azure MySQLhttps://learn.microsoft.com/en-us/azure/dms/known-issues-azure-mysql-fs-online
Troubleshoot common Azure DMS classic migration issueshttps://learn.microsoft.com/en-us/azure/dms/known-issues-troubleshooting-dms
Fix Azure DMS source database connectivity problemshttps://learn.microsoft.com/en-us/azure/dms/known-issues-troubleshooting-dms-source-connectivity
Decision Making
TopicURL
Select tools for Azure database migrationhttps://learn.microsoft.com/en-us/azure/dms/dms-tools-matrix
Select supported Azure DMS migration scenarioshttps://learn.microsoft.com/en-us/azure/dms/resource-scenario-status
Limits & Quotas
TopicURL
Review online PostgreSQL to Azure Database for PostgreSQL migration limitationshttps://learn.microsoft.com/en-us/azure/dms/known-issues-azure-postgresql-online
Review online migration limits to Azure SQL Managed Instancehttps://learn.microsoft.com/en-us/azure/dms/known-issues-azure-sql-db-managed-instance-online
Understand Azure DMS hybrid mode limitations and issueshttps://learn.microsoft.com/en-us/azure/dms/known-issues-dms-hybrid-mode
Review MongoDB to Azure Cosmos DB migration limitations with DMShttps://learn.microsoft.com/en-us/azure/dms/known-issues-mongo-cosmos-db
Security
TopicURL
Apply security best practices for DMS SQL migrationshttps://learn.microsoft.com/en-us/azure/dms/dms-security-best-practices
Configure custom RBAC roles for MySQL migrations in DMShttps://learn.microsoft.com/en-us/azure/dms/resource-custom-roles-mysql-database-migration-service
Integrations & Coding Patterns
TopicURL
Automate MySQL to Azure MySQL migration with DMS PowerShellhttps://learn.microsoft.com/en-us/azure/dms/migrate-mysql-to-azure-mysql-powershell
Deployment
TopicURL
Redeploy SSIS packages to Azure SQL Database with DMShttps://learn.microsoft.com/en-us/azure/dms/how-to-migrate-ssis-packages
Migrate SSIS packages to Azure SQL Managed Instance with DMShttps://learn.microsoft.com/en-us/azure/dms/how-to-migrate-ssis-packages-managed-instance

Comments

Markdown supported