Bibliotecas de Azure Cosmos DB para .NET

  • Artículo

Introducción

Azure Cosmos DB es un servicio de base de datos multimodelo distribuido globalmente. Está diseñado para permitir que los clientes escalen de manera elástica e independiente el rendimiento y el almacenamiento en cualquier número de regiones geográficas con un completo SLA. Con Azure Cosmos DB, puede almacenar y tener acceso a bases de datos de documentos, de pares clave-valor, columnares y de grafos mediante API y modelos de programación.

Introducción a Azure Cosmos DB.

Biblioteca de cliente

Utilice la biblioteca de cliente de Azure Cosmos DB para .NET para almacenar los datos y acceder a ellos en un almacén de datos de Azure Cosmos DB existente. Para automatizar la creación de una nueva cuenta de Azure Cosmos DB, use Azure Portal, la CLI o PowerShell.

Instale el paquete NuGet directamente desde la Consola del Administración de paquetes de Visual Studio o con la CLI de .NET Core.

Para instalar la versión 3.x, que tiene como destino .NET Standard:

Administrador de paquetes de Visual Studio

Install-Package Microsoft.Azure.Cosmos

CLI de .NET Core

dotnet add package Microsoft.Azure.Cosmos

Ejemplo de código

En este ejemplo, se conecta con una base de datos de SQL API de Azure Cosmos DB existente, se crea una nueva base de datos y un contenedor, se lee un elemento del contenedor y se deserializa en un objeto TodoItem. En este ejemplo, se usa la versión 3.x del SDK para .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"));
}

Exploración de las API de cliente

Ejemplos