What the Shard? 使用 MongoDB .NET Driver 分区 Azure Cosmos DB

Jeremy Likness

4.33/5 (2投票s)

2018 年 8 月 3 日

CPOL

4分钟阅读

14634

了解如何使用 C# MongoDB 驱动程序与 Azure Cosmos DB 对集合进行分区

引言

Azure Cosmos DB 是一个完全托管的 NoSQL 数据库。我在这篇博客上对其进行了广泛的介绍。一个高级且强大的功能是数据分区能力。这通常被称为分片。如果您遵循这些分区先决条件，Azure Cosmos DB 会为您处理此问题。

由于文档中已对此进行了充分的解释，我在这里不会过多介绍分区。简而言之，逻辑分区是分组在一起的项的范围。这由文档上的一个属性决定，该属性可以是哈希值或指定为范围。从逻辑上讲，具有相同分区键的项会放在一起。从物理上讲，一个节点可以存储一个或多个分区或分片。Azure Cosmos DB 会根据需求透明地为您处理此问题。

在此处阅读有关分区的全部知识：Azure Cosmos DB 中的分区和缩放

分区键有助于缩放，尤其是在数据库地理分布时。这是因为当插入或更新项时，复制可以专注于特定分区而不是整个数据库。通过将分区与这些读取进行共置，也可以优化读取。通过设置特定的一致性级别可以优化复制行为。

尽管文档讨论了分区如何在各种 API 中工作（有关可用数据库“风味”和不同 API 的概述，请阅读这篇Azure Cosmos DB API 概述），但没有明确的示例说明如何通过代码设置分区键。

我从我现有的USDA 数据库示例开始。其中包含近 9000 种食品项，它们被分配到特定的“食品组”。选择分区键有很多最佳实践。为了使此示例保持简单，我选择按 FoodGroupId 属性进行分区。

在 MongoDB 中创建集合的代码如下所示

await db.CreateCollectionAsync(collectionName);

要指定分区键，我们必须创建一个分片集合。这是通过向数据库发送命令来完成的。MongoDB 命令和查询都是 JSON 文档，因此我们可以使用驱动程序的 BsonDocument 类来构造命令。这是创建分片集合的命令

var partition = new BsonDocument {
    {"shardCollection", $"{db.DatabaseNamespace.DatabaseName}.{collectionName}"},
    {"key", new BsonDocument {{"FoodGroupId", "hashed"}}}
};
var command = new BsonDocumentCommand<BsonDocument>(partition);
await db.RunCommandAsync(command);

集合名称作为完全限定的数据库和集合名称传递，后跟分片键，该键指向 FoodGroupId 的哈希值。文档用于构造命令，然后将其传递给数据库。

插入数据后，您可以在门户中查看跨分区键的存储分布。