azure-resource-manager-cosmosdb-dotnet

Tổng quan về skill azure-resource-manager-cosmosdb-dotnet

azure-resource-manager-cosmosdb-dotnet là skill quản trị plane .NET cho Azure Cosmos DB. Hãy dùng nó khi bạn cần provision hoặc thay đổi tài khoản Cosmos DB, SQL databases, containers, throughput và RBAC thông qua Azure Resource Manager, thay vì đọc hoặc ghi documents. Đây là lựa chọn phù hợp cho các team backend tự động hóa thiết lập cloud, platform engineers, và các agent cần tạo infrastructure code với đúng Azure SDK.

Skill này dùng để làm gì

Skill azure-resource-manager-cosmosdb-dotnet tập trung vào các tác vụ control-plane: tạo account, cấu hình region và failover, quản lý databases và containers, và thiết lập throughput. Nếu tác vụ của bạn là CRUD trên items, query, hoặc stored procedures, thì đây là SDK sai; skill này được thiết kế không dành cho data-plane work.

Khi nào đây là lựa chọn đúng

Hãy chọn skill này khi prompt của bạn có các cụm như “create Cosmos account,” “provision Cosmos DB,” “manage Cosmos resources,” hoặc “configure Cosmos throughput.” Giá trị chính của nó là giảm nhầm lẫn giữa Cosmos DB admin APIs và application-data APIs, vốn là rào cản adoption phổ biến nhất.

Điểm khác biệt chính

Tín hiệu mạnh nhất của azure-resource-manager-cosmosdb-dotnet là ranh giới giữa management plane và data plane. Ranh giới này quan trọng vì code được sinh ra, mô hình xác thực, và các resource objects đều khác với SDK Microsoft.Azure.Cosmos thông thường. Skill này hữu ích nhất khi bạn muốn Azure SDK cho .NET, chứ không phải một hướng dẫn chung chung trong Azure portal.

Cách dùng skill azure-resource-manager-cosmosdb-dotnet

Cài đặt và xác nhận package

Với một dự án .NET cục bộ, hãy cài các SDK nền tảng bằng:
dotnet add package Azure.ResourceManager.CosmosDB
dotnet add package Azure.Identity

Nếu môi trường của bạn dùng skills manager, hãy cài skill azure-resource-manager-cosmosdb-dotnet trước, rồi dùng nó để định hình code và resource model trước khi viết phần triển khai cuối cùng.

Bắt đầu với đầu vào đúng

Một yêu cầu sử dụng azure-resource-manager-cosmosdb-dotnet tốt cần nêu rõ loại resource, bề mặt API, ý định triển khai, và các ràng buộc. Ví dụ: “Create a .NET 8 service that provisions a Cosmos DB SQL database with autoscale throughput, two regions, and managed identity.” Cách này tốt hơn nhiều so với “help with Cosmos DB,” vì skill có thể map thẳng sang đúng ARM resources.

Những file nên đọc trước

Bắt đầu với SKILL.md, rồi đọc references/account-management.md, references/sql-resources.md, và references/throughput.md. Các file này bao quát những lựa chọn thực tế ảnh hưởng đến chất lượng đầu ra: tạo account, thao tác SQL resource, và sizing RU/s. Nếu bạn chỉ đọc lướt một reference, hãy đọc throughput trước, vì nó thường quyết định cả chi phí lẫn kiến trúc.

Mẫu prompt hiệu quả

Một prompt hữu ích cho azure-resource-manager-cosmosdb-dotnet nên bao gồm:

• resource mục tiêu: account, database, container, hoặc RBAC
• bạn cần throughput thủ công hay autoscale
• số lượng region và kỳ vọng failover
• kiểu auth: DefaultAzureCredential, service principal, hay managed identity
• bạn chỉ cần code provisioning hay còn cần luồng update/delete nữa

Ví dụ: “Generate backend setup code for Azure.ResourceManager.CosmosDB that creates a Cosmos DB account in East US and West US, enables automatic failover, creates a SQL database, and uses autoscale at 4000 RU/s.”

Câu hỏi thường gặp về skill azure-resource-manager-cosmosdb-dotnet

Đây có giống Cosmos DB data SDK không?

Không. azure-resource-manager-cosmosdb-dotnet chỉ dành cho các thao tác management-plane. Hãy dùng nó cho quản trị account và resource, và dùng Microsoft.Azure.Cosmos cho các thao tác dữ liệu ứng dụng như insert, read, query, và delete.

azure-resource-manager-cosmosdb-dotnet có hữu ích cho Backend Development không?

Có, đặc biệt khi backend services cũng chịu trách nhiệm provisioning cloud, bootstrap môi trường, hoặc thiết lập tenant. Nó giúp code backend tạo hạ tầng Cosmos DB có tính dự đoán thay vì phụ thuộc vào các bước thao tác thủ công trong portal.

Tôi có cần biết nhiều Azure trước khi dùng không?

Không nhiều, nhưng bạn vẫn cần biết mình muốn provision cái gì. Skill này giảm phần phải đoán SDK, nhưng bạn vẫn phải quyết định dùng shared throughput, autoscale, multi-region failover, hay RBAC.

Khi nào không nên dùng nó?

Đừng dùng azure-resource-manager-cosmosdb-dotnet nếu công việc của bạn là document CRUD, tối ưu hiệu năng query trong app, hoặc cần ví dụ code cho Cosmos DB client library. Trong các trường hợp đó, dùng sai SDK có thể tạo ra code biên dịch được nhưng giải quyết sai bài toán.

Cách cải thiện skill azure-resource-manager-cosmosdb-dotnet

Cung cấp các quyết định thiết kế còn thiếu

Đầu ra tốt nhất từ azure-resource-manager-cosmosdb-dotnet đến từ prompt nêu rõ hình dạng account, chứ không chỉ resource mong muốn. Hãy nói bạn có cần chỉ SQL API hay không, bao nhiêu region, write là single-region hay multi-region, và throughput nên cố định hay autoscale.

Nêu rõ các ràng buộc vận hành từ đầu

Các lỗi thường gặp là auth không đủ chi tiết, thiếu subscription context, và yêu cầu throughput quá mơ hồ. Đầu vào tốt hơn sẽ là: “Use managed identity in Azure, target subscription ID provided at runtime, create a SQL database with shared throughput, and avoid preview features.” Cách này giúp skill không phải tự đoán.

Lặp lại ở cấp resource, không phải toàn bộ app

Nếu kết quả đầu tiên đã gần đúng, hãy cải thiện cách dùng azure-resource-manager-cosmosdb-dotnet bằng cách yêu cầu thay đổi hẹp hơn: account redundancy, SQL container indexing, throughput migration, hoặc RBAC assignment. Những chỉnh sửa nhỏ, theo từng resource, thường cho code tốt hơn nhiều so với yêu cầu viết lại toàn bộ.

Đọc các reference trước khi đổi defaults

Lộ trình cải thiện thường là chọn đúng cấu hình Cosmos DB, chứ không phải viết thêm code. Hãy xem references/account-management.md cho các account flags, references/sql-resources.md cho thao tác database/container, và references/throughput.md khi vấn đề nằm ở chi phí hoặc hành vi scaling.