Bibliotecas do Azure Cosmos DB para .NET

  • Artigo

Visão geral

O Azure Cosmos DB é um serviço de banco de dados multimodelo globalmente distribuído. Ele é projetado para se dimensionar de modo elástico e independente, com armazenamento em quaisquer regiões geográficas e um SLA abrangente. Com o Azure Cosmos DB, você pode armazenar e acessar bancos de dados de documentos, valores-chave, de toda a coluna e gráficos usando APIs e modelos de programação.

Introdução ao Azure Cosmos DB.

Biblioteca do cliente

Use a biblioteca de clientes .NET do Azure Cosmos DB para acessar e armazenar dados em um armazenamento de dados do Azure Cosmos DB existente. Para automatizar a criação de uma nova conta do Azure Cosmos DB, use o Portal do Azure, a CLI ou o PowerShell.

Instale o pacote NuGet diretamente do console do Gerenciador de Pacotes do Visual Studio ou com a CLI do .NET Core.

Para instalar a versão 3.x, que tem como destino o .NET Standard:

Gerenciador de Pacotes do Visual Studio

Install-Package Microsoft.Azure.Cosmos

CLI do .NET Core

dotnet add package Microsoft.Azure.Cosmos

Exemplo de código

Este exemplo conecta-se ao banco de dados API de SQL do Azure Cosmos DB existente, cria um novo banco de dados e um contêiner, lê um item do contêiner e desserializa-o para um objeto TodoItem. Este exemplo usa a versão 3.x do SDK do .NET.

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

Explorar as APIs do cliente

Exemplos