Azure Cosmos DB 中的唯一键约束

唯一键向 Azure Cosmos DB 容器添加一层数据完整性。 创建 Azure Cosmos DB 容器时，可以创建唯一密钥策略。 使用唯一键可确保逻辑分区内一个或多个值的唯一性。 此外，可以保证每个分区键的唯一性。

使用唯一键策略创建容器后，按照唯一键约束的指定，将阻止创建新项或更新现有项以避免逻辑分区内出现重复。 分区键与唯一键的组合可保证某个项在容器范围内的唯一性。

例如，假设Azure Cosmos DB 容器，Email address作为唯一键约束，CompanyID作为分区键。 将用户的电子邮件地址配置为唯一键后，每个项将在给定的 CompanyID 中获得唯一的电子邮件地址。 无法创建具有重复电子邮件地址和相同分区键值的两个项。 在 Azure Cosmos DB 的 NoSQL API 中，项存储为 JSON 值。 这些 JSON 值区分大小写。 选择某个属性作为唯一键时，可以为该属性插入区分大小写的值。 例如，如果在 name 属性上定义了唯一键， 则 Gaby 不同于 gaby ，并且可以将两者插入到容器中。

若要创建具有相同电子邮件地址但不是相同名字、姓氏和电子邮件地址的项，请将其他路径添加到唯一键策略。 还可以使用名字、姓氏和电子邮件的组合创建唯一键，而不是仅根据电子邮件地址创建唯一键。 此键称为复合唯一键。 在这种情况下，给定的 CompanyID 中允许这三个值的每种唯一组合。

例如，容器可以包含具有以下值的项，其中每个项遵循唯一键约束。

如果你尝试使用上表中列出的组合插入另一个项，则会收到错误。 该错误指示未满足唯一键约束。 你会收到 Resource with specified ID or name already exists 或 Resource with specified ID, name, or unique index already exists 作为返回消息。

定义唯一键

仅当创建 Azure Cosmos DB 容器时，才能定义唯一键。 唯一键的范围限定为逻辑分区。 在前面的示例中，如果基于邮政编码将容器分区，则每个逻辑分区中可能会出现相同项。 创建唯一键时请考虑以下属性：

• 不能将现有容器更新为使用不同的唯一键。 换而言之，使用唯一键策略创建容器后，无法更改策略。

• 若要为现有容器设置唯一键，请使用唯一键约束创建新容器。 使用适当的数据迁移工具将数据从现有容器移到新容器。 对于 SQL 容器，请使用容器复制任务移动数据。 对于 MongoDB 容器，请使用 mongoimport.exe 或 mongorestore.exe 移动数据。

• 一个唯一键策略最多可以包含 16 个路径值。 例如，值可以是 /firstName、/lastName 和 /address/zipCode。 每个唯一键策略可以具有最多 10 个唯一键约束或组合。 在前面的示例中，名字、姓氏和电子邮件地址共同构成了一个约束。 此约束使用 16 个可能路径中的 3 个。

• 如果容器具有唯一键策略，则创建、更新和删除项时产生的请求单位 (RU) 费用要略高一些。

• 不支持稀疏唯一键。 如果缺少某些唯一路径值，这些值将被视为 null 值，并参与唯一性约束。 因此，若要符合此约束，只能有一个项为 null 值。

• 唯一键名称区分大小写。 例如，假设某个容器的唯一键约束设置为 /address/zipcode。 如果数据具有名为 ZipCode 的字段，Azure Cosmos DB 将插入 null作为唯一键，因为 zipcode 与 ZipCode 不同。 由于区分大小写的原因，无法插入具有 ZipCode 的其他记录，因为重复的 null 违反了唯一键限制。

后续步骤

• Cosmos DB Azure 中的分区和水平缩放
• 定义 Azure Cosmos DB 容器的唯一键
• 尝试为迁移到 Azure Cosmos DB 做容量规划？ 可以使用有关现有数据库群集的信息进行容量规划。
  • 如果只知道现有数据库群集中的 vCore 和服务器数量，请阅读使用 vCore 或 vCPU 估算请求单位
  • 如果您知道当前数据库工作负荷的典型请求速率，请阅读有关使用 Azure Cosmos DB 容量规划工具来估计请求单位的文章