레지스트리 항목 찾기

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

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

W&B Registry를 쿼리할 때 사용할 수 있는 문법과 연산자는 MongoDB 쿼리와 유사하지만 완전히 동일하지는 않습니다.

검색 결과에는 사용자가 조회 권한을 가진 항목만 표시됩니다.

​

레지스트리 항목 검색

W&B 앱을 사용해 레지스트리 항목을 검색하려면 다음을 수행합니다:

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

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

​

레지스트리 항목 조회

wandb.Api().registries()와 *쿼리 프레디킷(query predicate)*을 사용하여 레지스트리, 컬렉션, 아티팩트 버전을 필터링할 수 있습니다. 쿼리 프레디킷은 반환되는 항목이 충족해야 하는 기준을 지정하는 조건입니다.

쿼리 프레디킷을 생성하려면 쿼리 이름, 하나 이상의 연산자, 그리고 값으로 구성된 JSON 유사 딕셔너리를 사용합니다. 다음 코드 스니펫은 쿼리 프레디킷의 일반적인 구조를 보여줍니다:

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

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

​

필터링 가능한 필드

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

	쿼리 이름
registries	name, description, created_at, updated_at
collections	name, tag, description, created_at, updated_at
versions	tag, alias, created_at, updated_at, metadata

​

지원되는 연산자

W&B에서는 레지스트리 항목을 필터링할 때 다음과 같은 비교 연산자와 논리 연산자를 지원합니다:

​

비교 연산자

Operator	Description
$eq	같음
$ne	같지 않음
$gt	큼
$gte	크거나 같음
$lt	작음
$lte	작거나 같음

​

논리 연산자

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

​

기타 연산자

연산자	설명
$regex	정규식 패턴 일치
$exists	필드가 존재함/존재하지 않음
$contains	문자열이 값을 포함

​

예시 쿼리

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

wandb.Api().registries() 메서드를 사용하려면 먼저 W&B Python SDK (wandb) 라이브러리를 import 하십시오:

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"아티팩트 이름: {art.name}")
    print(f"아티팩트가 속한 컬렉션: { art.collection.name}")
    print(f"아티팩트 별칭: {art.aliases}")
    print(f"아티팩트에 연결된 태그: {art.tags}")
    print(f"아티팩트 생성 시각: {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 형식으로 지정하세요. 날짜로만 필터링하려면 시, 분, 초는 생략해도 됩니다.