Condividi tramite

Guida introduttiva: Usare Azure Cosmos DB per MongoDB (UR) con .NET

  • Articolo
  • Si applica a:
    ✅ MongoDB (RU)

In questa guida introduttiva si distribuisce un'applicazione Azure Cosmos DB per MongoDB di base usando Python. Azure Cosmos DB per MongoDB è un archivio dati senza schema che consente alle applicazioni di archiviare documenti non strutturati nel cloud con librerie MongoDB. Si apprenderà come creare documenti ed eseguire attività di base all'interno della risorsa di Azure Cosmos DB usando Python.

Pacchetto del codice | sorgente della libreria (NuGet)Interfaccia della riga di comando per | sviluppatori di Azure

Prerequisiti

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

Se non si ha un account Azure, creare un account gratuito prima di iniziare.

Inizializzare il progetto

Usare l'interfaccia della riga di comando per sviluppatori di Azure (azd) per creare un account Azure Cosmos DB per tabelle e distribuire un'applicazione di esempio in contenitori. L'applicazione di esempio usa la libreria client per gestire, creare, leggere ed eseguire query sui dati di esempio.

  1. Aprire un terminale in una directory vuota.

  2. Se non si è già autenticati, eseguire l'autenticazione all'interfaccia della riga di comando per sviluppatori di Azure usando azd auth login. Seguire i passaggi specificati dallo strumento per eseguire l'autenticazione all'interfaccia della riga di comando usando le credenziali di Azure preferite.

    azd auth login

  3. Usare azd init per inizializzare il progetto.

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

  4. Durante l'inizializzazione, configurare un nome di ambiente univoco.

  5. Distribuire l'account Azure Cosmos DB usando azd up. I modelli Bicep distribuiscono anche un'applicazione Web di esempio.

    azd up

  6. Durante il processo di provisioning selezionare la sottoscrizione, la località desiderata e il gruppo di risorse di destinazione. Attendere il completamento del processo di provisioning. Per il processo sono necessari circa 5 minuti.

  7. Al termine del provisioning delle risorse di Azure, nell'output viene incluso un URL dell'applicazione Web in esecuzione.

    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. Usare l'URL nella console per passare all'applicazione Web nel browser. Osservare l'output dell'app in esecuzione.

Screenshot dell'applicazione Web in esecuzione.

Installare la libreria client

La libreria client è disponibile tramite NuGet, come pacchetto MongoDB.Driver.

  1. Aprire un terminale e passare alla cartella /src/web:

    cd ./src/web

  2. Se non è già installato, installare il pacchetto MongoDB.Driver usando dotnet add package.

    dotnet add package MongoDB.Driver

  3. Aprire ed esaminare il file src/web/Microsoft.Samples.Cosmos.MongoDB.Quickstart.Web.csproj per verificare che la MongoDB.Driver voce esista.

Modello a oggetti

Nome Descrizione
MongoClient Tipo usato per connettersi a MongoDB.
Database Rappresenta un database nell'account.
Collection Rappresenta una raccolta all'interno di un database nell'account.

Esempi di codice

Il codice di esempio nel modello usa un database denominato e una raccolta denominata cosmicworksproducts. La products raccolta contiene dettagli quali nome, categoria, quantità e identificatore univoco per ogni prodotto. L'insieme usa la /category proprietà come chiave di partizione.

Autenticare il client

In questo esempio viene creata una nuova istanza della MongoClient classe .

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

MongoClient client = new(connectionString);

Ottenere un database

In questo esempio viene creata un'istanza dell'interfaccia IMongoDatabase usando il GetDatabase metodo della MongoClient classe .

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

Ottenere una raccolta

In questo esempio viene creata un'istanza dell'interfaccia generica IMongoCollection<> usando il GetCollection<> metodo generico dell'interfaccia IMongoDatabase . L'interfaccia generica e il metodo usano entrambi un tipo denominato Product definito in un'altra classe.

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

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

Creare un documento

Creare un documento nella raccolta usando collection.ReplaceOneAsync<> con il parametro di tipo generico Product . Questo metodo esegue l'upsert dell'elemento, in pratica sostituendolo, se esiste già.

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 }
);

Leggere un documento

Eseguire un'operazione di lettura del punto usando i campi identificatore univoco (id) e chiave di partizione. Usare collection.FindAsync<> con il parametro di tipo generico Product per recuperare in modo efficiente l'elemento specifico.

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();

Eseguire query su documenti

Eseguire una query su più elementi in un contenitore usando collection.AsQueryable() e una query LINQ (Language Integrated Query). Questa query trova tutti gli elementi all'interno di una categoria specificata (chiave di partizione).

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

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

Esplorare i dati

Usare l'estensione Di Visual Studio Code per Azure Cosmos DB per esplorare i dati di MongoDB. È possibile eseguire operazioni di database di base, tra cui:

  • Esecuzione di query tramite un scrapbook o l'editor di query
  • Modifica, aggiornamento, creazione ed eliminazione di documenti
  • Importazione di dati in blocco da altre origini
  • Gestione di database e raccolte

Per altre informazioni, vedere How-to use Visual Studio Code extension to explore Azure Cosmos DB for MongoDB data (Come usare l'estensione Visual Studio Code per esplorare i dati di Azure Cosmos DB per MongoDB).

Pulire le risorse

Quando l'applicazione o le risorse di esempio non sono più necessarie, rimuovere la distribuzione corrispondente e tutte le risorse.

azd down

Contenuto correlato