azure-sql-managed-instance
About azure-sql-managed-instance
A documentation skill for Azure SQL Managed Instance users, giving agents guidance on troubleshooting, architecture, configuration, and migration. It combines local quick references with network access to Microsoft documentation.
Key features
- 01Troubleshooting and performance diagnostics
- 02High availability and disaster recovery guidance
- 03Service tier and migration decision references
- 04Security, networking, and instance configuration
- 05Network retrieval of Microsoft documentation
Use cases
- 01Investigate connectivity, performance, or backup issues
- 02Plan high availability and disaster recovery
- 03Evaluate service tiers and migration options
- 04Configure authentication, networking, and instances
MCP support
The skill can use the mcp_microsoftdocs Microsoft documentation fetch tool, with fetch_webpage as a fallback. Retrieved documentation is used as reference material for agents.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-sql-managed-instanceAfter installing, type/azure-sql-managed-instancein Claude Code to confirm it loaded.
Details
From the project READMEAzure SQL Managed Instance Skill
This skill provides expert guidance for Azure SQL Managed Instance. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L59 | Diagnosing and fixing Azure SQL Managed Instance issues: deployment/scale errors, connectivity, performance, backups, memory/log capacity, geo-replication, XTP storage, auth, and common known problems. |
| Best Practices | L60-L81 | Performance, HA/DR, and security best practices for Azure SQL Managed Instance, including monitoring, query tuning, maintenance, failover/geo-replication, migration, and app performance optimization. |
| Decision Making | L82-L98 | Guidance for choosing Azure SQL services and tiers, planning subnet/IPs, and deciding or executing migrations (SQL Server, Db2, Oracle) and replication options (link, LRS, standby). |
| Architecture & Design Patterns | L99-L103 | Connectivity architecture for Azure SQL DB and HA design for Managed Instance, including network topology, routing, failover behavior, and resilience patterns. |
| Limits & Quotas | L104-L115 | Backup retention/immutability rules, DTU benchmarks, free-tier and memory limits, maintenance windows, operation durations, and all key resource/scale limits for Azure SQL Managed Instance. |
| Security | L116-L167 | Configuring Azure SQL Managed Instance security: Entra auth (users, logins, Windows/Kerberos), managed identities, TDE & customer-managed keys, TLS, auditing, networking, and Azure Policy. |
| Configuration | L168-L217 | Configuring and managing Azure SQL Managed Instance: deployment, networking, backups/restore, monitoring, maintenance windows, update policy, time zone/tempdb, and high availability/failover. |
| Integrations & Coding Patterns | L218-L241 | Client connectivity, coding patterns, and tools for apps using Azure SQL Managed Instance, plus automation, DTC, XEvents, Spark, Managed Instance link, and backup/restore scenarios. |
| Deployment | L242-L257 | Deploying and managing Azure SQL Managed Instance and databases: scaling, start/stop for cost control, DR/replication, region/subnet moves, and required virtual network setup. |
Troubleshooting
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Understand connectivity architecture for Azure SQL Database | https://learn.microsoft.com/en-us/azure/azure-sql/database/connectivity-architecture?view=azuresql |