ドキュメントの削除
ドキュメントの削除は、項目を読み取る処理と似ています。 パーティション キー パスの ID と値が必要です。
string id = "027D0B9A-F9D9-4C96-8213-C8546C4AAE71";
string categoryId = "26C74104-40BC-4541-8EF5-9892F7F03D72";
PartitionKey partitionKey = new (categoryId);
これらの両方の値を取得したら、ReadItemAsync<> メソッドと同様の方法で、非同期 DeleteItemAsync<> メソッドを呼び出します。
await container.DeleteItemAsync<Product>(id, partitionKey);
Azure Cosmos DB では、パーティション キーの 1 つの値に含まれるすべてのドキュメントの削除もサポートされます。
string categoryId = "26C74104-40BC-4541-8EF5-9892F7F03D72";
PartitionKey partitionKey = new (categoryId);
パーティション キーの値を使用して、非同期 DeleteAllItemsByPartitionKeyStreamAsync<> メソッドを呼び出します。
await container.DeleteAllItemsByPartitionKeyStreamAsync<(partitionKey);
パーティション キーによる削除機能は、Cosmos SDK を使用して同じ論理パーティション キー値を持つすべてのドキュメントを削除できるようにする、非同期のバックグラウンド操作です。 パーティション キー 操作による削除は、毎秒コンテナーで使用可能な RU/秒の合計の最大 10% までしか消費できないように制限されています。 これは、このバックグラウンド タスクで使用されるリソースを制限するのに役立ちます。
注
パーティション キー操作によるすべての項目の削除は既定で無効になっており、Azure サポートによる特別なアクティブ化が必要です。
item_id = "027D0B9A-F9D9-4C96-8213-C8546C4AAE71"
partition_key_value = "26C74104-40BC-4541-8EF5-9892F7F03D72"
これらの値を取得したら、 read_item メソッドと同様の方法で delete_item メソッドを呼び出します。
container.delete_item(item=item_id, partition_key=partition_key_value)
Azure Cosmos DB では、パーティション キーの 1 つの値に含まれるすべての項目の削除もサポートされています。
パーティション キーの値を変数に格納します。
partition_key_value = "26C74104-40BC-4541-8EF5-9892F7F03D72"
パーティション キーの値を使用して、 delete_all_items_by_partition_key メソッドを呼び出します。
container.delete_all_items_by_partition_key(partition_key=partition_key_value)
パーティション キーによる削除機能は、Cosmos SDK を使用して同じ論理パーティション キー値を持つすべてのドキュメントを削除できるようにする、非同期のバックグラウンド操作です。 パーティション キー 操作による削除は、毎秒コンテナーで使用可能な RU/秒の合計の最大 10% までしか消費できないように制限されています。 これは、このバックグラウンド タスクで使用されるリソースを制限するのに役立ちます。
注
パーティション キー操作によるすべての項目の削除は既定で無効になっており、Azure サポートによる特別なアクティブ化が必要です。
const itemId = "027D0B9A-F9D9-4C96-8213-C8546C4AAE71";
const partitionKeyValue = "26C74104-40BC-4541-8EF5-9892F7F03D72";
これらの値を取得したら、read メソッドと同様の方法で delete メソッドを呼び出します。
await container.item(itemId, partitionKeyValue).delete();