az dt job import

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). az dt job import 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. Learn more about extensions.

모델, 트윈 및 관계 데이터를 디지털 트윈 인스턴스로 가져오기 위한 작업을 관리하고 구성합니다.

명령

Name	Description	형식	상태
az dt job import cancel	디지털 트윈 인스턴스에서 실행된 데이터 가져오기 작업을 취소합니다.	Extension	GA
az dt job import create	디지털 트윈 인스턴스에서 데이터 가져오기 작업을 만들고 실행합니다.	Extension	GA
az dt job import delete	디지털 트윈 인스턴스에서 실행된 데이터 가져오기 작업을 삭제합니다.	Extension	GA
az dt job import list	디지털 트윈 인스턴스에서 실행된 모든 데이터 가져오기 작업을 나열합니다.	Extension	GA
az dt job import show	디지털 트윈 인스턴스에서 실행된 데이터 가져오기 작업의 세부 정보를 표시합니다.	Extension	GA

az dt job import cancel

디지털 트윈 인스턴스에서 실행된 데이터 가져오기 작업을 취소합니다.

az dt job import cancel --dt-name --dtn
                        --job-id
                        [--resource-group]
                        [--yes]

예제

작업 ID별로 데이터 가져오기 작업을 취소합니다.

az dt job import cancel -n {instance_or_hostname} -j {job_id}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

--job-id -j

작업의 ID입니다. 작업 생성 중에 이 매개 변수가 생략되면 시스템 생성 ID가 할당됩니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group={name}사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

확인 메시지를 표시하지 않습니다.

속성	값
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

Output format.

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt job import create

디지털 트윈 인스턴스에서 데이터 가져오기 작업을 만들고 실행합니다.

이 명령을 사용하려면 입력 Blob 컨테이너에 입력 가져오기 데이터 파일(.ndjson 형식)이 있어야 합니다. 또한 사용 중인 DT 인스턴스에는 입력 스토리지 계정에 'Storage Blob 데이터 기여자' 역할이 설정되어 있어야 합니다. 작업이 완료되면 작업의 로그 및 오류가 포함된 출력 파일이 만들어집니다.

az dt job import create --data-file --df
                        --dt-name --dtn
                        --ibc --input-blob-container
                        --input-storage-account --isa
                        [--job-id]
                        [--obc --output-blob-container]
                        [--of --output-file]
                        [--osa --output-storage-account]
                        [--resource-group]

예제

Azure Storage 컨테이너에 저장된 데이터 파일을 가져오기 위한 작업을 만듭니다. 가져오기 작업의 출력 파일은 입력 파일의 Blob 컨테이너에 만들어집니다.

az dt job import create -n {instance_or_hostname} --data-file {data_file_name} --input-blob-container {input_blob_container_name} --input-storage-account {input_storage_account_name} --output-file {output_file_name}

Azure Storage 컨테이너에 저장된 데이터 파일을 가져오기 위한 작업을 만듭니다. 가져오기 작업의 출력 파일은 사용자 정의 스토리지 계정 및 Blob 컨테이너에 만들어집니다.

az dt job import create -n {instance_or_hostname} --data-file {data_file_name} --input-blob-container {input_blob_container_name} --input-storage-account {input_storage_account_name} --output-file {output_file_name} --output-blob-container {output_blob_container_name} --output-storage-account {output_storage_account_name}

필수 매개 변수

--data-file --df

대량 가져오기 작업에 대한 데이터 파일 입력의 이름입니다. 파일은 'ndjson' 형식이어야 합니다. 샘플 입력 데이터 파일: https://github.com/Azure/azure-iot-cli-extension/tree/dev/docs/samples/adt-bulk-import-data-sample.ndjson.

속성	값
Parameter group:	Bulk Import Job Arguments

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

--ibc --input-blob-container

대량 가져오기 데이터 파일을 포함하는 Azure Storage Blob 컨테이너의 이름입니다.

속성	값
Parameter group:	Bulk Import Job Arguments

--input-storage-account --isa

대량 가져오기 데이터 파일을 저장하는 Blob 컨테이너를 포함하는 Azure Storage 계정의 이름입니다.

속성	값
Parameter group:	Bulk Import Job Arguments

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--job-id -j

작업의 ID입니다. 작업 생성 중에 이 매개 변수가 생략되면 시스템 생성 ID가 할당됩니다.

--obc --output-blob-container

대량 가져오기 작업의 출력 파일을 만들 Azure Storage Blob 컨테이너의 이름입니다. 제공되지 않으면 입력 Blob 컨테이너를 사용합니다.

속성	값
Parameter group:	Bulk Import Job Arguments

--of --output-file

대량 가져오기 작업의 출력 파일 이름입니다. 이 파일에는 로그와 오류 정보가 포함됩니다. 작업이 완료되면 파일이 자동으로 만들어집니다. 파일이 이미 있는 경우 덮어씁니다. 입력하지 않으면 이름이 {job_id}_output.txt출력 파일이 만들어집니다.

속성	값
Parameter group:	Bulk Import Job Arguments

--osa --output-storage-account

대량 가져오기 작업의 출력 파일이 만들어지는 Blob 컨테이너를 포함하는 Azure Storage 계정의 이름입니다. 제공되지 않으면 입력 스토리지 계정을 사용합니다.

속성	값
Parameter group:	Bulk Import Job Arguments

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group={name}사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

Output format.

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt job import delete

디지털 트윈 인스턴스에서 실행된 데이터 가져오기 작업을 삭제합니다.

az dt job import delete --dt-name --dtn
                        --job-id
                        [--resource-group]
                        [--yes]

예제

작업 ID별로 데이터 가져오기 작업을 삭제합니다.

az dt job import delete -n {instance_or_hostname} -j {job_id}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

--job-id -j

작업의 ID입니다. 작업 생성 중에 이 매개 변수가 생략되면 시스템 생성 ID가 할당됩니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group={name}사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

확인 메시지를 표시하지 않습니다.

속성	값
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

Output format.

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt job import list

디지털 트윈 인스턴스에서 실행된 모든 데이터 가져오기 작업을 나열합니다.

az dt job import list --dt-name --dtn
                      [--resource-group]

예제

대상 디지털 트윈 인스턴스의 모든 데이터 가져오기 작업을 나열합니다.

az dt job import list -n {instance_or_hostname}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group={name}사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

Output format.

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt job import show

디지털 트윈 인스턴스에서 실행된 데이터 가져오기 작업의 세부 정보를 표시합니다.

az dt job import show --dt-name --dtn
                      --job-id
                      [--resource-group]

예제

작업 ID별로 데이터 가져오기 작업의 세부 정보를 표시합니다.

az dt job import show -n {instance_or_hostname} -j {job_id}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

--job-id -j

작업의 ID입니다. 작업 생성 중에 이 매개 변수가 생략되면 시스템 생성 ID가 할당됩니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group={name}사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

Output format.

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False