Supprimer des runs

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

W&B App
Python

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

Pour les projets qui contiennent un grand nombre de runs, vous pouvez filtrer les runs à supprimer à l’aide d’une expression régulière dans la barre de recherche, ou utiliser le bouton de filtre pour les filtrer selon leur statut, leurs tags ou d’autres propriétés.

Utilisez l’API publique de W&B pour supprimer des runs par programmation. Vous pouvez supprimer un seul run ou 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-les un par un. 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 qui répondent à 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"  # supprimer les runs créés avant cet horodatage UTC

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

# Effectuer d’abord une simulation à blanc
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 certains fichiers joints à un run, comme des médias journalisés :

Obtenez les descripteurs des fichiers concernés avec wandb.Api.Run.files().
Utilisez File.delete() pour supprimer chaque fichier.

Un ID de run ne peut pas être réutilisé, même après la suppression du run : toute tentative fera échouer le run avec une erreur.

Lorsque vous supprimez un run en choisissant de supprimer également les artifacts associés, ceux-ci sont définitivement supprimés et ne peuvent pas être récupérés, même si le run est restauré par la suite. Cela inclut les artifacts liés au registre.

Organigramme de suppression d’un run

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

Quand les données de runs supprimés sont effacées du stockage

Sur le Cloud dédié de W&B et sur W&B autogéré, la variable d’environnement GORILLA_DATA_RETENTION_PERIOD détermine la durée de conservation des données de runs supprimés avant qu’elles puissent être définitivement effacées du stockage d’objets. Les artifacts ne sont pas concernés par ce paramètre ; ils suivent le processus de suppression des artifacts et de garbage collection décrit dans Supprimer un artifact. La définition ou la modification de GORILLA_DATA_RETENTION_PERIOD est irréversible pour les données situées au-delà 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 raccourcir la durée. Consultez Configurer les variables d’environnement pour le tableau de référence et les avertissements. Même après la suppression d’un run ou d’un fichier et le traitement de la rétention, l’espace occupé dans le bucket peut mettre du temps à diminuer, le temps que les tâches en arrière-plan rattrapent leur retard. W&B ne garantit pas la libération immédiate de l’espace de stockage d’objets. Pour un aperçu complet de la distinction entre artifacts et données de runs, des délais à prévoir et des actions facultatives côté opérateur, consultez Gérer le stockage et les coûts des buckets.

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