az datafactory pipeline

Notitie

Deze verwijzing maakt deel uit van de datafactory-extensie voor Azure CLI en vereist versie 2.15.0 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de opdracht az datafactory pipeline voor het eerst gebruikt. Meer informatie over extensies.

Pijplijn beheren met datafactory.

Opdracht

az datafactory pipeline create

Maak een pijplijn.

az datafactory pipeline create-run

Hiermee maakt u een pijplijn die wordt uitgevoerd.

az datafactory pipeline delete

Hiermee verwijdert u een pijplijn.

az datafactory pipeline list

Een lijst met pijplijnen.

az datafactory pipeline show

Haalt een pijplijn op.

az datafactory pipeline update

Werk een pijplijn bij.

az datafactory pipeline create

Maak een pijplijn.

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

Voorbeelden

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"

Vereiste parameters

--factory-name

De naam van de fabriek.

--name --pipeline-name -n

De naam van de pijplijn.

--pipeline

Definitie van pijplijnresource. Verwachte waarde: json-string/@json-file .

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--if-match

ETag van de pijplijnentiteit. Moet alleen worden opgegeven voor update, waarvoor deze moet overeenkomen met de bestaande entiteit of voor * onvoorwaardelijke updates kan zijn.

az datafactory pipeline create-run

Hiermee maakt u een pijplijn die wordt uitgevoerd.

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}]

Voorbeelden

Pipelines_CreateRun

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

Vereiste parameters

--factory-name

De naam van de fabriek.

--name --pipeline-name -n

De naam van de pijplijn.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--is-recovery

Vlag herstelmodus. Als de herstelmodus is ingesteld op true, worden de opgegeven pijplijnuitleiding en de nieuwe run gegroepeerd onder dezelfde groupId.

geaccepteerde waarden: false, true
--parameters

Parameters van de pijplijn-run. Deze parameters worden alleen gebruikt als de runId niet is opgegeven. Verwachte waarde: json-string/@json-file .

--reference-pipeline-run-id

De id van de pijplijn-run. Als de run-id is opgegeven, worden de parameters van de opgegeven run gebruikt om een nieuwe run te maken.

--start-activity-name

In de herstelmodus wordt het opnieuw starten van deze activiteit. Als dit niet wordt opgegeven, worden alle activiteiten uitgevoerd.

--start-from-failure

Als de herstelmodus is ingesteld op true, wordt de heruitloop van mislukte activiteiten start. De eigenschap wordt alleen gebruikt als startActivityName niet is opgegeven.

geaccepteerde waarden: false, true

az datafactory pipeline delete

Hiermee verwijdert u een pijplijn.

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

Voorbeelden

Pipelines_Delete

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

Vereiste parameters

--factory-name

De naam van de fabriek.

--name --pipeline-name -n

De naam van de pijplijn.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--yes -y

Niet vragen om bevestiging.

az datafactory pipeline list

Een lijst met pijplijnen.

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

Voorbeelden

Pipelines_ListByFactory

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

Vereiste parameters

--factory-name

De naam van de fabriek.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

az datafactory pipeline show

Haalt een pijplijn op.

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

Voorbeelden

Pipelines_Get

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

Vereiste parameters

--factory-name

De naam van de fabriek.

--name --pipeline-name -n

De naam van de pijplijn.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--if-none-match

ETag van de pijplijnentiteit. Moet alleen worden opgegeven voor get. Als de ETag overeenkomt met de bestaande entiteitstag of als * is opgegeven, wordt er geen inhoud geretourneerd.

az datafactory pipeline update

Werk een pijplijn bij.

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]

Voorbeelden

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"

Vereiste parameters

--factory-name

De naam van de fabriek.

--name --pipeline-name -n

De naam van de pijplijn.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--activities

Lijst met activiteiten in de pijplijn. Verwachte waarde: json-string/@json-file .

--add

Voeg een -object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string of JSON string>.

--annotations

Lijst met tags die kunnen worden gebruikt voor het beschrijven van de pijplijn. Verwachte waarde: json-string/@json-file .

--concurrency

Het maximum aantal gelijktijdige runs voor de pijplijn.

--description

De beschrijving van de pijplijn.

--duration

TimeSpan-waarde, waarna een Azure Monitoring-metriek wordt uitgevoerd. Verwachte waarde: json-string/@json-file .

--folder-name

De naam van de map waarin deze pijplijn zich heeft geplaatst.

--force-string

Wanneer u 'set' of 'add' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te proberen te converteren naar JSON.

--if-match

ETag van de pijplijnentiteit. Moet alleen worden opgegeven voor update, waarvoor deze moet overeenkomen met de bestaande entiteit of voor * onvoorwaardelijke updates kan zijn.

--if-none-match

ETag van de pijplijnentiteit. Moet alleen worden opgegeven voor get. Als de ETag overeenkomt met de bestaande entiteitstag of als * is opgegeven, wordt er geen inhoud geretourneerd.

--parameters

Lijst met parameters voor pijplijn. Verwachte waarde: json-string/@json-file .

--remove

Verwijder een eigenschap of een element uit een lijst. Voorbeeld: --remove property.list OR --remove propertyToRemove.

--run-dimensions

Dimensies die worden uitgezonden door de pijplijn. Verwachte waarde: json-string/@json-file .

--set

Werk een object bij door een eigenschapspad en waarde op te geven die moeten worden ingesteld. Voorbeeld: --set property1.property2=.

--variables

Lijst met variabelen voor pijplijn. Verwachte waarde: json-string/@json-file .