azure-resource-manager-cosmosdb-dotnet

Aperçu du skill azure-resource-manager-cosmosdb-dotnet

azure-resource-manager-cosmosdb-dotnet est le skill de plan de gestion .NET pour Azure Cosmos DB. Utilisez-le lorsque vous devez provisionner ou modifier des comptes Cosmos DB, des bases de données SQL, des conteneurs, du throughput et du RBAC via Azure Resource Manager, plutôt que lire ou écrire des documents. Il convient bien aux équipes backend qui automatisent la configuration cloud, aux platform engineers et aux agents qui doivent générer du code d’infrastructure avec le bon SDK Azure.

À quoi sert ce skill

Le skill azure-resource-manager-cosmosdb-dotnet se concentre sur les tâches de control plane : création de comptes, configuration des régions et du failover, gestion des bases de données et des conteneurs, et définition du throughput. Si votre tâche concerne le CRUD sur des éléments, les requêtes ou les procédures stockées, ce n’est pas le bon SDK ; ce skill n’est volontairement pas destiné au data plane.

Quand c’est le bon choix

Choisissez ce skill si votre prompt contient des formulations comme « créer un compte Cosmos », « provisionner Cosmos DB », « gérer des ressources Cosmos » ou « configurer le throughput Cosmos ». Son principal intérêt est de réduire la confusion entre les API d’administration de Cosmos DB et les API de données applicatives, qui est le principal frein à l’adoption.

Différenciateur clé

Le signal le plus fort dans azure-resource-manager-cosmosdb-dotnet est la frontière entre management plane et data plane. Cette frontière compte, car le code généré, le modèle d’authentification et les objets de ressource sont différents de ceux du SDK standard Microsoft.Azure.Cosmos. Ce skill est surtout utile quand vous voulez le SDK Azure pour .NET, pas un guide générique du portail Azure.

Comment utiliser le skill azure-resource-manager-cosmosdb-dotnet

Installer et vérifier le package

Pour un projet .NET local, installez les SDK sous-jacents avec :
dotnet add package Azure.ResourceManager.CosmosDB
dotnet add package Azure.Identity

Si votre environnement utilise un gestionnaire de skills, installez d’abord le skill azure-resource-manager-cosmosdb-dotnet, puis utilisez-le pour structurer le code et le modèle de ressources avant d’écrire l’implémentation finale.

Partir avec la bonne demande

Une bonne demande pour azure-resource-manager-cosmosdb-dotnet doit nommer le type de ressource, la surface API, l’intention de déploiement et les contraintes. Par exemple : « Crée un service .NET 8 qui provisionne une base de données Cosmos DB SQL avec throughput autoscale, deux régions et l’identité managée. » C’est bien mieux que « aide-moi avec Cosmos DB », parce que le skill peut alors mapper directement vers les bonnes ressources ARM.

Les meilleurs fichiers à lire en premier

Commencez par SKILL.md, puis lisez references/account-management.md, references/sql-resources.md et references/throughput.md. Ces fichiers couvrent les choix pratiques qui influencent la qualité du résultat : création de compte, opérations sur les ressources SQL et dimensionnement en RU/s. Si vous ne parcourez qu’une seule référence, commencez par le throughput, car il détermine souvent le coût et l’architecture.

Modèle de prompt qui fonctionne bien

Un prompt utile pour azure-resource-manager-cosmosdb-dotnet doit inclure :

• la ressource cible : compte, base de données, conteneur ou RBAC
• le besoin de throughput manuel ou autoscale
• le nombre de régions et les attentes en matière de failover
• le mode d’authentification : DefaultAzureCredential, principal de service ou identité managée
• si vous avez besoin uniquement du code de provisioning ou aussi des flux de mise à jour/suppression

Exemple : « Génère le code de configuration backend pour Azure.ResourceManager.CosmosDB qui crée un compte Cosmos DB en East US et West US, active le failover automatique, crée une base de données SQL et utilise autoscale à 4000 RU/s. »

FAQ du skill azure-resource-manager-cosmosdb-dotnet

Est-ce la même chose que le SDK de données Cosmos DB ?

Non. azure-resource-manager-cosmosdb-dotnet sert uniquement aux opérations de management plane. Utilisez-le pour l’administration des comptes et des ressources, et utilisez Microsoft.Azure.Cosmos pour les opérations de données applicatives comme l’insertion, la lecture, les requêtes et la suppression.

azure-resource-manager-cosmosdb-dotnet est-il utile pour le backend ?

Oui, surtout lorsque les services backend gèrent aussi le provisioning cloud, le bootstrap d’environnements ou la mise en place de locataires. Il aide le code backend à créer une infrastructure Cosmos DB prévisible au lieu de s’appuyer sur des manipulations manuelles dans le portail.

Faut-il déjà bien connaître Azure pour l’utiliser ?

Pas vraiment, mais vous devez savoir ce que vous voulez provisionner. Le skill réduit les hésitations sur le SDK, mais vous devez tout de même décider si vous voulez un throughput partagé, de l’autoscale, un failover multi-région ou du RBAC.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas azure-resource-manager-cosmosdb-dotnet si votre besoin porte sur le CRUD de documents, l’optimisation des performances de requêtes dans une application ou des exemples de code pour la bibliothèque cliente Cosmos DB. Dans ces cas-là, le mauvais SDK produira du code qui compile, mais résout le mauvais problème.

Comment améliorer le skill azure-resource-manager-cosmosdb-dotnet

Donner au skill les choix de conception manquants

Les meilleurs résultats avec azure-resource-manager-cosmosdb-dotnet viennent de prompts qui précisent la forme du compte, pas seulement la ressource souhaitée. Indiquez si vous voulez uniquement l’API SQL, le nombre de régions, si les écritures doivent être mono-région ou multi-région, et si le throughput doit être fixe ou en autoscale.

Énoncer les contraintes opérationnelles dès le départ

Les causes d’échec les plus fréquentes sont une authentification mal spécifiée, un contexte d’abonnement absent et des demandes de throughput trop vagues. Une meilleure formulation ressemble à ceci : « Utilise l’identité managée dans Azure, cible l’ID d’abonnement fourni à l’exécution, crée une base de données SQL avec throughput partagé et n’utilise aucune fonctionnalité preview. » Cela évite au skill de faire des suppositions.

Itérer au niveau de la ressource, pas de toute l’application

Si le premier résultat est proche du besoin, améliorez l’usage de azure-resource-manager-cosmosdb-dotnet en demandant une modification plus ciblée : redondance du compte, indexation d’un conteneur SQL, migration du throughput ou affectation RBAC. Des ajustements petits et centrés sur la ressource donnent généralement un meilleur code qu’une demande de réécriture complète.

Lire les références avant de modifier les valeurs par défaut

L’axe d’amélioration consiste le plus souvent à choisir les bons paramètres Cosmos DB, pas à ajouter plus de code. Consultez references/account-management.md pour les indicateurs de compte, references/sql-resources.md pour les opérations sur les bases et les conteneurs, et references/throughput.md lorsque le coût ou le comportement de montée en charge est en jeu.