Sdílet prostřednictvím

Knihovny Azure Cosmos DB pro .NET

  • Článek

Přehled

Azure Cosmos DB je globálně distribuovaná databázová služba pro více modelů. Je navržená tak, aby elasticky a nezávisle škálovat propustnost a úložiště napříč libovolným počtem geografických oblastí s komplexní smlouvou SLA. Se službou Azure Cosmos DB můžete ukládat a přistupovat k databázím dokumentů, klíč-hodnota, širokých sloupců a grafů pomocí rozhraní API a programovacích modelů.

Začínáme se službou Azure Cosmos DB

Klientská knihovna

Pomocí klientské knihovny Azure Cosmos DB .NET můžete přistupovat k datům a ukládat je v existujícím úložišti dat Azure Cosmos DB. Pokud chcete automatizovat vytváření nového účtu služby Azure Cosmos DB, použijte Azure Portal, rozhraní příkazového řádku nebo PowerShell.

Nainstalujte balíček NuGet přímo z konzoly Správce balíčků sady Visual Studio nebo pomocí rozhraní příkazového řádku .NET Core.

Instalace verze 3.x, která cílí na .NET Standard:

Správce balíčků sady Visual Studio

Install-Package Microsoft.Azure.Cosmos

Rozhraní příkazového řádku .NET Core

dotnet add package Microsoft.Azure.Cosmos

Příklad kódu

Tento příklad se připojí k existující databázi rozhraní SQL API služby Azure Cosmos DB, vytvoří novou databázi a kontejner, načte položku z kontejneru a deserializuje ji do objektu TodoItem . Tento příklad používá verzi 3.x sady .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"));
}

Prozkoumání klientských rozhraní API

ukázky