Partage via

Démarrage rapide : utiliser Azure Cosmos DB for MongoDB (RU) avec .NET

  • Article
  • S’applique à:
    ✅ MongoDB (RU)

Dans ce démarrage rapide, vous déployez une application Azure Cosmos DB for MongoDB de base en utilisant Python. Azure Cosmos DB for MongoDB est un magasin de données sans schéma qui permet aux applications de stocker des documents non structurés dans le cloud avec des bibliothèques MongoDB. Vous apprenez à créer des documents et à effectuer des tâches de base au sein de votre ressource Azure Cosmos DB en tirant parti de Python.

Code source de la bibliothèque | Package (NuGet) | Azure Developer CLI

Prérequis

  • Azure Developer CLI
  • Docker Desktop
  • .NET SDK 9.0

Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.

Initialiser le projet

Utilisez l’interface Azure Developer CLI (azd) pour créer un compte Azure Cosmos DB for Table et déployer un exemple d’application conteneurisé. L’exemple d’application utilise la bibliothèque de client pour gérer, créer, lire et interroger des exemples de données.

  1. Ouvrez un terminal dans un répertoire vide.

  2. Si vous n’êtes pas encore authentifié, authentifiez-vous auprès d’Azure Developer CLI à l’aide de azd auth login. Suivez les étapes spécifiées par l’outil pour vous authentifier auprès de l’interface CLI à l’aide de vos informations d’identification Azure préférées.

    azd auth login

  3. Utilisez azd init pour initialiser le projet.

    azd init --template cosmos-db-mongodb-dotnet-quickstart

  4. Lors de l’initialisation, configurez un nom d’environnement unique.

  5. Déployez le compte Azure Cosmos DB en utilisant azd up. Les modèles Bicep déploient également un exemple d’application web.

    azd up

  6. Pendant le processus d’approvisionnement, sélectionnez votre abonnement, l’emplacement souhaité et le groupe de ressources cible. Attendez la fin du processus de provisionnement. Le processus peut prendre environ cinq minutes.

  7. Une fois le provisionnement de vos ressources Azure effectué, une URL vers l’application web en cours d’exécution est incluse dans la sortie.

    Deploying services (azd deploy)

  (✓) Done: Deploying service web
- Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>

SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.

  8. Utilisez l’URL dans la console pour accéder à votre application web dans le navigateur. Observez la sortie de l’application en cours d’exécution.

Capture d’écran de l’application web en cours d’exécution.

Installer la bibliothèque de client

La bibliothèque cliente est disponible via NuGet, en tant que package MongoDB.Driver.

  1. Ouvrez un terminal et accédez au dossier /src/web.

    cd ./src/web

  2. S’il n’est pas déjà installé, installez le package MongoDB.Driver à l’aide de dotnet add package.

    dotnet add package MongoDB.Driver

  3. Ouvrez et examinez le fichier src/web/Microsoft.Samples.Cosmos.MongoDB.Quickstart.Web.csproj pour vérifier que l’entrée MongoDB.Driver existe.

Modèle objet

Nom Description
MongoClient Type utilisé pour se connecter à MongoDB.
Database Représente une base de données dans le compte.
Collection Représente une collection au sein d’une base de données dans le compte.

Exemples de code

L’exemple de code du modèle utilise une base de données nommée cosmicworks et une collection nommée products. La collection products contient des détails tels que le nom, la catégorie, la quantité et un identificateur unique pour chaque produit. La collection utilise la propriété /category comme clé de partition.

Authentifier le client

Cet exemple crée une instance de la classe MongoClient.

string connectionString = "<azure-cosmos-db-for-mongodb-connection-string>";

MongoClient client = new(connectionString);

Obtenir une base de données

Cet exemple crée une instance de l’interface IMongoDatabase en utilisant la méthode GetDatabase de la classe MongoClient.

IMongoDatabase database = client.GetDatabase("<database-name>");

Obtention d’une collection

Cet exemple crée une instance de l’interface IMongoCollection<> générique en utilisant la méthode générique GetCollection<> de l’interface IMongoDatabase. La méthode et l’interface génériques utilisent un type nommé Product défini dans une autre classe.

IMongoCollection<Product> collection = database.GetCollection<Product>("<collection-name>");

public record Product(
    string id,
    string category,
    string name,
    int quantity,
    decimal price,
    bool clearance
);

Créer un document

Créez un document dans la collection en tirant parti de collection.ReplaceOneAsync<> avec le paramètre de type Product générique. Cette méthode fait un « upsert » de l’élément en le remplaçant de manière effective s’il existe déjà.

Product document = new(
    id: "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    category: "gear-surf-surfboards",
    name: "Yamba Surfboard",
    quantity: 12,
    price: 850.00m,
    clearance: false
);

await collection.ReplaceOneAsync<Product>(
    d => d.id == document.id,
    document,
    new ReplaceOptions { IsUpsert = true }
);

Lire un document

Effectuez une opération de lecture de point en utilisant les champs d’identificateur unique (id) et de clé de partition. Utilisez collection.FindAsync<> avec le paramètre de type Product générique pour récupérer efficacement l’élément spécifique.

IAsyncCursor<Product> documents = await collection.FindAsync<Product>(
    d => d.id == "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" && d.category == "gear-surf-surfboards"
);

Product? document = await documents.SingleOrDefaultAsync();

Interroger des documents

Effectuez une requête sur plusieurs éléments d’un conteneur en tirant parti de collection.AsQueryable() et de la syntaxe Language Integrated Query (LINQ). Cette requête trouve tous les éléments au sein d’une catégorie spécifiée (clé de partition).

IQueryable<Product> documents = collection.AsQueryable().Where(
    d => d.category == "gear-surf-surfboards"
);

foreach (Product document in await documents.ToListAsync())
{
    // Do something with each item
}

Exploration de vos données

Utilisez l’extension Visual Studio Code pour Azure Cosmos DB afin d’explorer vos données MongoDB. Vous pouvez effectuer des opérations de base de données de base, y compris, mais sans s’y limiter :

  • Exécution de requêtes en tirant parti d’un album ou de l’éditeur de requête
  • Modification, mise à jour, création et suppression de documents
  • Importation de données en bloc à partir d’autres sources
  • Gestion de bases de données et de collections

Pour découvrir plus d’informations, consultez Comment utiliser l’extension Visual Studio Code pour explorer des données Azure Cosmos DB for MongoDB.

Nettoyer les ressources

Lorsque vous n’avez plus besoin de l’exemple d’application ou de ressources, supprimez le déploiement correspondant et toutes les ressources.

azd down

Contenu connexe