[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69ANYPDQDJGZ7AKW77AG4VT":3,"skill-same:01M69ANYPDQDJGZ7AKW77AG4VT":100},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":31,"publishedAt":53,"linkOnly":54,"markdownContent":55,"markdownBody":56,"frontMatter":57,"refName":62,"commitSha":63,"skillDirectory":64,"forksCount":65,"repositoryHtmlUrl":66,"repositoryHomepageUrl":67,"ownerHtmlUrl":68,"ownerBlogUrl":69,"ownerDescription":70,"updatedAt":71,"install":72,"resources":85},"01M69ANYPDQDJGZ7AKW77AG4VT","azure-resource-manager-sql-dotnet",null,"Azure Resource Manager SDK for Azure SQL in .NET. Use for MANAGEMENT PLANE operations: creating\u002Fmanaging SQL servers, databases, elastic pools, firewall rules, and failover groups via Azure Resource Manager. NOT for data plane operations (executing queries) - use Microsoft.Data.SqlClient for that. Triggers: \"SQL server\", \"create SQL database\", \"manage SQL resources\", \"ARM SQL\", \"SqlServerResource\", \"provision Azure SQL\", \"elastic pool\", \"firewall rule\".","microsoft\u002Fskills","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69AJYYW4E1RMSYCQDJ4FJSH",3202,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-resource-manager-sql-dotnet\u002FSKILL.md",[18,23,26],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",[32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,9],"dotnet","sql","manager","azure","azure resource manager sql dotnet","azure resource manager","data","sql database","for","plane","resources","manage","databases","firewall","elastic","sdk","server","database","create","sql server","azure sql","2026-11-10 10:12:30",false,"---\nname: azure-resource-manager-sql-dotnet\ndescription: |\n  Azure Resource Manager SDK for Azure SQL in .NET. Use for MANAGEMENT PLANE operations: creating\u002Fmanaging SQL servers, databases, elastic pools, firewall rules, and failover groups via Azure Resource Manager. NOT for data plane operations (executing queries) - use Microsoft.Data.SqlClient for that. Triggers: \"SQL server\", \"create SQL database\", \"manage SQL resources\", \"ARM SQL\", \"SqlServerResource\", \"provision Azure SQL\", \"elastic pool\", \"firewall rule\".\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"1.0.0\"\n  package: Azure.ResourceManager.Sql\n---\n\n# Azure.ResourceManager.Sql (.NET)\n\nManagement plane SDK for provisioning and managing Azure SQL resources via Azure Resource Manager.\n\n> **⚠️ Management vs Data Plane**\n> - **This SDK (Azure.ResourceManager.Sql)**: Create servers, databases, elastic pools, configure firewall rules, manage failover groups\n> - **Data Plane SDK (Microsoft.Data.SqlClient)**: Execute queries, stored procedures, manage connections\n\n## Installation\n\n```bash\ndotnet add package Azure.ResourceManager.Sql\ndotnet add package Azure.Identity\n```\n\n**Current Versions**: Stable v1.3.0, Preview v1.4.0-beta.3\n\n## Environment Variables\n\n```bash\nAZURE_SUBSCRIPTION_ID=\u003Cyour-subscription-id>  # Required: Azure subscription ID\nAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production\nAZURE_TENANT_ID=\u003Ctenant-id>  # For service principal auth (optional)\nAZURE_CLIENT_ID=\u003Cclient-id>  # For service principal auth (optional)\nAZURE_CLIENT_SECRET=\u003Cclient-secret>  # For service principal auth (optional)\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.Sql;\n\n\u002F\u002F Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\nvar credential = new DefaultAzureCredential(\n    DefaultAzureCredential.DefaultEnvironmentVariableName\n);\n\u002F\u002F Or use a specific credential directly in production:\n\u002F\u002F See https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-dotnet#credential-classes\n\u002F\u002F var credential = new ManagedIdentityCredential();\nvar armClient = new ArmClient(credential);\n\n\u002F\u002F Get subscription\nvar subscriptionId = Environment.GetEnvironmentVariable(\"AZURE_SUBSCRIPTION_ID\");\nvar subscription = armClient.GetSubscriptionResource(\n    new ResourceIdentifier($\"\u002Fsubscriptions\u002F{subscriptionId}\"));\n```\n\n## Resource Hierarchy\n\n```\nArmClient\n└── SubscriptionResource\n    └── ResourceGroupResource\n        └── SqlServerResource\n            ├── SqlDatabaseResource\n            ├── ElasticPoolResource\n            │   └── ElasticPoolDatabaseResource\n            ├── SqlFirewallRuleResource\n            ├── FailoverGroupResource\n            ├── ServerBlobAuditingPolicyResource\n            ├── EncryptionProtectorResource\n            └── VirtualNetworkRuleResource\n```\n\n## Core Workflow\n\n### 1. Create SQL Server\n\n```csharp\nusing Azure.ResourceManager.Sql;\nusing Azure.ResourceManager.Sql.Models;\n\n\u002F\u002F Get resource group\nvar resourceGroup = await subscription\n    .GetResourceGroupAsync(\"my-resource-group\");\n\n\u002F\u002F Define server\nvar serverData = new SqlServerData(AzureLocation.EastUS)\n{\n    AdministratorLogin = \"sqladmin\",\n    AdministratorLoginPassword = \"YourSecurePassword123!\",\n    Version = \"12.0\",\n    MinimalTlsVersion = SqlMinimalTlsVersion.Tls1_2,\n    PublicNetworkAccess = ServerNetworkAccessFlag.Enabled\n};\n\n\u002F\u002F Create server (long-running operation)\nvar serverCollection = resourceGroup.Value.GetSqlServers();\nvar operation = await serverCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-sql-server\",\n    serverData);\n\nSqlServerResource server = operation.Value;\n```\n\n### 2. Create SQL Database\n\n```csharp\nvar databaseData = new SqlDatabaseData(AzureLocation.EastUS)\n{\n    Sku = new SqlSku(\"S0\") { Tier = \"Standard\" },\n    MaxSizeBytes = 2L * 1024 * 1024 * 1024, \u002F\u002F 2 GB\n    Collation = \"SQL_Latin1_General_CP1_CI_AS\",\n    RequestedBackupStorageRedundancy = SqlBackupStorageRedundancy.Local\n};\n\nvar databaseCollection = server.GetSqlDatabases();\nvar dbOperation = await databaseCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-database\",\n    databaseData);\n\nSqlDatabaseResource database = dbOperation.Value;\n```\n\n### 3. Create Elastic Pool\n\n```csharp\nvar poolData = new ElasticPoolData(AzureLocation.EastUS)\n{\n    Sku = new SqlSku(\"StandardPool\")\n    {\n        Tier = \"Standard\",\n        Capacity = 100 \u002F\u002F 100 eDTUs\n    },\n    PerDatabaseSettings = new ElasticPoolPerDatabaseSettings\n    {\n        MinCapacity = 0,\n        MaxCapacity = 100\n    }\n};\n\nvar poolCollection = server.GetElasticPools();\nvar poolOperation = await poolCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-elastic-pool\",\n    poolData);\n\nElasticPoolResource pool = poolOperation.Value;\n```\n\n### 4. Add Database to Elastic Pool\n\n```csharp\nvar databaseData = new SqlDatabaseData(AzureLocation.EastUS)\n{\n    ElasticPoolId = pool.Id\n};\n\nawait databaseCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"pooled-database\",\n    databaseData);\n```\n\n### 5. Configure Firewall Rules\n\n```csharp\n\u002F\u002F Allow Azure services\nvar azureServicesRule = new SqlFirewallRuleData\n{\n    StartIPAddress = \"0.0.0.0\",\n    EndIPAddress = \"0.0.0.0\"\n};\n\nvar firewallCollection = server.GetSqlFirewallRules();\nawait firewallCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"AllowAzureServices\",\n    azureServicesRule);\n\n\u002F\u002F Allow specific IP range\nvar clientRule = new SqlFirewallRuleData\n{\n    StartIPAddress = \"203.0.113.0\",\n    EndIPAddress = \"203.0.113.255\"\n};\n\nawait firewallCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"AllowClientIPs\",\n    clientRule);\n```\n\n### 6. List Resources\n\n```csharp\n\u002F\u002F List all servers in subscription\nawait foreach (var srv in subscription.GetSqlServersAsync())\n{\n    Console.WriteLine($\"Server: {srv.Data.Name} in {srv.Data.Location}\");\n}\n\n\u002F\u002F List databases in a server\nawait foreach (var db in server.GetSqlDatabases())\n{\n    Console.WriteLine($\"Database: {db.Data.Name}, SKU: {db.Data.Sku?.Name}\");\n}\n\n\u002F\u002F List elastic pools\nawait foreach (var ep in server.GetElasticPools())\n{\n    Console.WriteLine($\"Pool: {ep.Data.Name}, DTU: {ep.Data.Sku?.Capacity}\");\n}\n```\n\n### 7. Get Connection String\n\n```csharp\n\u002F\u002F Build connection string (server FQDN is predictable)\nvar serverFqdn = $\"{server.Data.Name}.database.windows.net\";\nvar connectionString = $\"Server=tcp:{serverFqdn},1433;\" +\n    $\"Initial Catalog={database.Data.Name};\" +\n    \"Persist Security Info=False;\" +\n    $\"User ID={server.Data.AdministratorLogin};\" +\n    \"Password=\u003Cyour-password>;\" +\n    \"MultipleActiveResultSets=False;\" +\n    \"Encrypt=True;\" +\n    \"TrustServerCertificate=False;\" +\n    \"Connection Timeout=30;\";\n```\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `ArmClient` | Entry point for all ARM operations |\n| `SqlServerResource` | Represents an Azure SQL server |\n| `SqlServerCollection` | Collection for server CRUD |\n| `SqlDatabaseResource` | Represents a SQL database |\n| `SqlDatabaseCollection` | Collection for database CRUD |\n| `ElasticPoolResource` | Represents an elastic pool |\n| `ElasticPoolCollection` | Collection for elastic pool CRUD |\n| `SqlFirewallRuleResource` | Represents a firewall rule |\n| `SqlFirewallRuleCollection` | Collection for firewall rule CRUD |\n| `SqlServerData` | Server creation\u002Fupdate payload |\n| `SqlDatabaseData` | Database creation\u002Fupdate payload |\n| `ElasticPoolData` | Elastic pool creation\u002Fupdate payload |\n| `SqlFirewallRuleData` | Firewall rule creation\u002Fupdate payload |\n| `SqlSku` | SKU configuration (tier, capacity) |\n\n## Common SKUs\n\n### Database SKUs\n\n| SKU Name | Tier | Description |\n|----------|------|-------------|\n| `Basic` | Basic | 5 DTUs, 2 GB max |\n| `S0`-`S12` | Standard | 10-3000 DTUs |\n| `P1`-`P15` | Premium | 125-4000 DTUs |\n| `GP_Gen5_2` | GeneralPurpose | vCore-based, 2 vCores |\n| `BC_Gen5_2` | BusinessCritical | vCore-based, 2 vCores |\n| `HS_Gen5_2` | Hyperscale | vCore-based, 2 vCores |\n\n### Elastic Pool SKUs\n\n| SKU Name | Tier | Description |\n|----------|------|-------------|\n| `BasicPool` | Basic | 50-1600 eDTUs |\n| `StandardPool` | Standard | 50-3000 eDTUs |\n| `PremiumPool` | Premium | 125-4000 eDTUs |\n| `GP_Gen5_2` | GeneralPurpose | vCore-based |\n| `BC_Gen5_2` | BusinessCritical | vCore-based |\n\n## Best Practices\n\n1. **Use `WaitUntil.Completed`** for operations that must finish before proceeding\n2. **Use `WaitUntil.Started`** when you want to poll manually or run operations in parallel\n3. **Always use `DefaultAzureCredential`** — never hardcode passwords in production\n4. **Handle `RequestFailedException`** for ARM API errors\n5. **Use `CreateOrUpdateAsync`** for idempotent operations\n6. **Navigate hierarchy** via `Get*` methods (e.g., `server.GetSqlDatabases()`)\n7. **Use elastic pools** for cost optimization when managing multiple databases\n8. **Configure firewall rules** before attempting connections\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    var operation = await serverCollection.CreateOrUpdateAsync(\n        WaitUntil.Completed, serverName, serverData);\n}\ncatch (RequestFailedException ex) when (ex.Status == 409)\n{\n    Console.WriteLine(\"Server already exists\");\n}\ncatch (RequestFailedException ex) when (ex.Status == 400)\n{\n    Console.WriteLine($\"Invalid request: {ex.Message}\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"ARM Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}\");\n}\n```\n\n## Reference Files\n\n| File | When to Read |\n|------|--------------|\n| [references\u002Fserver-management.md](references\u002Fserver-management.md) | Server CRUD, admin credentials, Azure AD auth, networking |\n| [references\u002Fdatabase-operations.md](references\u002Fdatabase-operations.md) | Database CRUD, scaling, backup, restore, copy |\n| [references\u002Felastic-pools.md](references\u002Felastic-pools.md) | Pool management, adding\u002Fremoving databases, scaling |\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Microsoft.Data.SqlClient` | Data plane (execute queries, stored procedures) | `dotnet add package Microsoft.Data.SqlClient` |\n| `Azure.ResourceManager.Sql` | Management plane (this SDK) | `dotnet add package Azure.ResourceManager.Sql` |\n| `Microsoft.EntityFrameworkCore.SqlServer` | ORM for SQL Server | `dotnet add package Microsoft.EntityFrameworkCore.SqlServer` |\n","# Azure.ResourceManager.Sql (.NET)\n\nManagement plane SDK for provisioning and managing Azure SQL resources via Azure Resource Manager.\n\n> **⚠️ Management vs Data Plane**\n> - **This SDK (Azure.ResourceManager.Sql)**: Create servers, databases, elastic pools, configure firewall rules, manage failover groups\n> - **Data Plane SDK (Microsoft.Data.SqlClient)**: Execute queries, stored procedures, manage connections\n\n## Installation\n\n```bash\ndotnet add package Azure.ResourceManager.Sql\ndotnet add package Azure.Identity\n```\n\n**Current Versions**: Stable v1.3.0, Preview v1.4.0-beta.3\n\n## Environment Variables\n\n```bash\nAZURE_SUBSCRIPTION_ID=\u003Cyour-subscription-id>  # Required: Azure subscription ID\nAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production\nAZURE_TENANT_ID=\u003Ctenant-id>  # For service principal auth (optional)\nAZURE_CLIENT_ID=\u003Cclient-id>  # For service principal auth (optional)\nAZURE_CLIENT_SECRET=\u003Cclient-secret>  # For service principal auth (optional)\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.Sql;\n\n\u002F\u002F Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\nvar credential = new DefaultAzureCredential(\n    DefaultAzureCredential.DefaultEnvironmentVariableName\n);\n\u002F\u002F Or use a specific credential directly in production:\n\u002F\u002F See https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-dotnet#credential-classes\n\u002F\u002F var credential = new ManagedIdentityCredential();\nvar armClient = new ArmClient(credential);\n\n\u002F\u002F Get subscription\nvar subscriptionId = Environment.GetEnvironmentVariable(\"AZURE_SUBSCRIPTION_ID\");\nvar subscription = armClient.GetSubscriptionResource(\n    new ResourceIdentifier($\"\u002Fsubscriptions\u002F{subscriptionId}\"));\n```\n\n## Resource Hierarchy\n\n```\nArmClient\n└── SubscriptionResource\n    └── ResourceGroupResource\n        └── SqlServerResource\n            ├── SqlDatabaseResource\n            ├── ElasticPoolResource\n            │   └── ElasticPoolDatabaseResource\n            ├── SqlFirewallRuleResource\n            ├── FailoverGroupResource\n            ├── ServerBlobAuditingPolicyResource\n            ├── EncryptionProtectorResource\n            └── VirtualNetworkRuleResource\n```\n\n## Core Workflow\n\n### 1. Create SQL Server\n\n```csharp\nusing Azure.ResourceManager.Sql;\nusing Azure.ResourceManager.Sql.Models;\n\n\u002F\u002F Get resource group\nvar resourceGroup = await subscription\n    .GetResourceGroupAsync(\"my-resource-group\");\n\n\u002F\u002F Define server\nvar serverData = new SqlServerData(AzureLocation.EastUS)\n{\n    AdministratorLogin = \"sqladmin\",\n    AdministratorLoginPassword = \"YourSecurePassword123!\",\n    Version = \"12.0\",\n    MinimalTlsVersion = SqlMinimalTlsVersion.Tls1_2,\n    PublicNetworkAccess = ServerNetworkAccessFlag.Enabled\n};\n\n\u002F\u002F Create server (long-running operation)\nvar serverCollection = resourceGroup.Value.GetSqlServers();\nvar operation = await serverCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-sql-server\",\n    serverData);\n\nSqlServerResource server = operation.Value;\n```\n\n### 2. Create SQL Database\n\n```csharp\nvar databaseData = new SqlDatabaseData(AzureLocation.EastUS)\n{\n    Sku = new SqlSku(\"S0\") { Tier = \"Standard\" },\n    MaxSizeBytes = 2L * 1024 * 1024 * 1024, \u002F\u002F 2 GB\n    Collation = \"SQL_Latin1_General_CP1_CI_AS\",\n    RequestedBackupStorageRedundancy = SqlBackupStorageRedundancy.Local\n};\n\nvar databaseCollection = server.GetSqlDatabases();\nvar dbOperation = await databaseCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-database\",\n    databaseData);\n\nSqlDatabaseResource database = dbOperation.Value;\n```\n\n### 3. Create Elastic Pool\n\n```csharp\nvar poolData = new ElasticPoolData(AzureLocation.EastUS)\n{\n    Sku = new SqlSku(\"StandardPool\")\n    {\n        Tier = \"Standard\",\n        Capacity = 100 \u002F\u002F 100 eDTUs\n    },\n    PerDatabaseSettings = new ElasticPoolPerDatabaseSettings\n    {\n        MinCapacity = 0,\n        MaxCapacity = 100\n    }\n};\n\nvar poolCollection = server.GetElasticPools();\nvar poolOperation = await poolCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-elastic-pool\",\n    poolData);\n\nElasticPoolResource pool = poolOperation.Value;\n```\n\n### 4. Add Database to Elastic Pool\n\n```csharp\nvar databaseData = new SqlDatabaseData(AzureLocation.EastUS)\n{\n    ElasticPoolId = pool.Id\n};\n\nawait databaseCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"pooled-database\",\n    databaseData);\n```\n\n### 5. Configure Firewall Rules\n\n```csharp\n\u002F\u002F Allow Azure services\nvar azureServicesRule = new SqlFirewallRuleData\n{\n    StartIPAddress = \"0.0.0.0\",\n    EndIPAddress = \"0.0.0.0\"\n};\n\nvar firewallCollection = server.GetSqlFirewallRules();\nawait firewallCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"AllowAzureServices\",\n    azureServicesRule);\n\n\u002F\u002F Allow specific IP range\nvar clientRule = new SqlFirewallRuleData\n{\n    StartIPAddress = \"203.0.113.0\",\n    EndIPAddress = \"203.0.113.255\"\n};\n\nawait firewallCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"AllowClientIPs\",\n    clientRule);\n```\n\n### 6. List Resources\n\n```csharp\n\u002F\u002F List all servers in subscription\nawait foreach (var srv in subscription.GetSqlServersAsync())\n{\n    Console.WriteLine($\"Server: {srv.Data.Name} in {srv.Data.Location}\");\n}\n\n\u002F\u002F List databases in a server\nawait foreach (var db in server.GetSqlDatabases())\n{\n    Console.WriteLine($\"Database: {db.Data.Name}, SKU: {db.Data.Sku?.Name}\");\n}\n\n\u002F\u002F List elastic pools\nawait foreach (var ep in server.GetElasticPools())\n{\n    Console.WriteLine($\"Pool: {ep.Data.Name}, DTU: {ep.Data.Sku?.Capacity}\");\n}\n```\n\n### 7. Get Connection String\n\n```csharp\n\u002F\u002F Build connection string (server FQDN is predictable)\nvar serverFqdn = $\"{server.Data.Name}.database.windows.net\";\nvar connectionString = $\"Server=tcp:{serverFqdn},1433;\" +\n    $\"Initial Catalog={database.Data.Name};\" +\n    \"Persist Security Info=False;\" +\n    $\"User ID={server.Data.AdministratorLogin};\" +\n    \"Password=\u003Cyour-password>;\" +\n    \"MultipleActiveResultSets=False;\" +\n    \"Encrypt=True;\" +\n    \"TrustServerCertificate=False;\" +\n    \"Connection Timeout=30;\";\n```\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `ArmClient` | Entry point for all ARM operations |\n| `SqlServerResource` | Represents an Azure SQL server |\n| `SqlServerCollection` | Collection for server CRUD |\n| `SqlDatabaseResource` | Represents a SQL database |\n| `SqlDatabaseCollection` | Collection for database CRUD |\n| `ElasticPoolResource` | Represents an elastic pool |\n| `ElasticPoolCollection` | Collection for elastic pool CRUD |\n| `SqlFirewallRuleResource` | Represents a firewall rule |\n| `SqlFirewallRuleCollection` | Collection for firewall rule CRUD |\n| `SqlServerData` | Server creation\u002Fupdate payload |\n| `SqlDatabaseData` | Database creation\u002Fupdate payload |\n| `ElasticPoolData` | Elastic pool creation\u002Fupdate payload |\n| `SqlFirewallRuleData` | Firewall rule creation\u002Fupdate payload |\n| `SqlSku` | SKU configuration (tier, capacity) |\n\n## Common SKUs\n\n### Database SKUs\n\n| SKU Name | Tier | Description |\n|----------|------|-------------|\n| `Basic` | Basic | 5 DTUs, 2 GB max |\n| `S0`-`S12` | Standard | 10-3000 DTUs |\n| `P1`-`P15` | Premium | 125-4000 DTUs |\n| `GP_Gen5_2` | GeneralPurpose | vCore-based, 2 vCores |\n| `BC_Gen5_2` | BusinessCritical | vCore-based, 2 vCores |\n| `HS_Gen5_2` | Hyperscale | vCore-based, 2 vCores |\n\n### Elastic Pool SKUs\n\n| SKU Name | Tier | Description |\n|----------|------|-------------|\n| `BasicPool` | Basic | 50-1600 eDTUs |\n| `StandardPool` | Standard | 50-3000 eDTUs |\n| `PremiumPool` | Premium | 125-4000 eDTUs |\n| `GP_Gen5_2` | GeneralPurpose | vCore-based |\n| `BC_Gen5_2` | BusinessCritical | vCore-based |\n\n## Best Practices\n\n1. **Use `WaitUntil.Completed`** for operations that must finish before proceeding\n2. **Use `WaitUntil.Started`** when you want to poll manually or run operations in parallel\n3. **Always use `DefaultAzureCredential`** — never hardcode passwords in production\n4. **Handle `RequestFailedException`** for ARM API errors\n5. **Use `CreateOrUpdateAsync`** for idempotent operations\n6. **Navigate hierarchy** via `Get*` methods (e.g., `server.GetSqlDatabases()`)\n7. **Use elastic pools** for cost optimization when managing multiple databases\n8. **Configure firewall rules** before attempting connections\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    var operation = await serverCollection.CreateOrUpdateAsync(\n        WaitUntil.Completed, serverName, serverData);\n}\ncatch (RequestFailedException ex) when (ex.Status == 409)\n{\n    Console.WriteLine(\"Server already exists\");\n}\ncatch (RequestFailedException ex) when (ex.Status == 400)\n{\n    Console.WriteLine($\"Invalid request: {ex.Message}\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"ARM Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}\");\n}\n```\n\n## Reference Files\n\n| File | When to Read |\n|------|--------------|\n| [references\u002Fserver-management.md](references\u002Fserver-management.md) | Server CRUD, admin credentials, Azure AD auth, networking |\n| [references\u002Fdatabase-operations.md](references\u002Fdatabase-operations.md) | Database CRUD, scaling, backup, restore, copy |\n| [references\u002Felastic-pools.md](references\u002Felastic-pools.md) | Pool management, adding\u002Fremoving databases, scaling |\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Microsoft.Data.SqlClient` | Data plane (execute queries, stored procedures) | `dotnet add package Microsoft.Data.SqlClient` |\n| `Azure.ResourceManager.Sql` | Management plane (this SDK) | `dotnet add package Azure.ResourceManager.Sql` |\n| `Microsoft.EntityFrameworkCore.SqlServer` | ORM for SQL Server | `dotnet add package Microsoft.EntityFrameworkCore.SqlServer` |\n",{"name":5,"license":15,"metadata":58,"description":61},{"author":12,"package":59,"version":60},"Azure.ResourceManager.Sql","1.0.0","Azure Resource Manager SDK for Azure SQL in .NET. Use for MANAGEMENT PLANE operations: creating\u002Fmanaging SQL servers, databases, elastic pools, firewall rules, and failover groups via Azure Resource Manager. NOT for data plane operations (executing queries) - use Microsoft.Data.SqlClient for that. Triggers: \"SQL server\", \"create SQL database\", \"manage SQL resources\", \"ARM SQL\", \"SqlServerResource\", \"provision Azure SQL\", \"elastic pool\", \"firewall rule\".\n","main","3f5b461b2314e01c400564051e92469114c5b68f",".github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-resource-manager-sql-dotnet",368,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","https:\u002F\u002Fmicrosoft.github.io\u002Fskills\u002F","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 02:08:41",{"source":8,"skillName":5,"commands":73,"prompt":83,"zipAvailable":84},[74,77,80],{"tool":75,"command":76},"npx","npx skills add microsoft\u002Fskills --skill azure-resource-manager-sql-dotnet",{"tool":78,"command":79},"bunx","bunx skills add microsoft\u002Fskills --skill azure-resource-manager-sql-dotnet",{"tool":81,"command":82},"pnpm","pnpm dlx skills add microsoft\u002Fskills --skill azure-resource-manager-sql-dotnet","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-resource-manager-sql-dotnet\u002FSKILL.md",true,[86,92,96],{"path":87,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fdatabase-operations.md","REFERENCE","参考文档",6993,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-resource-manager-sql-dotnet\u002Freferences\u002Fdatabase-operations.md",{"path":93,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":94,"sourceHtmlUrl":95},"references\u002Felastic-pools.md",5938,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-resource-manager-sql-dotnet\u002Freferences\u002Felastic-pools.md",{"path":97,"resourceType":88,"resourceTypeDesc":89,"sizeBytes":98,"sourceHtmlUrl":99},"references\u002Fserver-management.md",5340,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-resource-manager-sql-dotnet\u002Freferences\u002Fserver-management.md",[101,125,161,188,208,242],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":108,"publishedAt":53},"01M69B4JCRQV5SPXAFCKXQRV0H","skill-creator","Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fskill-creator\u002FSKILL.md",[107],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[109,110,111,9,112,113,114,35,115,116,117,118,119,120,121,40,122,123,124],"skill creator","creator","coding agents","foundry","microsoft foundry","ai coding agents","services","coding","guide","use","ai coding","with","sdks","Existing","when","new",{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":139,"publishedAt":53},"01M69B4FD57V1MYKRWAJJECTZ7","podcast-generation","Generate AI-powered podcast-style audio narratives using Azure OpenAI's GPT Realtime Mini model via WebSocket. Use when building text-to-speech features, audio narrative generation, podcast creation from content, or integrating with Azure OpenAI Realtime API for real audio output. Covers full-stack implementation from React frontend to Python FastAPI backend with WebSocket streaming.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fpodcast-generation\u002FSKILL.md",[131,134,135,138],{"categoryNo":132,"categoryName":133,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":136,"categoryName":137,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[140,141,142,143,144,145,146,35,147,148,149,150,151,152,153,154,155,156,157,158,159,123,160],"podcast generation","podcast","generation","frontend","python","react","realtime","azure openai","generate","streaming","api","Audio","stack","text","model","fastapi","creation","python fastapi","narrative","features","fastapi backend",{"skillNo":162,"name":163,"nameZh":6,"description":164,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":165,"categories":166,"keywords":168,"publishedAt":53},"01M69B4CYPM5SESY5ZWEFDXEQZ","microsoft-docs","Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention \"docs.\" If the question is about understanding a concept rather than writing code, this is the right skill.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[167],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[169,9,170,171,172,173,174,175,176,177,178,35,179,180,181,118,182,75,183,184,185,186,187,40],"docs","microsoft docs","MCP","writing","cli","mcp server","windows","power platform","official","documentation","learn","best practices","question","power","back","technology","platform","learn mcp","concept",{"skillNo":189,"name":190,"nameZh":6,"description":191,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":192,"categories":193,"keywords":195,"publishedAt":53},"01M69B49C3YPD1ZJ3NC0HPCY58","mcp-builder","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node\u002FTypeScript (MCP SDK), or C#\u002F.NET (Microsoft MCP SDK).","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmcp-builder\u002FSKILL.md",[194],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[171,196,197,198,144,199,47,200,9,201,202,154,203,204,117,118,205,206,207,120,40,123],"mcp builder","builder","typescript","llms","model context protocol","fastmcp","Tools","node","context","integrate","mcp sdk","building mcp servers",{"skillNo":209,"name":210,"nameZh":6,"description":211,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":212,"categories":213,"keywords":222,"publishedAt":53},"01M69B467A7CDMFQ0T6Q0ZA12Q","kql","KQL language expertise for writing correct, efficient Kusto Query Language queries. Covers syntax gotchas, join patterns, dynamic types, datetime pitfalls, regex patterns, serialization, memory management, result-size discipline, and advanced functions (geo, vector, graph). USE THIS SKILL whenever writing, debugging, or reviewing KQL queries — even simple ones — because the gotchas section prevents the most common errors that waste tool calls and cause expensive retry cascades. Trigger on: KQL, Kusto, ADX, Azure Data Explorer, Fabric Real-Time Intelligence, EventHouse, Log Analytics, log analysis, data exploration, time series, anomaly detection, summarize, where clause, join, extend, project, let statement, parse operator, extract function, any mention of pipe-forward query syntax.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fkql\u002FSKILL.md",[214,217,218,219],{"categoryNo":215,"categoryName":216,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},{"categoryNo":220,"categoryName":221,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000036","内容创作者",[210,172,223,224,225,35,226,227,228,229,230,231,232,233,234,235,236,237,238,40,239,240,241],"summarize","memory","analytics","vector","time series","tool","discipline","log","geo","exploration","pipe","time","project","regex","join","datetime","section","anomaly","parse",{"skillNo":243,"name":244,"nameZh":6,"description":245,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":246,"categories":247,"keywords":248,"publishedAt":53},"01M69B44HJQ7897EZ7NE7DWQX3","github-issue-creator","Convert raw notes, error logs, voice dictation, or screenshots into crisp GitHub-flavored markdown issue reports. Use when the user pastes bug info, error messages, or informal descriptions and wants a structured GitHub issue. Supports images\u002FGIFs for visual evidence.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fgithub-issue-creator\u002FSKILL.md",[],[249,250,251,252,110,253,254,255,256,257,258,259,118,260,261,262,263,264,265,40,123],"github","github issue creator","github issue","issue","issue creator","screenshots","notes","logs","error messages","messages","convert","evidence","reports","images","info","visual","error"]