아티팩트 다운로드 및 사용

이미 W&B Server에 저장된 아티팩트를 다운로드해 사용할 수 있으며, 필요에 따라 중복 제거를 위해 아티팩트 객체를 생성해 전달할 수도 있습니다.

Models Viewer 시트의 팀 구성원은 아티팩트를 다운로드할 수 없습니다.

W&B에 저장된 아티팩트 다운로드 및 사용

아티팩트가 run 종속성인 경우 run 입력으로 추적되도록 다운로드하고, 리니지 추적이 필요하지 않은 워크플로의 경우 직접 가져오세요.

W&B가 처리할 수 있는 스킴이 있는 참조는 아티팩트 파일과 동일한 방식으로 다운로드됩니다. 자세한 내용은 외부 파일 추적을 참조하세요.

아티팩트의 모든 파일을 다운로드하거나 개별 파일만 다운로드할 수 있습니다.

모든 파일을 다운로드하려면 Artifact.download()을 사용하세요.
특정 엔트리를 가져오려면 Artifact.get_entry()를 사용한 다음, .download()를 호출하세요.

run 입력 추적
직접 가져오기
W&B CLI

W&B run의 일부로 아티팩트를 다운로드하려면 wandb.Run.use_artifact()를 사용하세요. W&B는 해당 아티팩트를 run의 입력으로 기록합니다.

W&B Python SDK를 임포트하고 W&B Run을 초기화하세요.
wandb.Run.use_artifact()로 아티팩트 버전을 조회하세요.
반환된 Artifact 객체에서 모든 파일 또는 특정 파일을 다운로드하세요.

import wandb    

with wandb.init(project="<example>", job_type="<job-type>") as run:
    # 사용할 아티팩트를 지정합니다. 형식은 "name:alias"입니다.
    artifact = run.use_artifact("bike-dataset:latest")

    # 전체 아티팩트를 다운로드합니다.
    datadir = artifact.download()

    # 특정 파일을 다운로드합니다.
    entry = artifact.get_entry("bike.png")
    file_path = entry.download() # bike.png만 다운로드합니다.

run을 생성하거나 run 입력 관계를 기록하지 않고 아티팩트를 다운로드하려면 Public API를 사용하세요.

W&B Python SDK를 임포트하고 wandb.Api()로 클라이언트 객체를 생성하세요.
wandb.Api.artifact()로 아티팩트 버전을 조회하세요.
반환된 Artifact 객체에서 모든 파일 또는 특정 파일을 다운로드하세요.

아티팩트 경로는 entity/project/artifact:alias 형식으로 지정하세요.

import wandb

api = wandb.Api()
artifact = api.artifact("entity/project/artifact:alias")
artifact.download()

W&B Server에서 아티팩트를 다운로드하려면 wandb artifact get 명령어를 사용하세요.

$ wandb artifact get project/artifact:alias --root mnist/

아티팩트 일부 다운로드

접두사를 기준으로 아티팩트의 일부만 선택해 다운로드할 수 있습니다. path_prefix= (wandb.Artifact.download(path_prefix=)) 매개변수를 사용해 단일 파일 또는 하위 폴더의 내용을 다운로드하세요.

with wandb.init(project="<example>", job_type="<job-type>") as run:
    # 사용할 아티팩트를 지정합니다. 형식은 "name:alias"입니다.
    artifact = run.use_artifact("bike-dataset:latest")

    # 특정 파일 또는 하위 폴더 다운로드
    artifact.download(path_prefix="bike.png") # bike.png만 다운로드

또는 특정 디렉터리에서 파일을 다운로드할 수도 있습니다. 이렇게 하려면 path_prefix= 매개변수에 디렉터리를 지정하세요. 이전 코드 스니펫에 이어서 설명하면 다음과 같습니다:

# images/bikes 디렉터리의 파일을 다운로드합니다
artifact.download(path_prefix="images/bikes/") 

다른 프로젝트의 아티팩트 사용

아티팩트를 참조하려면 프로젝트 이름과 함께 아티팩트 이름을 지정하세요. entity 이름과 함께 아티팩트 이름을 지정하면 entity 간에도 아티팩트를 참조할 수 있습니다. 다음 코드 예제는 현재 W&B run의 입력으로 다른 프로젝트의 아티팩트를 쿼리하는 방법을 보여줍니다.

with wandb.init(project="<example>", job_type="<job-type>") as run:
    # 다른 프로젝트의 아티팩트를 W&B에서 쿼리하고
    # 이 run의 입력으로 표시합니다.
    artifact = run.use_artifact("my-project/artifact:alias")

    # 다른 entity의 아티팩트를 사용하고 이 run의 입력으로
    # 표시합니다.
    artifact = run.use_artifact("my-entity/my-project/artifact:alias")

아티팩트를 생성과 동시에 사용하기

아티팩트를 생성하는 동시에 사용할 수 있습니다. 아티팩트 객체를 만든 다음 use_artifact에 전달하세요. 이렇게 하면 아직 존재하지 않는 경우 W&B에서 아티팩트가 생성됩니다. wandb.Run.use_artifact() API는 멱등적이므로 원하는 만큼 여러 번 호출해도 됩니다.

import wandb

with wandb.init(project="<example>", job_type="<job-type>") as run:
    artifact = wandb.Artifact("reference model")
    artifact.add_file("model.h5")
    run.use_artifact(artifact)

아티팩트를 생성하는 방법에 대한 자세한 내용은 아티팩트 생성하기를 참조하세요.

가이드

인테그레이션

레퍼런스

W&B에 저장된 아티팩트 다운로드 및 사용

아티팩트 일부 다운로드

다른 프로젝트의 아티팩트 사용

아티팩트를 생성과 동시에 사용하기

​W&B에 저장된 아티팩트 다운로드 및 사용

​아티팩트 일부 다운로드

​다른 프로젝트의 아티팩트 사용

​아티팩트를 생성과 동시에 사용하기

W&B에 저장된 아티팩트 다운로드 및 사용

아티팩트 일부 다운로드

다른 프로젝트의 아티팩트 사용

아티팩트를 생성과 동시에 사용하기