Passagem de valores de conjuntos de parâmetros para DataStage trabalhos por interface de linha de comando

Quando você executa um trabalho DataStage®, pode passar valores de um conjunto de parâmetros para o trabalho usando o sinalizador --paramset.

Veja os exemplos a seguir de cenários em que você pode passar conjuntos de parâmetros e valores de conjuntos de parâmetros para trabalhos de DataStage.

Passando um parâmetro configurado em um job

Ao executar um trabalho, é possível passar os valores de um parâmetro configurado em uma execução de tarefa usando o flag --paramset. Por exemplo, o comando a seguir passa todos os valores configurados de parâmetro a partir do conjunto de parâmetros PS_SAMPLE, que possui dois campos, DATASET_NAME e FILE_NAME. Os valores desses dois campos são transmitidos como parâmetros de emprego para a execução de tarefas. O exemplo mostra os valores que são transmitidos para a execução de tarefas.

$ cpdctl dsjob run --project YongProject --job "TestParameterSet.DataStage job" --wait 300 --paramset PS_SAMPLE 
Job Run ID:  f29d843b-df5d-4b5f-84cc-967f07208fb2
...
...
"PS_SAMPLE.DATASET_NAME"='/ds-storage/BostonProperty-2022.ds'
"PS_SAMPLE.FILE_NAME"='/ds-storage/BostonProperty-2022.csv'

Passando um valor configurado em um trabalho

Este exemplo mostra como você pode passar em valores a partir do valor conjunto QA que pertence ao parâmetro set PS_SAMPLE. A execução da tarefa passa o valor definido a partir do valor conjunto QA na seção de parâmetro de emprego.

$ cpdctl dsjob run --project YongProject --job "TestParameterSet.DataStage job" --wait 300 --paramset PS_SAMPLE.QA
Job Run ID:  fec9ae5d-df5a-43c9-8bfe-c4cc11493885
...
...
"PS_SAMPLE.DATASET_NAME"='/ds-storage/BostonProperty-2022-QA.ds'
"PS_SAMPLE.FILE_NAME"='/ds-storage/BostonProperty-2022-QA.csv'
"flow_name"='TestParameterSet.DataStage job'

Sobrepor um conjunto de parâmetros com outro conjunto de parâmetros

Neste exemplo, o parâmetro set PS_SAMPLE e todos os seus campos são transmitidos para os parâmetros de execução de tarefas. No entanto, os valores de campo são substituídos se existirem no parâmetro overriding set PROJDEF. O conjunto de parâmetros PROJDEF tem DATASET_NAME e FILE_NAME, cujos valores são transmitidos para os campos correspondentes no conjunto de parâmetros PS_SAMPLE e enviados em parâmetros de tarefa como valores. Apenas campos que são comuns são sobrescrito. Os outros campos do conjunto de parâmetros PS_SAMPLE são transmitidos sem alterações.

$ cpdctl dsjob run --project YongProject --job "TestParameterSet.DataStage job" --wait 300 --paramset PS_SAMPLE=PROJDEF
Job Run ID:  70c403c5-938d-42be-8b04-dbd4e74947b8
...
...
"PS_SAMPLE.DATASET_NAME"='/ds-storage//ds-storage/BostonProperty-2022-PROJDEF.ds'
"PS_SAMPLE.FILE_NAME"='/ds-storage/BostonProperty-2022-PROJDEF.csv'
"flow_name"='TestParameterSet.DataStage job'

Como anular um conjunto de valores

Neste exemplo, os valores a partir do valor conjunto QA a partir do parâmetro set PS_SAMPLE são usados nos parâmetros de execução do job, mas são substituídos pelos valores a partir do parâmetro set PROJDEF.

$ cpdctl dsjob run --project YongProject --job "TestParameterSet.DataStage job" --wait 300 --paramset PS_SAMPLE.QA=PROJDEF
Job Run ID:  f867cd17-b913-4f5f-8091-720a71668877
...
...
"PS_SAMPLE.DATASET_NAME"='/ds-storage//ds-storage/BostonProperty-2022-PROJDEF.ds'
"PS_SAMPLE.FILE_NAME"='/ds-storage/BostonProperty-2022-PROJDEF.csv'
"flow_name"='TestParameterSet.DataStage job'

Como anular um parâmetro específico

Você pode substituir um parâmetro específico usando a opção --param . Neste exemplo, valores de conjunto de parâmetros a partir do valor conjunto QA a partir do parâmetro set PS_SAMPLE são usados para transmitir como parâmetros de tarefa mas o valor do campo FILE_NAME é substituído.

$ cpdctl dsjob run --project YongProject --job "TestParameterSet.DataStage job" --wait 300 --paramset PS_SAMPLE.QA=PROJDEF --param PS_SAMPLE.FILE_NAME=/ds-storage/BostonProperty-2022-OVERRIDE.csv 
Job Run ID:  ee4f233a-8ee1-4f84-a5a5-5c5ec550efd0
...
...

"PS_SAMPLE.DATASET_NAME"='/ds-storage//ds-storage/BostonProperty-2022-PROJDEF.ds'
"PS_SAMPLE.FILE_NAME"='/ds-storage/BostonProperty-2022-OVERRIDE.csv'
"flow_name"='TestParameterSet.DataStage job'