Eliminar documentos

Concluído

A exclusão de um documento é semelhante, no processo, à leitura de um item. Você precisa do id e do valor do caminho da chave de partição.

string id = "027D0B9A-F9D9-4C96-8213-C8546C4AAE71";
string categoryId = "26C74104-40BC-4541-8EF5-9892F7F03D72";
PartitionKey partitionKey = new (categoryId);

Depois de ter esses dois valores, você invoca o método assíncrono DeleteItemAsync de maneira semelhante ao método ReadItemAsync<>.<>

await container.DeleteItemAsync<Product>(id, partitionKey);

O Azure Cosmos DB também dá suporte à exclusão de todos os documentos contidos em um único valor para uma chave de partição.

string categoryId = "26C74104-40BC-4541-8EF5-9892F7F03D72";
PartitionKey partitionKey = new (categoryId);

Com o valor da chave de partição, você invoca o método assíncrono DeleteAllItemsByPartitionKeyStreamAsync<> .

await container.DeleteAllItemsByPartitionKeyStreamAsync<(partitionKey);

O recurso excluir por chave de partição é uma operação assíncrona em segundo plano que permite excluir todos os documentos com o mesmo valor de chave de partição lógica, usando o SDK do Cosmos. A operação de exclusão por chave de partição é restrita a consumir no máximo 10% do total de RU/s disponíveis no contêiner a cada segundo. Isso ajuda a limitar os recursos usados por essa tarefa em segundo plano.

Observação

A operação excluir todos os itens por chave de partição é desabilitada por padrão e requer ativação especial pelo Suporte do Azure.

item_id = "027D0B9A-F9D9-4C96-8213-C8546C4AAE71"
partition_key_value = "26C74104-40BC-4541-8EF5-9892F7F03D72"

Depois de teres esses valores, invocas o método delete_item de maneira semelhante ao método read_item.

container.delete_item(item=item_id, partition_key=partition_key_value)

O Azure Cosmos DB também dá suporte à exclusão de todos os itens contidos em um único valor para uma chave de partição.

Armazene o valor da chave de partição em uma variável:

partition_key_value = "26C74104-40BC-4541-8EF5-9892F7F03D72"

Com o valor da chave de partição, invocas o método delete_all_items_by_partition_key.

container.delete_all_items_by_partition_key(partition_key=partition_key_value)

O recurso excluir por chave de partição é uma operação assíncrona em segundo plano que permite excluir todos os documentos com o mesmo valor de chave de partição lógica, usando o SDK do Cosmos. A operação de exclusão por chave de partição é restrita a consumir no máximo 10% do total de RU/s disponíveis no contêiner a cada segundo. Isso ajuda a limitar os recursos usados por essa tarefa em segundo plano.

Observação

A operação excluir todos os itens por chave de partição é desabilitada por padrão e requer ativação especial pelo Suporte do Azure.

const itemId = "027D0B9A-F9D9-4C96-8213-C8546C4AAE71";
const partitionKeyValue = "26C74104-40BC-4541-8EF5-9892F7F03D72";

Depois de teres esses valores, invoca o método excluir de maneira semelhante ao método ler.

await container.item(itemId, partitionKeyValue).delete();