Microsoft Azure – 在 CosmoDB 中使用 C#

简介

Azure Cosmos DB 是一个全球分布式多模型数据库服务，可以为多个文档、图形、列族和键/值数据提供 准确 api 和查询模式。Azure Cosmos DB 可以轻松实现全球分布、多模型支持和性能水平。

在本文中，我们将学习如何使用 C# 连接和操作 Azure Cosmos DB 数据库。

步骤

1.创建 Azure Cosmos DB 数据库

使用 Azure 门户创建 Azure Cosmos DB 帐户并创建数据库和容器资源。请按照以下步骤操作：

1. 登录 Azure 门户。
2. 单击“创建资源”选项卡。
3. 在“市场”中搜索“Azure Cosmos DB”。
4. 单击“创建”按钮。
5. 在“基本”选项卡中，输入帐户名称、资源组和位置。此外，选择“SQL”为 API 类型。
6. 在“高级”选项卡中，选择“多地理区域分布”。
7. 单击“创建”按钮即可完成 Azure Cosmos DB 帐户创建。

2.编写 C# 程序

使用 Visual Studio 或其他编辑器打开 C# 项目。使用以下代码片段连接至 Azure Cosmos DB：

using Microsoft.Azure.Documents;
using Microsoft.Azure.Documents.Client;

public static async Task<DocumentClient> GetCosmosClientAsync()
{
    string endpointUrl = ConfigurationManager.AppSettings["CosmosDbEndpointUrl"];
    string primaryKey = ConfigurationManager.AppSettings["CosmosDbPrimaryKey"];

    DocumentClient documentClient = new DocumentClient(new Uri(endpointUrl), primaryKey);
    await documentClient.OpenAsync();

    return documentClient;
}

在上面的代码片段中，我们连接 Azure Cosmos DB 终结点并使用主密钥进行身份验证。我们使用 AppSettings.json 文件存储终结点 URL 和主密钥。

接下来，我们可以使用以下代码片段向 Azure Cosmos DB 插入数据：

public static async Task AddDataAsync<T>(T data, string databaseId, string collectionId)
{
    DocumentClient documentClient = await GetCosmosClientAsync();

    await documentClient.CreateDocumentAsync(UriFactory.CreateDocumentCollectionUri(databaseId, collectionId), data);
}

3.运行应用程序

使用 Visual Studio 运行应用程序并检查 Azure Cosmos DB 数据库中是否存在插入的数据。

结论

使用 C# 完成 Azure Cosmos DB 的连接和操作是一项内在且实用的任务，有助于提高分布式数据库的性能。涵盖本文的主题，只是 Azure Cosmos DB 的冰山一角，Azure Cosmos DB 还有很多其他功能和 API 供我们探索。