Documentação do Oracle Cloud Infrastructure

Configurando Parâmetro de Entrada para Tarefas

Esse procedimento só se aplica a tarefas em que os parâmetros foram designados ou nos fluxos de dados subjacentes das tarefas de integração.

Os parâmetros designados têm valores padrão que são usados durante o design time e o runtime do pipeline.

Se desejar, poderá substituir o valor padrão de um parâmetro de entrada no design time e no runtime. Você também pode substituir o valor padrão de um parâmetro usado dentro de uma expressão em um parâmetro de entrada.

Para substituir um valor, você pode definir diretamente outro valor no design time ou adicionar um parâmetro definido pelo usuário do pipeline para o valor a ser definido no runtime. Se aplicável, você também poderá designar à entrada um valor de parâmetro do sistema ou um valor de saída de um operador anterior.

  1. Na tela de um pipeline, selecione a tarefa cujos valores você deseja exibir ou configurar para os parâmetros de entrada.
  2. No painel Propriedades da tarefa selecionada, selecione Configuração.
  3. Ao lado de Parâmetros de entrada configurados, verifique o número de parâmetros de entrada configurados e disponíveis.
    Por exemplo, 0/4 significa que quatro parâmetros de entrada estão disponíveis nessa tarefa e nenhum foi reconfigurado.
  4. Selecione Configurar ao lado de Parâmetros da entrada configurados.
  5. Na página Configurar parâmetros de entrada, verifique as entradas que podem ser reconfiguradas.
    Uma entrada tem um Valor padrão. Se o parâmetro de entrada for reconfigurado, a entrada terá um Valor configurado. Um valor configurado pode ser um nome de parâmetro definido pelo usuário com o valor configurado mostrado entre parênteses.
  6. (Opcional) Na linha do tipo de parâmetro e valor que você deseja reconfigurar, selecione Configurar.
    Se o parâmetro de entrada já estiver reconfigurado, selecione Editar para alterar o valor configurado ou selecione Limpar para remover o valor.
  7. Na página Configurar parâmetro de entrada para <type> exibida para o parâmetro selecionado, execute uma destas opções e, em seguida, selecione Concluído para retornar à página anterior.

    Observe o seguinte ao configurar parâmetros de entrada:

    • Se uma tarefa for configurada para ser executada no serviço OCI Data Flow, use o seguinte formato se estiver editando os valores de parâmetro padrão para OCI_DF_LOG_BUCKET e OCI_DF_ARTIFACT_BUCKET: oci://<bucket-name>@<tenancy-name>

    • Se a estratégia de extração incremental de uma origem BICC estiver configurada para usar uma data gerenciada pelo parâmetro do sistema Data Integration SYS.LAST_LOAD_DATE, você não terá permissão para alterar o valor da data durante o design time.

    • Se a estratégia de extração incremental de uma origem BICC estiver configurada para usar uma data de extração mais recente parametrizada adicionada, você poderá alterar o valor da data durante o design time e o runtime.

    • Se uma entidade de dados de destino parametrizada estiver configurada para usar a estratégia Mesclar, você poderá alterar a seleção de chave Mesclar.

    • Para um ativo de dados parametrizado que requer um local de preparação: Se você selecionar um ativo de dados que não tenha um local de preparação padrão especificado nesse ativo de dados, o Data Integration exibirá uma notificação de advertência. Quando você vir a notificação, escolha uma das seguintes opções:
      • Atualize esse ativo de dados adicionando um local de preparação padrão.
      • Escolha um ativo de dados diferente que tenha um local de preparação padrão.

    • Para uma tarefa parametrizada do OCI Data Flow:

      • Com uma forma de driver ou executor parametrizada, as OCPUs e os valores de memória serão ignorados se uma forma não flexível for configurada no parâmetro. Os valores de OCPUs e memória são usados somente quando você configura uma forma flexível como o valor do parâmetro.

      • Com OCPUs parametrizadas e valores de memória para uma forma flexível, certifique-se de especificar um valor que esteja na faixa aceitável de valores para essa propriedade. Os valores aceitáveis para OCPUs dependem da forma flexível. Os valores aceitáveis para memória dependem do valor de OCPUs.

    Opção de entrada Descrição
    Designar um valor

    Substitua o valor padrão desse parâmetro especificando um valor diretamente. A forma como você especifica um valor depende do tipo de parâmetro de entrada.

    Por exemplo, digite um valor em um campo para um tipo numérico, string ou data, mas use um menu para selecionar um valor para um parâmetro do tipo ativo de dados, conexão, esquema e entidade de dados. Para um tipo de condição ou expressão, use o editor de condição ou expressão.
    Saída do operador anterior

    Para usar um valor de saída de um operador anterior como entrada para esse parâmetro, selecione um valor na lista de saídas disponíveis.

    Somente as saídas do mesmo tipo do parâmetro de entrada estão disponíveis para seleção.

    Por exemplo, se um parâmetro de entrada for STRING, apenas SYS.STATUS e SYS.ERROR_MESSAGE estarão disponíveis.
    Designar um parâmetro

    Especifique um parâmetro de pipeline para definir outro valor quando o pipeline for executado. Você pode designar um parâmetro definido pelo usuário ou um parâmetro do sistema como entrada do parâmetro de entrada.

    • Usar parâmetros definidos pelo usuário: Selecione um parâmetro definido pelo usuário existente, na lista de parâmetros disponíveis, se houver. Somente parâmetros do mesmo tipo que o parâmetro de entrada estão disponíveis para seleção.

      Se aplicável, selecione Adicionar parâmetro para criar um parâmetro no pipeline e fazer a seleção. No painelAdicionar parâmetro que aparece, informe um nome e a descrição opcional para o parâmetro. Não é possível alterar o tipo de dados, que é igual ao tipo do parâmetro de entrada. A forma como você define o restante dos campos de um parâmetro depende do tipo de entrada. Para criar o parâmetro, selecione Adicionar. Por padrão, o parâmetro definido pelo usuário recém-adicionado é selecionado.

    • Usar parâmetros do sistema: Selecione um parâmetro do sistema na lista de parâmetros disponíveis gerados pelo sistema de runtime, se houver. Apenas os parâmetros do sistema do mesmo tipo do parâmetro de entrada estão disponíveis para seleção. Os parâmetros do sistema OCID são tratados como STRING.

      Por exemplo, se um parâmetro de entrada for VARCHAR, apenas TASK_RUN_NAME, TASK_RUN_KEY, PARENT_TASK_RUN_KEY, TASK_SCHEDULE_TIMEZONE, PIPELINE_NAME e PIPELINE_IDENTIFIER estarão disponíveis.
  8. Na página Configurar parâmetros de entrada, verifique o Valor padrão e o Valor configurado do parâmetro que você acabou de reconfigurar.
    Um valor configurado pode ser um nome de parâmetro definido pelo usuário com o valor configurado mostrado entre parênteses.
  9. Repita as etapas 6 e 7 para configurar outros valores de entrada, conforme necessário. Você também pode selecionar Editar ou Limpar para alterar um valor configurado anteriormente.
  10. Na página Configurar parâmetros de entrada, selecione Configurar quando terminar de configurar valores para os parâmetros de entrada na tarefa.