W&B Registry에서 대화형으로 또는 W&B Python SDK를 사용해 프로그래밍 방식으로 레지스트리, 컬렉션, 아티팩트 버전을 찾으세요.
검색 결과에는 볼 권한이 있는 항목만 표시됩니다.
W&B Registry를 쿼리할 때 사용하는 문법과 사용 가능한 Operator는 MongoDB 쿼리와 유사하지만 동일하지는 않습니다.
- W&B Registry로 이동합니다.
- 페이지 상단의 검색창에 검색어를 입력합니다.
- Enter 키를 눌러 검색합니다.
고급 검색을 사용해 레지스트리, 컬렉션 또는 아티팩트 버전을 검색하세요. 필터를 사용하면 이름, 태그, 설명, 생성 날짜 등의 속성을 기준으로 특정 레지스트리 항목을 검색할 수 있습니다.
- W&B Registry로 이동합니다.
- 홈 화면 상단에서 Advanced를 클릭합니다.
- 레지스트리, 컬렉션 또는 아티팩트 버전 버튼을 선택합니다.
- Filters를 클릭합니다.
- 왼쪽부터 순서대로 필터링할 속성, 연산자, 값을 선택합니다. 필터를 여러 개 추가해 검색 범위를 좁힐 수 있습니다.
- 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 별칭 중 하나가 있는 모든 아티팩트 버전을 찾습니다:
# `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")
# 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 형식으로 날짜와 시간을 지정하세요. 날짜만 기준으로 필터링하려면 시, 분, 초는 생략할 수 있습니다.
