Trouver des éléments du registre

Trouvez des registres, des collections et des versions d’artifact de manière interactive dans W&B Registry ou par programmation avec le SDK Python W&B. Seuls les éléments que vous êtes autorisé à consulter apparaissent dans les résultats de recherche.

La syntaxe et les opérateurs disponibles pour interroger W&B Registry sont similaires à ceux des requêtes MongoDB, sans toutefois être identiques.

Rechercher des éléments du registre

Utilisez la barre de recherche de la page d’accueil du W&B Registry pour trouver des collections et des registres par nom. Utilisez la recherche avancée pour trouver des registres, des collections ou des versions d’artifact selon des attributs spécifiques tels que le nom, le tag, la description, la date de création, etc.

Recherche de base

Recherchez des registres et des collections sur la page d’accueil du W&B Registry :

Accédez au W&B Registry.
Saisissez un terme à rechercher dans la barre de recherche en haut de la page.
Appuyez sur Entrée pour lancer la recherche.

Recherche avancée

Utilisez la recherche avancée pour trouver des registres, des collections ou des versions d’artifact. Utilisez des filtres pour rechercher des éléments du registre spécifiques en fonction d’attributs tels que le nom, le tag, la description, la date de création, etc.

Accédez à W&B Registry.
Cliquez sur Advanced en haut de la page d’accueil.
Sélectionnez Registries, Collections ou Versions.
Cliquez sur Filters.
De gauche à droite, sélectionnez l’attribut selon lequel vous souhaitez filtrer, l’opérateur, puis la valeur. Vous pouvez ajouter plusieurs filtres pour affiner vos résultats de recherche.
Appuyez sur Entrée pour appliquer le filtre.

Interroger les éléments du registre

Utilisez wandb.Api().registries() ainsi que des prédicats de requête pour filtrer les registres, les collections et les versions d’artifact. Un prédicat de requête est une condition qui précise les critères auxquels les éléments renvoyés doivent satisfaire. Pour créer un prédicat de requête, utilisez un dictionnaire au format JSON composé d’un nom de requête, d’un ou plusieurs opérateurs et de valeurs. L’extrait de code suivant montre la structure générale d’un prédicat de requête :

{
    "query_name": {
        "operator": value
    }
}

Les sections suivantes décrivent les noms de requête disponibles pour le registre, les opérateurs pris en charge et des exemples de requêtes.

Champs pouvant être filtrés

Le tableau suivant répertorie les noms de requête que vous pouvez utiliser selon le type d’élément que vous souhaitez filtrer :

	nom de requête
registres	`name`, `description`, `created_at`, `updated_at`
collections	`name`, `tag`, `description`, `created_at`, `updated_at`
versions	`tag`, `alias`, `created_at`, `updated_at`, `metadata`

Opérateurs pris en charge

W&B prend en charge les opérateurs de comparaison et les opérateurs logiques suivants pour filtrer les éléments du registre :

Opérateurs de comparaison

Opérateur	Description
`$eq`	Égal à
`$ne`	Différent de
`$gt`	Supérieur à
`$gte`	Supérieur ou égal à
`$lt`	Inférieur à
`$lte`	Inférieur ou égal à

Opérateurs logiques

Opérateur	Description
`$and`	Effectue une opération logique AND sur une ou plusieurs conditions
`$or`	Effectue une opération logique OR sur une ou plusieurs conditions
`$nor`	Effectue une opération logique NOR sur une ou plusieurs conditions
`$not`	Effectue une opération logique NOT sur une condition

Autres opérateurs

Opérateur	Description
`$regex`	Correspondance à un motif d’expression régulière
`$exists`	Le champ existe ou n’existe pas
`$contains`	La chaîne contient une valeur

Exemples de requêtes

Les exemples de code suivants illustrent quelques cas courants de recherche. Pour utiliser la méthode wandb.Api().registries(), importez d’abord la bibliothèque du SDK Python W&B (wandb) :

import wandb

# (Facultatif) Créer une instance de la classe wandb.Api() pour plus de lisibilité
api = wandb.Api()

Filtrez tous les registres contenant la chaîne model :

# Filtrez tous les registres contenant la chaîne `model`
registry_filters = {
    "name": {"$regex": "model"}
}

# Renvoie un itérable de tous les registres correspondant aux filtres
registries = api.registries(filter=registry_filters)

Filtrez toutes les collections, quel que soit le registre, dont le nom contient la chaîne yolo :

# Filtrez toutes les collections, quel que soit le registre, 
# dont le nom contient la chaîne `yolo`
collection_filters = {
    "name": {"$regex": "yolo"}
}

# Renvoie un itérable de toutes les collections correspondant aux filtres
collections = api.registries().collections(filter=collection_filters)

Filtrez toutes les collections, quel que soit le registre, qui contiennent la chaîne yolo dans le nom de la collection et portent le tag cnn :

# Filtrez toutes les collections, quel que soit le registre, qui contiennent la
# chaîne `yolo` dans le nom de la collection et portent le tag `cnn`
collection_filters = {
    "name": {"$regex": "yolo"},
    "tag": "cnn"
}

# Renvoie un itérable de toutes les collections correspondant aux filtres
collections = api.registries().collections(filter=collection_filters)

Trouvez toutes les versions d’artifact contenant la chaîne model et ayant soit le tag image-classification, soit l’alias latest :

# Trouvez toutes les versions d'artifact contenant la chaîne `model` et 
# ayant soit le tag `image-classification`, soit l'alias `latest`
registry_filters = {
    "name": {"$regex": "model"}
}

# Utiliser l'opérateur logique $or pour filtrer les versions d'artifact
version_filters = {
    "$or": [
        {"tag": "image-classification"},
        {"alias": "production"}
    ]
}

# Renvoie un itérable de toutes les versions d'artifact correspondant aux filtres
artifacts = api.registries(filter=registry_filters).collections().versions(filter=version_filters)

Chaque élément de l’itérable artifacts dans l’extrait de code précédent est une instance de la classe Artifact. Cela signifie que vous pouvez accéder aux attributs de chaque artifact, tels que name, collection, aliases, tags, created_at, et plus encore :

for art in artifacts:
    print(f"artifact name: {art.name}")
    print(f"collection artifact belongs to: { art.collection.name}")
    print(f"artifact aliases: {art.aliases}")
    print(f"tags attached to artifact: {art.tags}")
    print(f"artifact created at: {art.created_at}\n")

Pour obtenir la liste complète des attributs d’un objet artifact, voir la classe Artifacts dans la documentation de référence de l’API. Filtrez toutes les versions d’artifact, indépendamment du registre ou de la collection, créées entre 2024-01-08 et 2025-03-04 à 13:10 UTC :

# Trouvez toutes les versions d'artifact créées entre 2024-01-08 et 2025-03-04 à 13:10 UTC. 

artifact_filters = {
    "alias": "latest",
    "created_at" : {"$gte": "2024-01-08", "$lte": "2025-03-04 13:10:00"},
}

# Renvoie un itérable de toutes les versions d'artifact correspondant aux filtres
artifacts = api.registries().collections().versions(filter=artifact_filters)

Indiquez la date et l’heure au format YYYY-MM-DD HH:MM:SS pour les requêtes created_at et updated_at. Vous pouvez omettre les heures, les minutes et les secondes si vous souhaitez filtrer uniquement par date.

Guides

Intégrations

Référence

Rechercher des éléments du registre

Recherche de base

Recherche avancée

Interroger les éléments du registre

Champs pouvant être filtrés

Opérateurs pris en charge

Opérateurs de comparaison

Opérateurs logiques

Autres opérateurs

Exemples de requêtes

​Rechercher des éléments du registre

​Recherche de base

​Recherche avancée

​Interroger les éléments du registre

​Champs pouvant être filtrés

​Opérateurs pris en charge

​Opérateurs de comparaison

​Opérateurs logiques

​Autres opérateurs

​Exemples de requêtes

Rechercher des éléments du registre

Recherche de base

Recherche avancée

Interroger les éléments du registre

Champs pouvant être filtrés

Opérateurs pris en charge

Opérateurs de comparaison

Opérateurs logiques

Autres opérateurs

Exemples de requêtes