W&B Registry의 전역 검색창을 사용해 레지스트리, 컬렉션, 아티팩트 버전 태그, 컬렉션 태그 또는 별칭을 찾으세요. W&B Python SDK를 사용하면 쿼리로 특정 기준에 따라 레지스트리, 컬렉션, 아티팩트 버전을 필터링할 수 있습니다.
W&B Registry를 쿼리할 때 사용하는 문법과 사용 가능한 Operator는 MongoDB 쿼리와 유사하지만 동일하지는 않습니다.
- W&B Registry로 이동합니다.
- 페이지 상단의 검색창에 검색어를 입력합니다. Enter 키를 눌러 검색합니다.
입력한 검색어가 기존 레지스트리, 컬렉션 이름, 아티팩트 버전 태그, 컬렉션 태그 또는 별칭과 일치하면 검색 결과가 검색창 아래에 표시됩니다.
wandb.Api().registries()와 쿼리 조건식을 사용해 레지스트리, 컬렉션, 아티팩트 버전을 필터링합니다. 쿼리 조건식은 반환되는 항목이 충족해야 하는 기준을 지정하는 조건입니다.
쿼리 조건식을 만들려면 쿼리 이름, 하나 이상의 Operator, 그리고 값으로 구성된 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 |
| Operator | 설명 |
|---|
$eq | 같음 |
$ne | 같지 않음 |
$gt | 초과 |
$gte | 이상 |
$lt | 미만 |
$lte | 이하 |
| Operator | 설명 |
|---|
$and | 하나 이상의 조건에 AND 논리를 적용합니다 |
$or | 하나 이상의 조건에 OR 논리를 적용합니다 |
$nor | 하나 이상의 조건에 NOR 논리를 적용합니다 |
$not | 조건에 NOT 논리를 적용합니다 |
| 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 alias 중 하나가 있는 모든 아티팩트 버전을 찾습니다:
# 문자열 `model`을 포함하고 태그 `image-classification` 또는 `latest` alias를 가진
# 모든 아티팩트 버전 찾기
registry_filters = {
"name": {"$regex": "model"}
}
# 논리 $or operator를 사용하여 아티팩트 버전 필터링
version_filters = {
"$or": [
{"tag": "image-classification"},
{"alias": "production"}
]
}
# 필터 조건에 일치하는 모든 아티팩트 버전의 이터러블 반환
artifacts = api.registries(filter=registry_filters).collections().versions(filter=version_filters)
artifacts 반복 가능 객체의 각 항목은 Artifact 클래스의 인스턴스입니다. 즉, 각 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")
# 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 형식으로 날짜와 시간을 지정하세요. 날짜만 기준으로 필터링하려면 시, 분, 초는 생략할 수 있습니다.
