アーティファクトを削除する

アーティファクトは、W&B アプリを使用してインタラクティブに削除することも、W&B Python SDK を使用してプログラムで削除することもできます。アーティファクトを削除すると、W&B はそのアーティファクトを 論理削除 の状態にします。つまり、アーティファクトには削除対象のマークが付けられますが、ファイルはすぐにはストレージから削除されません。アーティファクトの内容は、定期的に実行されるガベージコレクションのプロセスが削除対象のアーティファクトをすべて確認するまで、論理削除 (削除保留中) の状態のまま残ります。ガベージコレクションのプロセスは、アーティファクトとその関連ファイルが前後どちらのアーティファクトのバージョンでも使用されていない場合に、関連ファイルをストレージから削除します。

ガベージコレクションは ベストエフォート で実行されます。アーティファクトの削除後、解放された容量がオブジェクトストレージにどれくらいの速さで反映されるかについて、W&B は保証しません。大規模なデプロイメントや処理の滞留がある場合は、想定以上に時間がかかることがあります。run データや保持設定との関係、および任意で実行できるオペレーターの action については、バケットストレージとコストを管理するを参照してください。

アーティファクトのガベージコレクションのワークフロー

次の図は、アーティファクトのガベージコレクションプロセスの全体像を示しています。 TTL ポリシーを使用すると、W&B からアーティファクトを削除するタイミングをスケジュールできます。詳細については、Artifact TTL ポリシーでデータ保持を管理するを参照してください。

TTL ポリシー、W&B Python SDK、または W&B アプリによって削除されたアーティファクトは、まず論理削除されます。論理削除されたアーティファクトは、その後ガベージコレクションを経て完全に削除されます。

entity、project、またはアーティファクトコレクションを削除すると、このページで説明するアーティファクトの削除プロセスが開始されます。run を削除する際に関連するアーティファクトも削除するよう選択した場合、それらのアーティファクトにも同じ論理削除とガベージコレクションのワークフローが適用されます。

アーティファクトのバージョンを削除する

アーティファクトのバージョンは、W&B アプリを使用してインタラクティブに削除することも、W&B Python SDK を使用してプログラムで削除することもできます。

W&B アプリ
W&B Python SDK

アーティファクトのバージョンを削除するには、次の手順を実行します。

削除するアーティファクトのバージョンが含まれている project にアクセスします。
Artifacts タブを選択します。
アーティファクトタイプの一覧から、削除するバージョンが含まれているアーティファクトのタイプを選択します。
削除するアーティファクトのバージョンの横にある action () メニューをクリックします。
ドロップダウンから Delete Version を選択します。

wandb.Artifact.delete() メソッドを使用すると、アーティファクトのバージョンをプログラムで削除できます。アーティファクトの完全名を指定してください。完全名の形式は <entity>/<project>/<artifact_name>:<version> です。アーティファクトに 1 つ以上のエイリアスが関連付けられている場合でも削除するには、delete_aliases パラメーターを True に設定します。

import wandb

api = wandb.Api()

# パスを指定してアーティファクトを取得する
artifact = api.artifact("<entity>/<project>/<artifact_name>:<version>")

# エイリアスも含めてアーティファクトのバージョンを削除する
artifact.delete(delete_aliases=True)

複数のアーティファクトのバージョンを削除する

次のコード例は、複数のアーティファクトのバージョンを削除する方法を示しています。アーティファクトを作成した run の entity、プロジェクト名、run ID を wandb.Api.run() の引数として指定します。これにより Run オブジェクトが返され、その run で作成されたすべてのアーティファクトのバージョンにアクセスできるようになります。次に、アーティファクトのバージョンを順に処理し、条件に一致するものを削除します。

アーティファクトのバージョンと、それに関連付けられたすべてのエイリアスを削除するには、delete_aliases パラメーターを True に設定します (wandb.Artifact.delete(delete_aliases=True)) 。

<entity>、<project>、<run_id>、<artifact_name> の各プレースホルダーを実際の値に置き換えてください。

import wandb

# W&B API を初期化します
api = wandb.Api()

# パスを指定して run を取得します。パスの形式は <entity>/<project>/<run_id> です
run = api.run("<entity>/<project>/<run_id>")

# バージョンを削除する対象のアーティファクト名を指定します
artifact_name = "<artifact_name>"

# 指定した名前のアーティファクトのバージョンを検索して削除します
for artifact in run.logged_artifacts():
    print(f"Found artifact: {artifact.name}") # 名前の例: run_4dfbufgq_model:v0
    # split() を使用して、バージョンを除いたアーティファクト名のみを取り出します
    if artifact.name.split(":")[0] == artifact_name:
        print(f"Deleting artifact version: {artifact.name}")
        artifact.delete(delete_aliases=True)

特定のエイリアスが付いた複数のアーティファクトのバージョンを削除する

次のコードは、特定のエイリアスが付いた複数のアーティファクトのバージョンを削除する方法を示しています。 <entity>、<project>、<run_id>、<artifact_name>、<alias> の各プレースホルダーを実際の値に置き換えてください。

import wandb

# W&B API を初期化します
api = wandb.Api()

# パスを指定して run を取得します。パスの形式は <entity>/<project>/<run_id> です
run = api.run("<entity>/<project>/<run_id>")

# バージョンを削除するアーティファクトの名前を指定します
artifact_name = "<artifact_name>"

# 削除対象のアーティファクトのバージョンを絞り込むためのエイリアスを指定します
desired_alias = "<alias>"

# run にログされたアーティファクトのうち、エイリアス 'v3' と 'v4 を持つものを削除します
for artifact in run.logged_artifacts():
    print(f"Found artifact: {artifact.name}")
    if (artifact.name.split(":")[0] == artifact_name) and (desired_alias in artifact.aliases):
            artifact.delete(delete_aliases=True)

アーティファクトコレクションを削除する

W&B アプリ
W&B Python SDK

アーティファクトコレクションを削除するには、次の手順を実行します。

削除するアーティファクトコレクションにアクセスします。
アーティファクトコレクション名の横にある action () メニューを選択します。
ドロップダウンメニューから Delete を選択します。

wandb.Artifact.delete() メソッドを使用すると、プログラムからアーティファクトコレクションを削除できます。wandb.Api.artifact_collection(name="") にアーティファクトコレクションのフルパスを指定します。フルパスは <entity>/<project>/<artifact_collection_name> の形式です。

import wandb

# W&B API を初期化する
api = wandb.Api()

# パスを指定してアーティファクト コレクションを取得する。パスの形式は
# <entity>/<project>/<artifact_collection_name>
collection = api.artifact_collection(
    type_name = "<artifact_type>",
    name = "<entity>/<project>/<artifact_collection_name>"
)
collection.delete()

保護されたエイリアスと削除権限

保護されたエイリアスが付いたアーティファクトには、特別な削除制限が適用されます。保護されたエイリアスとは、許可のない削除を防ぐために Registry 管理者が設定できる、Registry 内のエイリアスです。

保護されたエイリアスに関する重要な考慮事項:

保護されたエイリアスが付いたアーティファクトは、Registry 管理者以外のユーザーは削除できません。
Registry 内では、Registry 管理者は保護されたアーティファクトのバージョンのリンクを解除したり、保護されたエイリアスを含むコレクションや Registry を削除したりできます。
ソースアーティファクトの場合: ソースアーティファクトが保護されたエイリアス付きで Registry にリンクされていると、どのユーザーも削除できません。
Registry 管理者は、ソースアーティファクトから保護されたエイリアスを外すことで、そのソースアーティファクトを削除できるようになります。

W&B のホスティング方法に応じてガベージコレクションを有効にする

ガベージコレクションの実行タイミングは保証されません。詳細については、バケットストレージとコストを管理するを参照してください。

W&B Multi-tenant Cloud を使用している場合、ガベージコレクションはデフォルトで有効になっています。W&B 専用クラウドおよびセルフマネージドでは、ガベージコレクションを有効化するために、次の追加手順が必要になる場合があります。

W&B セルフマネージド: GORILLA_ARTIFACT_GC_ENABLED=true を設定します。
専用クラウド: サポートに問い合わせて、ガベージコレクションが有効になっているかどうかを確認します。
AWS、Google Cloud、または Minio などのその他のストレージプロバイダーを使用している場合は、バケットのバージョン管理を有効にします。Azure を使用している場合は、バケットのバージョン管理に相当する論理削除を有効にします。

次の表は、デプロイメントタイプごとに、ガベージコレクションを有効にするために満たす必要がある要件を示しています。 X は、その要件を満たす必要があることを示します。

	環境変数	バージョン管理を有効化
Multi-tenant Cloud
Multi-tenant Cloud (BYOB ストレージ使用時)		X
専用クラウド
専用クラウド (BYOB ストレージ使用時)		X
セルフマネージド	X	X

メモセキュアストレージコネクタは現在、Google Cloud Platform と Amazon Web Services でのみ利用できます。

​アーティファクトのガベージコレクションのワークフロー

​アーティファクトのバージョンを削除する

​複数のアーティファクトのバージョンを削除する

​特定のエイリアスが付いた複数のアーティファクトのバージョンを削除する

​アーティファクト コレクションを削除する

​保護されたエイリアスと削除権限

​W&B のホスティング方法に応じてガベージコレクションを有効にする

アーティファクトのガベージコレクションのワークフロー

アーティファクトのバージョンを削除する

複数のアーティファクトのバージョンを削除する

特定のエイリアスが付いた複数のアーティファクトのバージョンを削除する

アーティファクトコレクションを削除する

保護されたエイリアスと削除権限

W&B のホスティング方法に応じてガベージコレクションを有効にする