按分区键值 - API for NoSQL（预览版）删除项

适用范围： NoSQL

本文介绍如何使用 Azure Cosmos DB SDK 按逻辑分区键值删除所有项。

按分区键删除功能是一项异步后台操作，它允许你使用 Cosmos SDK 删除具有相同逻辑分区键值的所有文档。

因为要删除的文档数量可能很大，该操作在后台运行。 虽然物理删除操作在后台运行，但效果会立即显现，因为要删除的文档不会显示在查询或读取操作的结果中。

按分区键删除操作的目标是在最大努力原则上，为每秒最多消耗容器中可用 RU/s 总数的 10%。 这有助于限制此后台任务使用的资源。

更新 Azure Cosmos DB 帐户，以使用 Azure CLI 启用“按分区键删除”功能。

• 步骤 1：设置 shell 变量

      $resourceGroupName = <azure_resource_group>
      $accountName = <azure_cosmos_db_account_name>
      $DeleteByPk = "DeleteAllItemsByPartitionKey"
  

• 步骤 2：列出帐户的现有功能。

     $cosmosdb = az cosmosdb show \
      --resource-group $resourceGroupName \
      --name $accountName
     $capabilities = ($cosmosdb | ConvertFrom-Json).capabilities 
  

• 步骤 3：在功能列表中添加“按分区键删除项”功能（如果尚不存在）。

  注意

  功能列表必须始终一个不漏地指定要启用的所有功能。 这包括已启用并希望保留的帐户的功能。

     $capabilities = $DeleteByPk
  

• 步骤 4：更新 Cosmos DB 帐户，以启用“按分区键删除项”功能。

      az cosmosdb update --capabilities $capabilities \
       -n $accountName -g $resourceGroupName
  

// Suppose our container is partitioned by tenantId, and we want to delete all the data for a particular tenant Contoso

// Get reference to the container
var container = cosmosClient.GetContainer("DatabaseName", "ContainerName");

// Delete by logical partition key
ResponseMessage deleteResponse = await container.DeleteAllItemsByPartitionKeyStreamAsync(new PartitionKey("Contoso"));

 if (deleteResponse.IsSuccessStatusCode) {
    Console.WriteLine($"Delete all documents with partition key operation has successfully started");
}

// Suppose our container is partitioned by tenantId, and we want to delete all the data for a particular tenant Contoso

// Delete by logical partition key
CosmosItemResponse<?> deleteResponse = container.deleteAllItemsByPartitionKey(
            new PartitionKey("Contoso"), new CosmosItemRequestOptions()).block();

# Suppose our container is partitioned by tenantId, and we want to delete all the data for a particular tenant Contoso

# Delete by logical partition key
container.delete_all_items_by_partition_key("Contoso")

是的，一旦按分区键删除操作开始，要删除的文档就不会显示在查询或读取操作的结果中。 这也意味着，你可以使用与要删除的文档相同的 ID 和分区键写入新文档，而不会导致冲突。

有关例外情况，请参阅已知问题。

发出按分区键删除操作后，只会删除容器中在该时间点存在的具有该分区键值的文档。 任何传入的新文档都不在删除范围内。

默认情况下，按分区键值删除操作最多可以消耗保留的一部分资源 - RU/s 总数的 0.1，即 10%。 此桶中未使用的任何请求单位 (RU) 都可用于其他非后台操作，例如读取、写入和查询。

例如，假设你在容器上预配了 1000 RU/秒。 正在进行的按分区键删除操作每秒消耗 100 RU 并持续 5 秒。 在这 5 秒钟内，每秒都有 900 RU 可用于非后台数据库操作。 该删除操作完成后，所有 1000 RU/s 再次可用。

在某些情况下，按分区键操作删除可能无法立即保证其效果，并且操作期间可能会出现仅部分可见。

• 在按分区键删除操作正在进行期间发出的、使用索引的聚合查询（例如 COUNT 查询）可能包含要删除的文档的结果。 这种情况可能发生在删除操作彻底完成之前。
• 在按分区键删除操作正在进行期间对分析存储发出的查询可能包含要删除的文档的结果。 这种情况可能发生在删除操作彻底完成之前。
• 连续备份（时间点还原）- 在按分区键删除操作正在进行期间触发的还原可能包含要在已还原集合中删除的文档的结果。 如果你的方案需要连续备份，建议不要使用此预览功能。

• 将包含问题或反馈的电子邮件发送到 cosmosPkDeleteFeedbk@microsoft.com。

查找支持此功能的最新版 SDK。

计划未来支持其他 SDK。

请参阅以下文章了解 Azure Cosmos DB 中的其他 SDK 操作。

• 查询 Azure Cosmos DB 容器
• 使用 .NET SDK 在 Azure Cosmos DB 中执行事务性批处理操作