az datafactory pipeline

참고

이 참조는 Azure CLI(버전 2.15.0 이상)에 대한 데이터 팩터리 확장의 일부입니다. 확장은 az datafactory 파이프라인 명령을 처음 실행할 때 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

데이터 팩터리를 사용하여 파이프라인을 관리합니다.

명령

az datafactory pipeline create

파이프라인을 만듭니다.

az datafactory pipeline create-run

파이프라인 실행을 만듭니다.

az datafactory pipeline delete

파이프라인을 삭제합니다.

az datafactory pipeline list

파이프라인을 나열합니다.

az datafactory pipeline show

파이프라인을 가져옵니다.

az datafactory pipeline update

파이프라인을 업데이트합니다.

az datafactory pipeline create

파이프라인을 만듭니다.

az datafactory pipeline create --factory-name
                               --name
                               --pipeline
                               --resource-group
                               [--if-match]

예제

Pipelines_Create

az datafactory pipeline create --factory-name "exampleFactoryName" --pipeline "{\"activities\":[{\"name\":\"ExampleForeachActivity\",\"type\":\"ForEach\",\"typeProperties\":{\"activities\":[{\"name\":\"ExampleCopyActivity\",\"type\":\"Copy\",\"inputs\":[{\"type\":\"DatasetReference\",\"parameters\":{\"MyFileName\":\"examplecontainer.csv\",\"MyFolderPath\":\"examplecontainer\"},\"referenceName\":\"exampleDataset\"}],\"outputs\":[{\"type\":\"DatasetReference\",\"parameters\":{\"MyFileName\":{\"type\":\"Expression\",\"value\":\"@item()\"},\"MyFolderPath\":\"examplecontainer\"},\"referenceName\":\"exampleDataset\"}],\"typeProperties\":{\"dataIntegrationUnits\":32,\"sink\":{\"type\":\"BlobSink\"},\"source\":{\"type\":\"BlobSource\"}}}],\"isSequential\":true,\"items\":{\"type\":\"Expression\",\"value\":\"@pipeline().parameters.OutputBlobNameList\"}}}],\"parameters\":{\"JobId\":{\"type\":\"String\"},\"OutputBlobNameList\":{\"type\":\"Array\"}},\"variables\":{\"TestVariableArray\":{\"type\":\"Array\"}},\"runDimensions\":{\"JobId\":{\"type\":\"Expression\",\"value\":\"@pipeline().parameters.JobId\"}},\"duration\":\"0.00:10:00\"}" --name "examplePipeline" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--name --pipeline-name -n

파이프라인 이름입니다.

--pipeline

파이프라인 리소스 정의입니다. 예상 값: json-string/json-file/@json-file.

--resource-group -g

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

선택적 매개 변수

--if-match

파이프라인 엔터티의 ETag입니다. 기존 엔터티와 일치해야 하거나 무조건 업데이트의 경우 *일 수 있는 업데이트에 대해서만 지정해야 합니다.

az datafactory pipeline create-run

파이프라인 실행을 만듭니다.

az datafactory pipeline create-run --factory-name
                                   --name
                                   --resource-group
                                   [--is-recovery {false, true}]
                                   [--parameters]
                                   [--reference-pipeline-run-id]
                                   [--start-activity-name]
                                   [--start-from-failure {false, true}]

예제

Pipelines_CreateRun

az datafactory pipeline create-run --factory-name "exampleFactoryName" --parameters "{\"OutputBlobNameList\":[\"exampleoutput.csv\"]}" --name "examplePipeline" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--name --pipeline-name -n

파이프라인 이름입니다.

--resource-group -g

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

선택적 매개 변수

--is-recovery

복구 모드 플래그입니다. 복구 모드가 true로 설정된 경우 지정된 참조된 파이프라인이 실행되고 새 실행이 동일한 groupId 아래에 그룹화됩니다.

허용되는 값: false, true
--parameters

파이프라인 실행의 매개 변수입니다. 이러한 매개 변수는 runId가 지정되지 않은 경우에만 사용됩니다. 예상 값: json-string/json-file/@json-file.

--reference-pipeline-run-id

파이프라인 실행 식별자입니다. 실행 ID가 지정된 경우 지정된 실행의 매개 변수를 사용하여 새 실행을 만듭니다.

--start-activity-name

복구 모드에서는 이 작업에서 다시 실행이 시작됩니다. 지정하지 않으면 모든 활동이 실행됩니다.

--start-from-failure

복구 모드에서 true로 설정하면 실패한 활동에서 다시 실행이 시작됩니다. startActivityName을 지정하지 않은 경우에만 속성이 사용됩니다.

허용되는 값: false, true

az datafactory pipeline delete

파이프라인을 삭제합니다.

az datafactory pipeline delete --factory-name
                               --name
                               --resource-group
                               [--yes]

예제

Pipelines_Delete

az datafactory pipeline delete --factory-name "exampleFactoryName" --name "examplePipeline" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--name --pipeline-name -n

파이프라인 이름입니다.

--resource-group -g

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

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az datafactory pipeline list

파이프라인을 나열합니다.

az datafactory pipeline list --factory-name
                             --resource-group

예제

Pipelines_ListByFactory

az datafactory pipeline list --factory-name "exampleFactoryName" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--resource-group -g

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

az datafactory pipeline show

파이프라인을 가져옵니다.

az datafactory pipeline show --factory-name
                             --name
                             --resource-group
                             [--if-none-match]

예제

Pipelines_Get

az datafactory pipeline show --factory-name "exampleFactoryName" --name "examplePipeline" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--name --pipeline-name -n

파이프라인 이름입니다.

--resource-group -g

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

선택적 매개 변수

--if-none-match

파이프라인 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 * 가 제공된 경우 콘텐츠가 반환되지 않습니다.

az datafactory pipeline update

파이프라인을 업데이트합니다.

az datafactory pipeline update --factory-name
                               --name
                               --resource-group
                               [--activities]
                               [--add]
                               [--annotations]
                               [--concurrency]
                               [--description]
                               [--duration]
                               [--folder-name]
                               [--force-string]
                               [--if-match]
                               [--if-none-match]
                               [--parameters]
                               [--remove]
                               [--run-dimensions]
                               [--set]
                               [--variables]

예제

Pipelines_Update

az datafactory pipeline update --factory-name "exampleFactoryName" --description "Example description" --activities "[{\"name\":\"ExampleForeachActivity\",\"type\":\"ForEach\",\"typeProperties\":{\"activities\":[{\"name\":\"ExampleCopyActivity\",\"type\":\"Copy\",\"inputs\":[{\"type\":\"DatasetReference\",\"parameters\":{\"MyFileName\":\"examplecontainer.csv\",\"MyFolderPath\":\"examplecontainer\"},\"referenceName\":\"exampleDataset\"}],\"outputs\":[{\"type\":\"DatasetReference\",\"parameters\":{\"MyFileName\":{\"type\":\"Expression\",\"value\":\"@item()\"},\"MyFolderPath\":\"examplecontainer\"},\"referenceName\":\"exampleDataset\"}],\"typeProperties\":{\"dataIntegrationUnits\":32,\"sink\":{\"type\":\"BlobSink\"},\"source\":{\"type\":\"BlobSource\"}}}],\"isSequential\":true,\"items\":{\"type\":\"Expression\",\"value\":\"@pipeline().parameters.OutputBlobNameList\"}}}]" --parameters "{\"OutputBlobNameList\":{\"type\":\"Array\"}}" --duration "0.00:10:00" --name "examplePipeline" --resource-group "exampleResourceGroup"

필수 매개 변수

--factory-name

팩터리 이름입니다.

--name --pipeline-name -n

파이프라인 이름입니다.

--resource-group -g

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

선택적 매개 변수

--activities

파이프라인의 활동 목록입니다. 예상 값: json-string/json-file/@json-file.

--add

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

--annotations

파이프라인을 설명하는 데 사용할 수 있는 태그 목록입니다. 예상 값: json-string/json-file/@json-file.

--concurrency

파이프라인에 대한 최대 동시 실행 수입니다.

--description

파이프라인의 설명입니다.

--duration

TimeSpan 값이며, 그 후 Azure 모니터링 메트릭이 발생합니다. 예상 값: json-string/json-file/@json-file.

--folder-name

이 파이프라인이 있는 폴더의 이름입니다.

--force-string

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

--if-match

파이프라인 엔터티의 ETag입니다. 기존 엔터티와 일치해야 하거나 무조건 업데이트의 경우 *일 수 있는 업데이트에 대해서만 지정해야 합니다.

--if-none-match

파이프라인 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 * 가 제공된 경우 콘텐츠가 반환되지 않습니다. 기본값은 없음입니다.

--parameters

파이프라인에 대한 매개 변수 목록입니다. 예상 값: json-string/json-file/@json-file.

--remove

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

--run-dimensions

파이프라인에서 내보낸 차원입니다. 예상 값: json-string/json-file/@json-file.

--set

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

--variables

파이프라인에 대한 변수 목록입니다. 예상 값: json-string/json-file/@json-file.