適用於 .NET 的 Azure Cosmos DB 程式庫

  • 發行項

概觀

Azure Cosmos DB 是全域散發的多模型資料庫服務。 此服務的設計目的，是可透過全方位的 SLA，以有彈性且獨立的方式調整地理區域 (數量不限) 的輸送量及儲存空間。 透過 Azure Cosmos DB，您可以使用 API 和程式設計模型來儲存並存取文件、索引鍵/值組、寬列資料行以及圖形資料庫。

開始使用 Azure Cosmos DB。

用戶端程式庫

您可以使用 Azure Cosmos DB .NET 用戶端程式庫來存取，並在現有的 Azure Cosmos DB 資料存放區中儲存資料。 請使用 Azure 入口網站、CLI 或 PowerShell，自動建立新的 Azure Cosmos DB 帳戶。

直接從 Visual Studio 套件管理員主控台安裝 NuGet 套件，或使用 .NET Core CLI。

若要安裝以 .NET 標準為目標的 3.x 版：

Visual Studio 套件管理員

Install-Package Microsoft.Azure.Cosmos

.NET Core CLI

dotnet add package Microsoft.Azure.Cosmos

程式碼範例

此範例會連線至現有的 Azure Cosmos DB SQL API 資料庫、建立新資料庫和容器、從容器中讀取項目並將其還原序列化至 TodoItem 物件。 此範例使用 .NET SDK 的 3.x 版本。

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

探索用戶端 API

範例