レジストリ項目を検索する

レジストリ、コレクション、アーティファクトバージョンは、W&B Registry でインタラクティブに、または W&B Python SDK を使用してプログラムから検索できます。検索結果には、表示権限のある項目のみが表示されます。

W&B Registry のクエリに使用できる構文と演算子は MongoDB のクエリに似ていますが、同一ではありません。

W&B Registry ホームページの検索バーを使用して、名前でコレクションやレジストリを検索します。高度な検索を使用すると、名前、タグ、説明、作成日などの特定の属性を持つレジストリ、コレクション、またはアーティファクトバージョンを検索できます。

基本検索

W&B Registry のホームページからレジストリとコレクションを検索します。

W&B Registry にアクセスします。
ページ上部の検索バーに検索語を入力します。
Enter キーを押して検索します。

高度な検索

高度な検索を使用して、レジストリ、コレクション、またはアーティファクトバージョンを検索できます。フィルターを使用すると、名、タグ、説明、作成日などの属性に基づいて、特定のレジストリ項目を検索できます。

W&B Registryにアクセスします。
ホームページ上部のAdvancedをクリックします。
Registries、Collections、またはVersionsボタンを選択します。
Filtersをクリックします。
左から順に、フィルターする属性、演算子、値を選択します。複数のフィルターを追加して、検索結果を絞り込むことができます。
Enterキーを押してフィルターを適用します。

レジストリ項目をクエリする

wandb.Api().registries() と クエリ述語 を使用して、レジストリ、コレクション、アーティファクトバージョンをフィルターします。クエリ述語は、返される項目が満たすべき条件を指定するものです。クエリ述語を作成するには、クエリ名、1 つ以上の演算子、および値で構成される JSON 形式に似た辞書を使用します。次のコードスニペットは、クエリ述語の一般的な構造を示しています。

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

以下のセクションでは、レジストリで使用可能なクエリ名、サポートされる演算子、およびクエリの例について説明します。

フィルター可能なフィールド

次の表は、フィルターする項目のタイプに応じて使用できるクエリ名を示しています。

	クエリ名
レジストリ	`name`, `description`, `created_at`, `updated_at`
コレクション	`name`, `tag`, `description`, `created_at`, `updated_at`
バージョン	`tag`, `alias`, `created_at`, `updated_at`, `metadata`

サポートされている演算子

W&B は、レジストリ項目を絞り込むために、次の比較演算子および論理演算子をサポートしています。

比較演算子

演算子	説明
`$eq`	等しい
`$ne`	等しくない
`$gt`	より大きい
`$gte`	以上
`$lt`	より小さい
`$lte`	以下

論理演算子

演算子	説明
`$and`	1 つ以上の条件に対して AND 演算を行います
`$or`	1 つ以上の条件に対して OR 演算を行います
`$nor`	1 つ以上の条件に対して NOR 演算を行います
`$not`	条件に対して NOT 演算を行います

その他の演算子

演算子	説明
`$regex`	正規表現パターンに一致
`$exists`	フィールドの有無
`$contains`	文字列に値を含む

クエリの例

以下のコード例では、一般的な検索パターンをいくつか示します。 wandb.Api().registries() methodを使用するには、まずW&B Python SDK (wandb) ライブラリをインポートします。

import wandb

# (Optional) 読みやすくするために wandb.Api() クラスのインスタンスを作成する
api = wandb.Api()

model という文字列を含むすべてのレジストリを絞り込みます:

# `model` という文字列を含むすべてのレジストリをフィルターします
registry_filters = {
    "name": {"$regex": "model"}
}

# フィルターに一致するすべてのレジストリのイテラブルを返します
registries = api.registries(filter=registry_filters)

レジストリに関係なく、コレクション名に文字列 yolo を含むすべてのコレクションをフィルターするには、次のようにします:

# レジストリに関係なく、コレクション名に文字列 `yolo` を含む
# すべてのコレクションをフィルターします
collection_filters = {
    "name": {"$regex": "yolo"}
}

# フィルターに一致するすべてのコレクションのイテラブルを返します
collections = api.registries().collections(filter=collection_filters)

コレクション名に文字列 yolo を含み、タグに cnn を持つ、レジストリに関係なくすべてのコレクションをフィルターします:

# レジストリに関係なく、コレクション名に文字列 `yolo` を含み、タグに `cnn` を持つ
# すべてのコレクションをフィルターします
collection_filters = {
    "name": {"$regex": "yolo"},
    "tag": "cnn"
}

# フィルターに一致するすべてのコレクションのイテラブルを返します
collections = api.registries().collections(filter=collection_filters)

文字列 model を含み、タグ image-classification またはエイリアス latest のいずれかを持つアーティファクトのすべてのバージョンを検索します:

# 文字列 `model` を含み、タグ `image-classification` またはエイリアス `latest` のいずれかを持つ
# アーティファクトのすべてのバージョンを検索します
registry_filters = {
    "name": {"$regex": "model"}
}

# 論理演算子 $or を使用してアーティファクト バージョンをフィルターします
version_filters = {
    "$or": [
        {"tag": "image-classification"},
        {"alias": "production"}
    ]
}

# フィルターに一致するすべてのアーティファクト バージョンのイテラブルを返します
artifacts = api.registries(filter=registry_filters).collections().versions(filter=version_filters)

前のコードスニペットの artifacts イテラブル内の各要素は、Artifact クラスのインスタンスです。つまり、各アーティファクトの name、collection、aliases、tags、created_at などの属性にアクセスできます。

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")

アーティファクトオブジェクトの属性の完全な一覧については、API Reference ドキュメントの Artifacts Class を参照してください。レジストリやコレクションに関係なく、2024-01-08 から 2025-03-04 13:10 UTC の間に作成されたすべてのアーティファクトバージョンをフィルターします:

# 2024-01-08 から 2025-03-04 13:10 UTC の間に作成されたすべてのアーティファクト バージョンを検索します。 

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

# フィルターに一致するすべてのアーティファクト バージョンのイテラブルを返します
artifacts = api.registries().collections().versions(filter=artifact_filters)

created_at および updated_at のクエリでは、日時を YYYY-MM-DD HH:MM:SS 形式で指定します。日付のみでフィルターする場合は、時・分・秒を省略できます。