Trouver des éléments du registre

Découvrez comment rechercher des registres, des collections et des versions d’artifact dans W&B Registry à l’aide de la barre de recherche globale ou de requêtes.

Utilisez la barre de recherche globale dans W&B Registry pour trouver un registre, une collection, un tag de version d’artifact, un tag de collection ou un alias. Vous pouvez utiliser des requêtes pour filtrer les registres, les collections et les versions d’artifact selon des critères spécifiques via le W&B Python SDK.

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

Seuls les éléments que vous êtes autorisé à consulter apparaissent dans les résultats de recherche.

​

Rechercher des éléments du registre

Utilisez la W&B App pour rechercher un élément du registre :

1. Accédez au W&B Registry.
2. Saisissez le terme à rechercher dans la barre de recherche en haut de la page, puis appuyez sur Entrée pour lancer la recherche.

Les résultats de recherche s’affichent sous la barre de recherche si le terme saisi correspond à un registre existant, à un nom de collection, à un tag de version d’artifact, à un tag de collection ou à un alias.

​

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.