az ml data

참고

이 참조는 Azure CLI 대한 ml 확장의 일부이며 버전 2.15.0 이상이 필요합니다. az ml data 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

Azure ML 데이터 자산을 관리합니다.

Azure ML 데이터 자산은 해당 메타데이터와 함께 스토리지 서비스 또는 공용 URL의 파일에 대한 참조입니다. 데이터의 복사본이 아닙니다. 이러한 데이터 자산을 사용하여 모델 학습 중에 관련 데이터에 액세스하고 참조된 데이터를 컴퓨팅 대상에 탑재하거나 다운로드할 수 있습니다.

명령

az ml data create

데이터 자산을 만듭니다.

az ml data delete

데이터 자산을 삭제합니다.

az ml data list

작업 영역의 데이터 자산을 나열합니다.

az ml data show

데이터 자산에 대한 세부 정보를 표시합니다.

az ml data update

데이터 자산을 업데이트합니다.

az ml data create

데이터 자산을 만듭니다.

데이터 자산은 로컬 컴퓨터의 파일에서 정의하거나 클라우드 스토리지의 파일에 대한 참조로 정의할 수 있습니다. 생성된 데이터 자산은 작업 영역에서 지정된 이름 및 버전으로 추적됩니다.

로컬 컴퓨터의 파일에서 데이터 자산을 만들려면 YAML 구성에서 'local_path' 필드를 지정합니다. Azure ML 작업 영역의 기본 데이터 저장소('workspaceblobstore')를 백업하는 Blob 컨테이너에 이러한 파일을 업로드합니다. 그러면 생성된 데이터 자산이 업로드된 데이터를 가리킵니다.

클라우드 스토리지에서 파일을 참조하는 데이터 자산을 만들려면 스토리지 서비스에 해당하는 '데이터 저장소'를 지정하고 YAML 구성의 스토리지에 있는 파일의 '경로'를 지정합니다.

스토리지 URL 또는 공용 URL에서 직접 데이터 자산을 만들 수도 있습니다. 이렇게 하려면 YAML 구성에서 'path' 필드의 URL을 지정합니다.

az ml data create --resource-group
                  --workspace-name
                  [--datastore-name]
                  [--file]
                  [--name]
                  [--set]
                  [--version]

예제

YAML 사양 파일에서 데이터 자산 만들기

az ml data create --file data.yml --resource-group my-resource-group --workspace-name my-workspace

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. az configure --defaults workspace=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--datastore-name -z

데이터를 업로드할 데이터 저장소의 이름입니다.

--file -f

Azure ML 데이터 사양을 포함하는 YAML 파일의 로컬 경로입니다.

--name -n

데이터 자산의 이름입니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.

--version -v

데이터 자산의 버전입니다.

az ml data delete

데이터 자산을 삭제합니다.

az ml data delete --name
                  --resource-group
                  --version
                  --workspace-name

필수 매개 변수

--name -n

데이터 자산의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--version -v

데이터 자산의 버전입니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. az configure --defaults workspace=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az ml data list

작업 영역의 데이터 자산을 나열합니다.

az ml data list --resource-group
                --workspace-name
                [--max-pages]
                [--name]

예제

작업 영역의 모든 데이터 자산 나열

az ml data list --resource-group my-resource-group --workspace-name my-workspace

작업 영역에서 지정된 이름의 모든 데이터 자산 버전 나열

az ml data list --name my-data --resource-group my-resource-group --workspace-name my-workspace

--query 인수를 사용하여 작업 영역의 모든 데이터 자산을 나열하여 명령 결과에 대해 JMESPath 쿼리를 실행합니다.

az ml data list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. az configure --defaults workspace=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--max-pages -r

반환할 결과의 페이지 수입니다. 기본값은 모두 반환하는 것입니다.

--name -n

데이터 자산의 이름입니다. 제공된 경우 이 이름의 모든 데이터 버전이 반환됩니다.

az ml data show

데이터 자산에 대한 세부 정보를 표시합니다.

az ml data show --name
                --resource-group
                --workspace-name
                [--version]

예제

지정된 이름 및 버전을 가진 데이터 자산에 대한 세부 정보 표시

az ml data show --name my-data --version 1 --resource-group my-resource-group --workspace-name my-workspace

지정된 이름을 가진 최신 버전의 데이터 자산에 대한 세부 정보 표시

az ml data show --name my-data --resource-group my-resource-group --workspace-name my-workspace

필수 매개 변수

--name -n

데이터 자산의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. az configure --defaults workspace=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--version -v

데이터 자산의 버전입니다. 생략하면 최신 버전이 표시됩니다.

az ml data update

데이터 자산을 업데이트합니다.

'description' 및 'tags' 속성만 업데이트할 수 있습니다.

az ml data update --resource-group
                  --workspace-name
                  [--add]
                  [--force-string]
                  [--name]
                  [--remove]
                  [--set]
                  [--version]

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. az configure --defaults workspace=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체를 개체 목록에 추가합니다. 예: --add property.listProperty <key=value, string 또는 JSON string>.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

--name -n

데이터 자산의 이름입니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list OR --remove propertyToRemove.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.

--version -v

데이터 자산의 버전입니다.