Supprimer des runs

Supprimez des runs d’un projet avec W&B App ou l’API Python.

W&B App
Python

Accédez au projet qui contient les runs que vous souhaitez supprimer.
Sélectionnez l’onglet Runs.
Cochez la case à côté des runs que vous souhaitez supprimer.
Cliquez sur le bouton Supprimer (icône de corbeille) au-dessus du tableau.
Dans le volet latéral qui s’affiche, choisissez Supprimer.

Pour les projets qui contiennent un grand nombre de runs, vous pouvez utiliser soit la barre de recherche pour filtrer les runs que vous souhaitez supprimer à l’aide d’expressions régulières, soit le bouton de filtre pour filtrer les runs en fonction de leur statut, de leurs tags ou d’autres propriétés.

Utilisez l’API publique de W&B pour supprimer des runs par programmation. Les opérations de suppression peuvent porter sur un seul run ou sur plusieurs runs à la fois.Utilisez wandb.Api.Run.delete() pour supprimer un seul run. Indiquez le chemin du run au format entity/project/runID.

import wandb

api = wandb.Api()

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

Utilisez wandb.Api.runs() pour récupérer plusieurs runs d’un projet, puis supprimez chaque run. L’exemple suivant supprime tous les runs d’un projet :

import wandb

api = wandb.Api()

entity = "entity"
project = "project"

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

for run in runs:
    run.delete()

Vous pouvez utiliser des filtres pour ne supprimer que les runs correspondant à des critères précis, comme leur date de création, leurs tags ou d’autres métadonnées. L’exemple suivant prévisualise puis supprime les runs créés avant un horodatage UTC donné :

import wandb

api = wandb.Api()

entity = "entity"
project = "project"
cutoff = "2024-01-01T00:00:00Z"  # supprime les runs créés avant cet horodatage UTC

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

# Simulation à blanc d'abord
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()  # ou run.delete(delete_artifacts=True)

Pour supprimer des fichiers individuels attachés à un run, comme des médias enregistrés :

Obtenez les références de fichier pertinentes avec wandb.Api.Run.files().
Utilisez File.delete() pour supprimer des fichiers individuels.

L’ID d’un run ne peut pas être réutilisé, même après la suppression du run. Toute tentative de réutilisation échouera avec une erreur.

Lorsque vous supprimez un run et choisissez de supprimer les artefacts associés, ces artefacts sont définitivement supprimés et ne peuvent pas être récupérés, même si le run est restauré ultérieurement. Cela inclut les artefacts liés au Registry.

Organigramme de suppression d’un run

Le diagramme suivant illustre l’ensemble du processus de suppression d’un run, y compris la gestion des artefacts associés et des liens vers le Registry :

Quand les données de run supprimées sont effacées du stockage

Sur Cloud dédié de W&B et W&B Autogéré, la variable d’environnement GORILLA_DATA_RETENTION_PERIOD contrôle la durée pendant laquelle les données de run supprimées sont conservées avant de pouvoir être supprimées définitivement du stockage d’objets. Les artefacts ne sont pas supprimés par ce paramètre ; ils suivent le processus de suppression des artefacts et de garbage collection décrit dans Supprimer un artefact. Définir ou modifier GORILLA_DATA_RETENTION_PERIOD est irréversible pour les données déjà hors de la fenêtre de rétention. Sauvegardez votre base de données et votre bucket avant d’activer la rétention ou d’en réduire la durée. Voir Configurer les variables d’environnement pour le tableau de référence et les avertissements. Même après la suppression de runs ou de fichiers et le traitement de la rétention, l’utilisation du bucket peut mettre du temps à baisser pendant que les tâches en arrière-plan rattrapent leur retard. W&B ne garantit pas la récupération immédiate du stockage d’objets. Pour un aperçu complet des différences entre les artefacts et les données de run, des délais à prévoir et des actions facultatives pour l’opérateur, voir Gérer le stockage du bucket et les coûts.

Si les suppressions n’apparaissent pas comme prévu dans la W&B App lors de l’utilisation de l’API publique, mettez à niveau le SDK Python W&B vers une version récente, puis réessayez.

Guides

Intégrations

Référence

Supprimer des runs