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
De naam van de fabriek.
De naam van de pijplijn.
Definitie van pijplijnresource. Verwachte waarde: json-string/@json-file .
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Optionele parameters
ETag van de pijplijnentiteit. Moet alleen worden opgegeven voor update, waarvoor deze moet overeenkomen met de bestaande entiteit of voor * onvoorwaardelijke updates kan zijn.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
De naam van de fabriek.
De naam van de pijplijn.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Optionele parameters
Vlag herstelmodus. Als de herstelmodus is ingesteld op true, worden de opgegeven pijplijnuitleiding en de nieuwe run gegroepeerd onder dezelfde groupId.
Parameters van de pijplijn-run. Deze parameters worden alleen gebruikt als de runId niet is opgegeven. Verwachte waarde: json-string/@json-file .
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.
In de herstelmodus wordt het opnieuw starten van deze activiteit. Als dit niet wordt opgegeven, worden alle activiteiten uitgevoerd.
Als de herstelmodus is ingesteld op true, wordt de heruitloop van mislukte activiteiten start. De eigenschap wordt alleen gebruikt als startActivityName niet is opgegeven.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
De naam van de fabriek.
De naam van de pijplijn.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Optionele parameters
Niet vragen om bevestiging.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
De naam van de fabriek.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
De naam van de fabriek.
De naam van de pijplijn.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Optionele parameters
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.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
De naam van de fabriek.
De naam van de pijplijn.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Optionele parameters
Lijst met activiteiten in de pijplijn. Verwachte waarde: json-string/@json-file .
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>.
Lijst met tags die kunnen worden gebruikt voor het beschrijven van de pijplijn. Verwachte waarde: json-string/@json-file .
Het maximum aantal gelijktijdige runs voor de pijplijn.
De beschrijving van de pijplijn.
TimeSpan-waarde, waarna een Azure Monitoring-metriek wordt uitgevoerd. Verwachte waarde: json-string/@json-file .
De naam van de map waarin deze pijplijn zich heeft geplaatst.
Wanneer u 'set' of 'add' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te proberen te converteren naar JSON.
ETag van de pijplijnentiteit. Moet alleen worden opgegeven voor update, waarvoor deze moet overeenkomen met de bestaande entiteit of voor * onvoorwaardelijke updates kan zijn.
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.
Lijst met parameters voor pijplijn. Verwachte waarde: json-string/@json-file .
Verwijder een eigenschap of een element uit een lijst. Voorbeeld: --remove property.list OR --remove propertyToRemove.
Dimensies die worden uitgezonden door de pijplijn. Verwachte waarde: json-string/@json-file .
Werk een object bij door een eigenschapspad en waarde op te geven die moeten worden ingesteld. Voorbeeld: --set property1.property2=.
Lijst met variabelen voor pijplijn. Verwachte waarde: json-string/@json-file .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.