[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-96bda8c9-3cef-4f74-a10f-a659ef1e8392":3,"$fiHnH98pKpcEuW6JUeVztRFG25jQLRQQZhKi4KR1awe4":42},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":33},"96bda8c9-3cef-4f74-a10f-a659ef1e8392","azure-resource-manager-sql-dotnet","Azure SQL的.NET Azure资源管理器SDK","cat_coding_backend","mod_coding","sickn33,coding","---\nname: azure-resource-manager-sql-dotnet\ndescription: Azure Resource Manager SDK for Azure SQL in .NET.\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\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>\n# For service principal auth (optional)\nAZURE_TENANT_ID=\u003Ctenant-id>\nAZURE_CLIENT_ID=\u003Cclient-id>\nAZURE_CLIENT_SECRET=\u003Cclient-secret>\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.Sql;\n\n\u002F\u002F Always use DefaultAzureCredential\nvar credential = new DefaultAzureCredential();\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 | Server CRUD, admin credentials, Azure AD auth, networking |\n| references\u002Fdatabase-operations.md | Database CRUD, scaling, backup, restore, copy |\n| 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\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,183,1439,"2026-05-16 13:07:29",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":25,"skillCount":32,"createdAt":26},"后端开发","backend","mdi-server","API、数据库、服务端架构",296,[34],{"id":35,"skillId":4,"version":36,"fileName":37,"fileSize":38,"filePath":39,"fileHash":40,"manifest":41,"createdAt":19},"3d1759a3-24d1-450d-bb17-d143293c0fd7","1.0.0","azure-resource-manager-sql-dotnet.zip",3450,"uploads\u002Fskills\u002F96bda8c9-3cef-4f74-a10f-a659ef1e8392\u002Fazure-resource-manager-sql-dotnet.zip","19fdb458fdc4e40de5485b88e5a7dc20f23b4c9b0c6bc146a699af744ea73693","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":9778}]",{"code":43,"message":44,"data":45},200,"success",{"items":46,"stats":47,"page":50},[],{"averageRating":48,"totalRatings":48,"ratingCounts":49},0,[48,48,48,48,48],{"limit":51,"offset":48,"hasMore":52,"nextOffset":51,"ratedOnly":16},15,false]