データの一括削除

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

[一括削除] 機能を使用すると、データ品質を維持し、必要なくなったデータを削除して Microsoft Dataverse のシステム ストレージ消費を管理するために役立ちます。 たとえば、次のデータを一括で削除できます。

• 古いデータ。

• 業務に無関係なデータ。

• 不要なテスト データやサンプル データ。

• 他のシステムから誤ってインポートされたデータ。

一括削除を使用して、以下の操作を実行できます:

• 複数のテーブルにまたがるデータを削除する。

• 特定のテーブルのレコードを削除する。

• 一括削除の完了時に、電子メールで通知を受信します。

• データを定期的に削除する。

• 定期的な一括削除の開始時間をスケジュールする。

• 一括削除の間に発生した失敗に関する情報を取得する。

一括削除の実行

大量のデータを削除するには、BulkDeleteRequest メッセージを使用して一括削除ジョブを送信する必要があります。 一括削除ジョブはバックグラウンドで非同期的に実行されるので他の活動を中断することはありません。 一括削除ジョブを実行するレコードを記述するクエリ式は、この要求の QuerySet プロパティで指定されます。

一括削除ジョブは、一括削除操作テーブルによって表されます。 このテーブルのスキーマ名は BulkDeleteOperation です。 一括削除操作レコードには次の情報が含まれています。

• 一括削除ジョブで削除したレコードの数。

• 一括削除ジョブで削除できなかったレコードの数。

• 一括削除ジョブが定期的なジョブかどうか。

• 一括削除ジョブの開始時刻。

  一括削除ジョブは、ジョブの実行開始前に作成されたレコードのみを削除します。

注意

一括削除ジョブが失敗するか途中で終了した場合、ジョブが失敗する前または終了する前に削除されたレコードはロールバックされず、削除されたままとなります。 BulkDeleteOperation の失敗は BulkDeleteFailure レコードに保存され、RetrieveRequest メッセージまたは RetrieveMultipleRequest メッセージを使用して取得できます。

一括削除ジョブは、伝播規則に従って特定のレコードを削除します。 これらの規則は、テーブル間の関連付けの種類に基づいています。 詳細については、テーブルの関連付け動作 を参照してください。

一括削除ジョブを実行するには、削除するテーブルの種類に対する BulkDelete および Delete 権限が必要です。 また、BulkDeleteRequest メッセージで指定されているテーブル レコードに対する読み取りアクセス許可も必要です。 既定では、システム管理者には必要なアクセス許可が与えられていますが、他のユーザーにはこれらのアクセス許可を与える必要があります。

一括削除は、削除アクションでサポートされているすべてのテーブルに対して実行できます。 テーブル レコードに使用可能なアクションについては、テーブル レコードのアクション を参照してください。

特定のテーブルタイプの削除アクションによってプラグインやワークフロー (プロセス) がトリガーされた場合、一括削除ジョブにより、このタイプのテーブル レコードが削除されるたびにトリガーされます。

サンプル

一括削除機能については次の組織サービス サンプルを参照してください:

• サンプル: エクスポート済みレコードの一括削除
• サンプル: 共通の条件に合致するレコードを一括して削除する

関連項目

BulkDeleteOperation テーブル

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。