CLI を使用して、Communications Mining からデータを一括で削除します。単一のソースまたはバケットから時間範囲ごと、またはデータセット全体から、年齢ベースの保持を使用します。

CLI には、履歴データのクリーンアップや保持ポリシーの適用など、データを一括で削除する 3 つの方法が用意されています。

このセクションでは、 CLI がすでにインストールおよび設定されていることを前提としています。削除元のすべてのプロジェクトに対して、読み取りおよび削除 の権限 が必要です。バックアップから復元するには、コメントとメールをアップロードする権限と、アノテーションを復元するための データセット - 確認 権限が必要です。

コマンドが実行するオプションについては、 re <command> --helpを実行するか、 コマンド リファレンスを参照してください。

コメントを削除または変更する前に、必要に応じて注釈付きコメントをバックアップして、モデルトレーナーの手動作業を誤って失わないようにすることができます。

ソースが複数のデータセットに追加されている場合は、それらのデータセットごとに前述のコマンドを実行する必要があります。

このコマンドは、削除によって削除されたコメントではなく、保持 --include-annotated=false コメントをキャプチャします。これらをキャプチャするには、削除しようとしているのと同じ範囲をエクスポートします。ソースには「バッチ ダウンロード」で説明されているように、--from-timestampと--to-timestampとともにre get commentsを使用し、バケットには以下のようにします。

次のコマンドは、アノテーション済みのコメントを除き、 FROM_TIMESTAMP から TO_TIMESTAMP までのソース内のすべてのコメントを削除します。タイムスタンプは RFC 3339 形式である必要があります (例:1970-01-02T03:04:05Z。

注釈付きのコメントを削除する場合は、 --include-annotated=trueを設定できます。

コメントを削除しても、解析元の未加工のメールは削除されません。

未加工のメール自体を削除するには、バケットを時間範囲で対象にします。

これにより、範囲内のすべてのメールが削除されます。これには、これまで操作していたソース以外のソースに解析されたメールも含まれます。これらのメールからすでに解析されたコメントは削除されません。

代わりに個々のメールを削除するには、一度に最大 32 個の ID を渡します。

re prune 、1 回の実行で 1 つ以上のデータセットに年齢ベースの保持が適用され、以下が削除されます。

カットオフは、暦日の境界ではなく、実行が開始された正確な瞬間です ( --older-than-daysを引いた位置)。

ドライ ランは手順 4 で停止します。実際のバックアップを書き込んで、削除する内容を報告しますが、検証も削除も行いません。

--dry-runから始めます。

カウントが正しいと思われたら、 を --dry-runせずに同じコマンドを実行します。

リストしたデータセットのいずれかでレビューされたコメントは、年齢に関係なく既定で保持されます。自分がアクセスできないデータセット内でのみアノテーションが行われたコメントはカウントされず、削除されます。渡す --include-annotated 古いコメントは、アノテーションが行われているかどうかに関係なく削除できます。上記のモデルのパフォーマンスへの影響を念頭に置いてください。

--mailbox は 、削除 する内容を 1 つのメールボックスから同期されたデータに限定します。これは、バケットが複数のメールボックスを受信し、そのうちの 1 つのメールボックスのみがプルーニングが必要なメールボックスの場合に便利です。メールは、正確なメールボックス名に基づいてフィルター処理されます。コメントは、 Mailbox ID ユーザー プロパティで大文字と小文字を区別せずに照合されます。このプロパティは、送信元の 変換タグ がメールボックス名を記録する場合にのみメールの解析によって設定されます。

--mailbox 、アノテーションのバックアップの範囲を絞り込むことはありません。

実行ごとに の下に新しいフォルダーが作成され --backup-dir、実行が開始された UTC 時刻にちなんで名前が付けられます。re prune 既存のフォルダーを再利用することはありません。

マニフェストには、実行のパラメーター (run_id、 cutoff、 include_annotated、 mailbox、 datasets)、削除セットのサイズ (comment_count、 email_count)、およびすべてのバックアップ ファイルについて、そのファイルがカバーする resource 、バックアップ フォルダーを基準にした file パス、レコード count 、および crc32 チェックサムが記録されます。

復元は手動で、通常の re create コマンドを使用します。バックアップ ファイルには、名前とともに ID ( re get datasets、 re get sources 、および re get buckets リストの ID で名前が付けられます。マニフェストでは、各削除セット ファイルの resource フィールドでカバーするソースまたはバケットが示されます。マニフェスト内の各ファイルの count は、そのファイルが保持するレコードの数であり、復元するレコードと比較して価値があります。

削除したコメントをソースに復元します。

既定のプルーニングでは、リストしたデータセット内のコメントにアノテーションが行われたまま維持されるため、アノテーションは を使用した実行後にのみ --include-annotated。注釈のバックアップから復元します — re create annotations はそのファイルを読み込み、注釈のみをアップロードし、コメント自体は変更しません。

削除したメールをバケットに復元します。

未加工のメールをバケットにアップロードし直すと、そのバケットから読み取ったソースに未加工のメールが解析され、コメントが再作成されます。意図しない限り、同じソースのメールとコメントの両方を復元しないでください。コメントではなくメールを復元した場合は、コメントが再び表示されるまで待ってからアノテーションを復元します。アノテーションはすでに存在するコメントにのみ適用できます。

re create comments と re create emails はアップロードであるため、CLI はそれらに対する AI ユニットの料金に同意するよう求めます。re create annotations は課金されません。

バックアップと復元:

削除スコープと動作