레지스트리 항목 찾기

전역 검색창이나 쿼리를 사용해 W&B Registry에서 레지스트리, 컬렉션, 아티팩트 버전을 검색하는 방법을 알아보세요.

W&B Registry의 전역 검색창을 사용해 레지스트리, 컬렉션, 아티팩트 버전 태그, 컬렉션 태그 또는 별칭을 찾으세요. W&B Python SDK를 사용하면 쿼리로 특정 기준에 따라 레지스트리, 컬렉션, 아티팩트 버전을 필터링할 수 있습니다.

W&B Registry를 쿼리할 때 사용하는 문법과 사용 가능한 Operator는 MongoDB 쿼리와 유사하지만 동일하지는 않습니다.

검색 결과에는 볼 권한이 있는 항목만 표시됩니다.

​

레지스트리 항목 검색

W&B App을 사용해 레지스트리 항목을 검색하려면 다음과 같이 하세요:

1. W&B Registry로 이동합니다.
2. 페이지 상단의 검색창에 검색어를 입력합니다. Enter 키를 눌러 검색합니다.

입력한 검색어가 기존 레지스트리, 컬렉션 이름, 아티팩트 버전 태그, 컬렉션 태그 또는 별칭과 일치하면 검색 결과가 검색창 아래에 표시됩니다.

​

레지스트리 항목 쿼리

wandb.Api().registries()와 쿼리 조건식을 사용해 레지스트리, 컬렉션, 아티팩트 버전을 필터링합니다. 쿼리 조건식은 반환되는 항목이 충족해야 하는 기준을 지정하는 조건입니다.

쿼리 조건식을 만들려면 쿼리 이름, 하나 이상의 Operator, 그리고 값으로 구성된 JSON과 유사한 딕셔너리를 사용합니다. 다음 코드 스니펫은 쿼리 조건식의 일반적인 구조를 보여줍니다.

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

다음 섹션에서는 사용 가능한 레지스트리 쿼리 이름, 지원되는 Operator, 그리고 예제 쿼리를 설명합니다.

​

필터링 가능한 필드

다음 표에는 필터링할 항목의 유형에 따라 사용할 수 있는 쿼리 이름이 나와 있습니다:

	쿼리 이름
레지스트리	name, description, created_at, updated_at
컬렉션	name, tag, description, created_at, updated_at
버전	tag, alias, created_at, updated_at, metadata

​

지원되는 Operator

W&B는 레지스트리 항목을 필터링할 때 다음 비교 및 논리 Operator를 지원합니다:

​

비교 Operator

Operator	설명
$eq	같음
$ne	같지 않음
$gt	초과
$gte	이상
$lt	미만
$lte	이하

​

논리 Operator

Operator	설명
$and	하나 이상의 조건에 AND 논리를 적용합니다
$or	하나 이상의 조건에 OR 논리를 적용합니다
$nor	하나 이상의 조건에 NOR 논리를 적용합니다
$not	조건에 NOT 논리를 적용합니다

​

기타 Operator

Operator	설명
$regex	정규식 패턴 매칭
$exists	필드 존재 여부
$contains	문자열에 값 포함

​

예제 쿼리

다음 코드 예제에서는 일반적인 검색 시나리오 몇 가지를 보여줍니다.

wandb.Api().registries() 방법을 사용하려면 먼저 W&B Python SDK (wandb) 라이브러리를 임포트하세요:

import wandb

# (선택) 가독성을 위해 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 레퍼런스 문서의 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 형식으로 날짜와 시간을 지정하세요. 날짜만 기준으로 필터링하려면 시, 분, 초는 생략할 수 있습니다.