az datafactory pipeline
참고
이 참조는 Azure CLI 대한 데이터 팩터리 확장의 일부이며 버전 2.15.0 이상에 필요합니다. az datafactory pipeline 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.
데이터 팩터리로 파이프라인을 관리합니다.
명령
| 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"
필수 매개 변수
팩터리 이름입니다.
파이프라인 이름입니다.
파이프라인 리소스 정의. 예상 값: json-string/@json-file .
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
파이프라인 엔터티의 ETag입니다. 기존 엔터티와 일치해야 하거나 무조건 업데이트할 수 있는 업데이트에만 지정해야 * 합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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"
필수 매개 변수
팩터리 이름입니다.
파이프라인 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
복구 모드 플래그입니다. 복구 모드가 true로 설정된 경우 지정된 참조된 파이프라인이 실행되고 새 실행이 동일한 groupId 아래에 그룹화됩니다.
파이프라인 실행의 매개 변수입니다. 이러한 매개 변수는 runId가 지정되지 않은 경우에만 사용됩니다. 예상 값: json-string/@json-file .
파이프라인 실행 식별자입니다. 실행 ID를 지정하면 지정된 실행의 매개 변수가 새 실행을 만드는 데 사용됩니다.
복구 모드에서는 이 작업에서 다시 실행이 시작됩니다. 지정하지 않으면 모든 활동이 실행됩니다.
복구 모드에서 true로 설정하면 실패한 활동에서 다시 실행이 시작됩니다. 속성은 startActivityName이 지정되지 않은 경우에만 사용됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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"
필수 매개 변수
팩터리 이름입니다.
파이프라인 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
확인을 묻는 메시지를 표시하지 마세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az datafactory pipeline list
파이프라인을 나열합니다.
az datafactory pipeline list --factory-name
--resource-group
예제
Pipelines_ListByFactory
az datafactory pipeline list --factory-name "exampleFactoryName" --resource-group "exampleResourceGroup"
필수 매개 변수
팩터리 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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"
필수 매개 변수
팩터리 이름입니다.
파이프라인 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
파이프라인 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 가 제공된 경우 * 콘텐츠가 반환되지 않습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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"
필수 매개 변수
팩터리 이름입니다.
파이프라인 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
파이프라인의 활동 목록입니다. 예상 값: json-string/@json-file .
경로 및 키 값 쌍을 지정하여 개체를 개체 목록에 추가합니다. 예: --add property.listProperty <key=value, string 또는 JSON string>.
파이프라인을 설명하는 데 사용할 수 있는 태그 목록입니다. 예상 값: json-string/@json-file .
파이프라인에 대한 최대 동시 실행 수입니다.
파이프라인의 설명입니다.
TimeSpan 값이며, 그 후 Azure 모니터링 메트릭이 발생합니다. 예상 값: json-string/@json-file .
이 파이프라인이 있는 폴더의 이름입니다.
'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.
파이프라인 엔터티의 ETag입니다. 기존 엔터티와 일치해야 하거나 무조건 업데이트할 수 있는 업데이트에만 지정해야 * 합니다.
파이프라인 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 가 제공된 경우 * 콘텐츠가 반환되지 않습니다.
파이프라인에 대한 매개 변수 목록입니다. 예상 값: json-string/@json-file .
목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list OR --remove propertyToRemove.
파이프라인에서 내보내는 차원입니다. 예상 값: json-string/@json-file .
설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.
파이프라인에 대한 변수 목록입니다. 예상 값: json-string/@json-file .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.