Find registry items - CoreWeave Docs

レジストリ、コレクション、およびアーティファクトのバージョンをRegistryでインタラクティブに検索するか、W&B Python SDKでプログラム的にクエリすることができます。検索結果には、表示する権限を持つ項目のみが表示されます。

Registryをクエリする際に使用できる構文と利用可能なオペレーターは、MongoDBクエリと類似していますが、同一ではありません。

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

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

基本検索

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

https://forge.coreweave.com/registry/ の Registry にアクセスします。
ページ上部の検索バーに検索語を入力します。
Enter キーを押して検索します。

高度な探索

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

https://forge.coreweave.com/registry/ の Registry にアクセスします。
ホームページ上部の Advanced をクリックします。
Registries、Collections、または Versions ボタンを選択します。
Filters をクリックします。
左から右の順に、フィルターに使用する属性、オペレーター、値を選択します。複数のフィルターを追加して検索結果を絞り込めます。
Enter キーを押してフィルターを適用します。

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

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

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

以下のセクションでは、Registry で利用できるクエリ名、サポートされるオペレーター、クエリの例について説明します。

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

次の表は、フィルターしたいアイテムのタイプに基づいて使用できるクエリ名をリストします:

	query name
レジストリ	`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`	string に値が含まれるかどうか

クエリの例

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

import wandb

# （オプション）読みやすくするために wandb.Api() クラスのインスタンスを作成します
api = wandb.Api()

string model を含むすべてのレジストリをフィルターします：

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

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

レジストリに関係なく、コレクション名にstring yolo を含むすべてのコレクションをフィルターします：

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

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

レジストリに関係なく、コレクション名にstring yolo を含み、タグ cnn が付いているすべてのコレクションをフィルターします：

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

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

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

# string `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")

アーティファクトオブジェクトの属性の完全な一覧については、W&B Python SDK リファレンスドキュメントのアーティファクトクラスを参照してください。レジストリやコレクションに関係なく、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 形式で指定してください。日付のみでフィルターする場合は、時、分、秒を省略できます。

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

​基本検索

​高度な探索

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

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

​サポートされるオペレーター

​比較オペレーター

​論理オペレーター

​その他のオペレーター

​クエリの例

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

基本検索

高度な探索

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

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

サポートされるオペレーター

比較オペレーター

論理オペレーター

その他のオペレーター

クエリの例