Librerie di Azure Cosmos DB per .NET

  • Articolo

Panoramica

Azure Cosmos DB è un servizio di database multimodello e distribuito a livello globale. È progettato per ridimensionare in modo elastico e indipendente velocità effettiva e memoria tra più aree geografiche con un contratto di servizio completo. Azure Cosmos DB consente di archiviare e accedere a database di documenti, con coppie chiave-valore, con colonna ampia e con elementi grafici mediante API e modelli di programmazione.

Introduzione ad Azure Cosmos DB.

Libreria client

Usare la libreria client di Azure Cosmos DB per .NET per accedere ai dati e archiviarli in un archivio dati Azure Cosmos DB esistente. Per automatizzare la creazione di un nuovo account Azure Cosmos DB, usare il portale di Azure, l'interfaccia della riga di comando o PowerShell.

Installare il pacchetto NuGet direttamente dalla Console di Gestione pacchetti di Visual Studio o tramite l'interfaccia della riga di comando di .NET Core.

Per installare la versione 3.x, destinata a .NET Standard:

Visual Studio - Gestione pacchetti

Install-Package Microsoft.Azure.Cosmos

Interfaccia della riga di comando di .NET Core

dotnet add package Microsoft.Azure.Cosmos

Esempio di codice

Questo esempio si collega a un database API SQL di Azure Cosmos DB esistente, crea un nuovo database e contenitore, legge un elemento dal contenitore e lo deserializza in un oggetto TodoItem. Questo esempio usa la versione 3.x di .NET SDK.

// CosmosClient should always be a singleton for an application
using (CosmosClient cosmosClient = new CosmosClient("endpoint", "primaryKey"))
{
    Container container = cosmosClient.GetContainer("DatabaseId", "ContainerId");
    // Read item from container
    CosmosItemResponse<TodoItem> todoItemResponse = await container.ReadItemAsync<TodoItem>("ItemId", new PartitionKey("partitionKeyValue"));
}

Esplorare le API client

Esempi