run を削除する

W&B アプリまたは Python API を使用して project から run を削除します。

W&B アプリ
Python

削除する run が含まれる project にアクセスします。
Runs タブを選択します。
削除する run の横にあるチェックボックスを選択します。
表の上にある Delete ボタン (ごみ箱アイコン) を選択します。
表示されるドロワーで Delete を選択します。

大量の run を含む project では、検索バーで正規表現を使用して削除する run を絞り込むか、フィルターボタンでステータス、タグ、その他のプロパティに基づいて run をフィルターできます。

W&B Public API を使用すると、プログラムで run を削除できます。削除は単一の run に対しても、複数の run に対して一括でも実行できます。単一の run を削除するには、wandb.Api.Run.delete() を使用します。run パスは entity/project/runID の形式で指定します。

import wandb

api = wandb.Api()

run_path = "entity/project/runID"
run = api.run(path=run_path)
run.delete()

wandb.Api.runs() を使用して project から複数の run を取得し、各 run を削除します。次の例では、project 内のすべての run を削除します。

import wandb

api = wandb.Api()

entity = "entity"
project = "project"

runs = api.runs(
    path=f"{entity}/{project}")

for run in runs:
    run.delete()

フィルターを使用すると、作成日、タグ、その他のメタデータなど、特定の条件に一致する run のみを削除できます。次の例では、指定した UTC タイムスタンプより前に作成された run をプレビューしてから削除します。

import wandb

api = wandb.Api()

entity = "entity"
project = "project"
cutoff = "2024-01-01T00:00:00Z"  # この UTC タイムスタンプより前に作成された run を削除します

runs = api.runs(
    path=f"{entity}/{project}",
    filters={"createdAt": {"$lt": cutoff}},
    order="+created_at",
)

# 最初に dry run を実行します
runs_to_delete = list(runs)
print(f"Found {len(runs_to_delete)} runs to delete:")
for run in runs_to_delete:
    print(run.id, run.name, run.created_at)

confirm = input("Type DELETE to permanently delete these runs: ")
if confirm == "DELETE":
    for run in runs_to_delete:
        print(f"Deleting {run.path}")
        run.delete()  # or run.delete(delete_artifacts=True)

ログしたメディアなど、run に関連付けられた個々のファイルを削除するには、次の手順を実行します。

wandb.Api.Run.files() を使用して、対象の file ハンドルを取得します。
File.delete() を使用して、個々のファイルを削除します。

run ID は、run を削除した後も再利用できません。再利用しようとすると、run はエラーで失敗します。

run の削除時に関連するアーティファクトも削除することを選択した場合、アーティファクトは完全に削除され、後で run をリストアしても復元できません。Registry にリンクされたアーティファクトも対象となります。

run 削除のフローチャート

次の図は、関連するアーティファクトと Registry リンクの処理を含む、run 削除のプロセス全体を示しています。

削除した run データがストレージから除去されるタイミング

W&B 専用クラウドと W&B Self-Managed では、環境変数 GORILLA_DATA_RETENTION_PERIOD によって、削除した run データをオブジェクトストレージから完全に除去できるようになるまでの保持期間を制御します。この設定ではアーティファクトは除去されません。アーティファクトは、アーティファクトを削除するで説明されているアーティファクトの削除とガベージコレクションの流れに従います。 GORILLA_DATA_RETENTION_PERIOD の設定や変更によって、保持期間を過ぎたデータが削除されると、元に戻すことはできません。保持期間を有効にしたり短縮したりする前に、データベースとバケットをバックアップしてください。リファレンス表と警告については、環境変数を設定するを参照してください。 run やファイルの削除と保持期間に基づく処理が完了した後も、バックグラウンドジョブの処理が追いつくまで、バケットの使用量への反映が遅れる場合があります。W&B は、オブジェクトストレージの容量が即座に解放されることを保証しません。アーティファクトと run データの違い、処理にかかる時間の目安、オペレーターが必要に応じて行える操作の概要については、バケットのストレージとコストを管理するを参照してください。

Public API を使用した削除が W&B アプリに想定どおり反映されない場合は、W&B Python SDK を最新リリースにアップグレードして再試行してください。