Documentação do Oracle Cloud Infrastructure

Usando Operadores de Pipeline

No Data Integration, operadores de pipeline representam diferentes tarefas e atividades que podem ser usadas em um pipeline.

O tipo de operadores de tarefa que você pode usar em um pipeline é:

  • Operadores de tarefa de integração e do carregador de dados que permitem executar soluções de integração de dados em um pipeline. Você pode configurar entradas para os operadores. As entradas do operador de tarefa são semelhantes aos parâmetros definidos em um nível de tarefa ou fluxo de dados.
  • Operadores de tarefa SQL que permitem executar procedimentos armazenados SQL em um pipeline. Você pode configurar valores para os parâmetros nos procedimentos armazenados.
  • Operadores de tarefa do OCI Data Flow que permitem executar aplicativos do OCI Data Flow em um pipeline.
  • Operadores de tarefa REST que permitem executar pontos finais de API REST em um pipeline. Você pode reconfigurar os valores de qualquer um dos parâmetros usados na tarefa REST.
  • Operadores de tarefa de pipeline que permitem executar outro pipeline dentro de um pipeline.

Certifique-se de revisar Informações e Considerações de Suporte ao Usar Pipelines antes de criar ou editar um pipeline. Por exemplo, preste atenção ao nível de profundidade aninhado e ao limite de tarefas por nível.

Para todos os operadores de tarefa, você pode selecionar tarefas em tempo de design de projetos no espaço de trabalho atual e tarefas publicadas de qualquer Aplicativo no espaço de trabalho atual. Com tarefas REST publicadas e tarefas do OCI Data Flow, você também pode selecionar uma tarefa de qualquer Aplicativo em outro espaço de trabalho no mesmo compartimento ou em outro compartimento.

Para tarefas executadas em paralelo, você pode usar um operador de mesclagem e especificar uma condição para tratar as operações subsequentes de downstream. Para extrair a saída de qualquer operador e transmiti-la ao próximo operador, você pode usar um operador de expressão.

Você usa um designer semelhante ao designer de fluxo de dados para criar um pipeline. O designer é aberto com um operador de início e um operador de fim já colocado na tela para você. Só pode haver um operador de início e um de fim em um pipeline. Um pipeline deve incluir pelo menos um operador de tarefa para ser válido. Você pode adicionar qualquer número de tarefas e conectá-las em sequência entre o operador de início e o operador de fim. No painel Operadores, arraste os operadores para a tela para projetar o pipeline. Em seguida, use o painel Propriedades para configurar as propriedades de cada operador.

As tarefas conectadas diretamente ao operador de início sempre são executadas. As tarefas subsequentes na sequência podem ser configuradas para execução com base na condição do operador anterior. Por exemplo, considere um pipeline que tenha a sequência Iniciar > Tarefa A > Tarefa B > Finalizar. A tarefa A sempre é executada. Para a Tarefa B, você pode usar a propriedade Condição do Link de Entrada no painel Propriedades para configurar a tarefa para ser executada sempre ou apenas quando o status da Tarefa A atender a uma condição de execução específica.

Para conectar operadores, passe o mouse sobre um operador até ver o conector (círculo pequeno) no lado direito do operador. Em seguida, arraste o conector para o próximo operador ao qual você deseja se conectar. Uma conexão é válida quando uma linha conecta os operadores depois que você solta o conector.

Em geral, um operador tem apenas uma porta de entrada e uma ou mais portas de saída para que os processos fluam pelo pipeline. Por exemplo, você pode conectar a mesma porta de saída do operador de tarefa SQL às portas de entrada em dois operadores de expressão distintos. Somente o operador de fim e o operador de mesclagem podem ter várias portas de entrada.

Você pode duplicar rapidamente um operador de tarefa ou expressão que foi adicionado a um pipeline. Para duplicar o operador, clique com o botão direito do mouse no ícone do operador na tela e selecione Duplicar no menu exibido. Em seguida, renomeie o identificador do operador duplicado no painel Propriedades. Se o operador original estiver conectado a outros operadores, as conexões e quaisquer referências às saídas de um operador anterior não serão copiadas para o operador duplicado.

Operador de Início e Operador de Fim

Quando você começa a criar um pipeline, o designer é aberto com um operador de início e um operador de fim já colocado na tela para você. Só pode haver um operador de início e um de fim em um pipeline.

O operador de início não tem qualquer propriedade que você possa configurar.

Com o operador de fim, você pode configurar a propriedade Condição de link de entrada para especificar uma das seguintes regras para o status de uma execução de tarefa de pipeline:

  • Tudo concluído: O status da tarefa do pipeline é exibido como Sucesso mesmo quando uma das tarefas no pipeline falha.
  • Todos com sucesso: O status da tarefa do pipeline é exibido como Sucesso quando todas as tarefas no pipeline são concluídas com sucesso.
  • Todos com falha: O status da tarefa do pipeline é exibido como Falha quando todas as tarefas no pipeline falham.

Operador de Mesclagem

Para tarefas executadas em paralelo, você pode usar o operador de mesclagem e especificar uma condição para decidir como tratar as operações subsequentes de downstream.

Adicionando e configurando um operador de mesclagem

Um operador de mesclagem pode ter vários links de entrada (upstream) e vários links de saída (downstream).

  1. No painel Operadores, arraste o operador de Fusão para a tela.
  2. Na guia Detalhes do painel Propriedades, digite um nome e uma descrição opcional para o operador de mesclagem.
  3. Para Condição de mesclagem, você pode selecionar entre as seguintes opções:
    • Tudo com sucesso: Todas as operações paralelas vinculadas upstream devem ser concluídas e bem-sucedidas para que a próxima operação downstream possa continuar. Essa opção é o padrão.
    • Todos com falha: Todas as operações paralelas vinculadas acima devem ser concluídas e com falha para que a próxima operação abaixo possa continuar.
    • Tudo concluído: Todas as operações paralelas vinculadas upstream devem ser concluídas para que a próxima operação downstream possa continuar.
    • Pelo menos um sucesso: Pelo menos uma operação vinculada upstream deve ser concluída e bem-sucedida para que a próxima operação downstream possa continuar.
    • Pelo menos uma falha: Pelo menos uma operação vinculada upstream deve ser concluída e com falha para que a próxima operação downstream possa continuar.
  4. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.
    As saída disponíveis são uma combinação de parâmetros de saída do sistema e as saída de cada operador de tarefa conectado ao operador de mesclagem.

Operador de Expressão

Um operador de expressão de pipeline permite criar novos campos derivados em um pipeline, semelhante a um operador de expressão em um fluxo de dados.

Adicionando e configurando um operador de expressão

Diferentemente de um operador de expressão de fluxo de dados, um operador de expressão de pipeline não opera nos dados. Um operador de expressão de pipeline permite que você opere na saída do operador anterior, dos parâmetros de pipeline e da saída gerados pelo sistema.

  1. No painel Operadores, arraste o operador de Expressão para a tela.
  2. Com o operador de expressão em foco, na guia Detalhes do painel Propriedades, digite um nome no campo Identifier ou deixe o nome como está.
  3. (Opcional) Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

    • Sempre executar: Executa o nó selecionado, independentemente do status do nó upstream.

      Uma linha cinza indica a condição Sempre executar.

      Não é possível alterar a condição de link para nós conectados diretamente ao operador de Início.

    • Run on success of previous operator: Executa o nó selecionado somente quando o status do nó upstream é 'success'.

      Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

    • Executar em caso de falha do operador anterior: Executa o nó selecionado somente quando o status do nó upstream é 'falha'.

      Uma linha vermelha com 'x' indica uma condição de falha.

  4. Em Expressões, selecione Adicionar.
  5. No painel Adicionar expressão, digite um nome no campo Identificador ou deixe o nome como está.
  6. Selecione o Tipo de dados da expressão.
  7. Dependendo do tipo selecionado, pode ser necessário especificar outros valores, como Tamanho ou Escala.
  8. Crie uma expressão no Construtor de expressões e selecione Adicionar.
    O valor derivado de uma expressão pode ser usado no próximo operador conectado a esse operador de expressão de pipeline.
  9. Repita as etapas para adicionar mais expressões.
  10. Na guia Saída do painel Propriedades, você pode exibir as saídas de expressão que podem ser usadas como entradas para o próximo operador no pipeline.
    Cada expressão adicionada tem uma saída. Uma saída tem o mesmo nome que a expressão.
  11. Na guia Validação do painel Propriedades, você pode validar o operador para verificar erros e advertências.
Adicionando uma expressão

Use o Expression Builder para selecionar visualmente elementos para criar uma expressão para um operador de expressão em um pipeline. Você também pode informar uma expressão manualmente no editor.

O Expression Builder é uma seção no painel Adicionar Expressão.

  1. No Construtor de expressão, clique duas vezes para selecionar ou arraste um valor de entrada, um parâmetro ou uma função para criar a expressão.
    Uma expressão pode ser a combinação de saídas do sistema de um operador anterior, parâmetros do sistema, parâmetros definidos pelo usuário e funções.
  2. Para valores de Entrada, você pode escolher entre saídas do sistema do operador anterior. Se o operador anterior for de mesclagem, as saídas do sistema serão as saídas combinadas dos operadores de tarefa conectados ao operador de mesclagem.
  3. Para Parâmetros, você pode escolher entre parâmetros do sistema e parâmetros definidos pelo usuário criados no pipeline.

    • Definido pelo usuário: Um parâmetro definido pelo usuário é um parâmetro personalizado que você cria.

      Você pode selecionar um parâmetro existente na lista de parâmetros disponíveis definidos pelo usuário ou pode selecionar Adicionar para criar um.

      1. No painel Adicionar parâmetro, digite um nome para o parâmetro e uma descrição opcional.
      2. Selecione o Tipo de dados desse parâmetro.
      3. Defina o restante dos campos para esse parâmetro com base no tipo de dados selecionado.
      4. Defina um Valor padrão para esse parâmetro.
      5. Selecione Adicionar.
    • Definido pelo sistema: No runtime, o Data Integration gera determinados parâmetros do sistema para um pipeline. Os valores gerados de parâmetros do sistema podem ser usados em expressões, mas não podem ser modificados.
  4. Para Funções, você pode escolher entre as funções disponíveis do Data Integration para operadores de pipeline.
  5. No painel Adicionar Expressão, selecione Adicionar para criar ou atualizar a expressão.
Excluindo uma expressão

Você poderá excluir expressões quando não precisar mais delas.

  1. Na tela de um pipeline, selecione um operador de expressão.
  2. Com o operador da expressão em foco, na guia Detalhes do painel Propriedades, selecione a expressão que deseja excluir e, em seguida, selecione Excluir.
  3. Na caixa de diálogo Excluir Expressão, verifique se deseja excluir esta expressão e, em seguida, selecione Excluir.

Operador de Decisão

Use o operador de decisão para escrever uma condição Booliana que determina o fluxo de ramificação no pipeline. A ramificação é baseada em três resultados possíveis, a saber, VERDADEIRO, FALSO e ERRO.

Adicionando e configurando um operador de decisão

Um operador de decisão tem um link de entrada (upstream) e três links de saída (downstream).

  1. No painel Operadores, arraste o operador Decisão para a tela.

    Por padrão, o ícone do operador de decisão é exibido como expandido, mostrando três portas de saída, a saber, TRUE, FALSE e ERROR.

  2. Na guia Detalhes do painel Propriedades, digite um nome e uma descrição opcional para o operador de decisão.
  3. Para Condição de decisão, faça o seguinte:
    1. Selecione Adicionar.
    2. No painel Adicionar condição de decisão, grave uma condição usando valores, parâmetros ou funções de entrada, de forma que a expressão de condição seja avaliada como um valor Booliano.

      Por exemplo, uma condição pode avaliar o status de execução da tarefa anterior: PREVIOUS_TASK_1.SYS.STATUS = 'SUCCESS'

      • Para valores de Entrada, você pode escolher entre saídas do sistema do operador anterior.

      • Para Parâmetros, você pode escolher entre parâmetros do sistema e parâmetros definidos pelo usuário criados no pipeline.

        • Definido pelo usuário: Um parâmetro definido pelo usuário é um parâmetro personalizado que você cria.

          Você pode selecionar um parâmetro existente na lista de parâmetros disponíveis definidos pelo usuário ou pode selecionar Adicionar para criar um.

        • Definido pelo sistema: No runtime, o Data Integration gera determinados parâmetros do sistema para um pipeline. Os valores gerados de parâmetros do sistema podem ser usados em expressões, mas não podem ser modificados.

      • Para Funções, você pode escolher entre as funções disponíveis do Data Integration para operadores de pipeline.

  4. (Opcional) Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

    • Sempre executar: Executa o nó selecionado, independentemente do status do nó upstream.

      Uma linha cinza indica a condição Sempre executar.

      Não é possível alterar a condição de link para nós conectados diretamente ao operador de Início.

    • Run on success of previous operator: Executa o nó selecionado somente quando o status do nó upstream é 'success'.

      Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

    • Executar em caso de falha do operador anterior: Executa o nó selecionado somente quando o status do nó upstream é 'falha'.

      Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na tela, conecte as portas de saída apropriadas no operador de decisão a um operador de tarefa ou de expressão downstream.

    Uma porta de saída do operador de decisão não pode ser vinculada diretamente a um operador de mesclagem ou a um operador final.

Operador de Tarefa do Carregador de Dados

Um operador de tarefa do carregador de dados permite executar uma tarefa do carregador de dados em um pipeline.

Adicionando e configurando um operador de tarefa do carregador de dados

Um operador de tarefa do carregador de dados conectado diretamente ao operador inicial sempre é executado.

Para um operador de tarefa não conectado diretamente ao operador de início, você pode usar a propriedade Condição de link de entrada para configurar a tarefa para sempre ser executada ou apenas quando o status do operador anterior atender a uma condição de execução específica.

  1. No painel Operadores, arraste um operador de Carregador de dados para a tela.
    O ícone do operador na tela mostra um nome padrão, indicando que o operador ainda não está vinculado a uma tarefa no espaço de trabalho.
  2. Na guia Detalhes do painel Propriedades do operador de tarefa não vinculado, clique em Selecionar. No painel exibido, use o menu para escolher o tipo de tarefa a ser adicionada e, em seguida, selecione a tarefa.

    Tarefas de design: Para usar uma tarefa em um projeto, primeiro selecione um projeto no menu da lista Projetos. Você também pode começar a digitar um nome de projeto para filtrar a lista e selecionar em uma lista filtrada de nomes correspondentes. Somente projetos no espaço de trabalho atual estão disponíveis para seleção.

    Tarefas publicadas: As tarefas publicadas do Aplicativo mais recente e atualizado no espaço de trabalho e compartimento atuais são listadas para seleção. Você pode usar os menus para alternar para outro Aplicativo no espaço de trabalho atual. Você também pode começar a digitar um nome na caixa Espaços de Trabalho ou Aplicativos e selecionar em uma lista filtrada de nomes correspondentes.

  3. No painel Selecionar uma tarefa do carregador de dados, selecione uma tarefa e clique em Selecionar.
    O nome no ícone do operador na tela é alterado para o nome da tarefa selecionada.
  4. Na guia Detalhes do painel Propriedades do operador de tarefa selecionado:
    1. Renomeie o operador, se desejar.
    2. Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

      • Executar sempre: Executa a tarefa selecionada, independentemente do status do operador de upstream.

        Uma linha cinza indica a condição Sempre executar.

        Não é possível alterar a condição de link para tarefas conectadas diretamente ao operador de Início.

      • Executar em caso de sucesso do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'sucesso'.

        Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

      • Executar em falha do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'falha'.

        Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na guia Configuração do painel Propriedades, você pode:
    1. Configurar opções de execução para especificar como tratar execuções de tarefas que falharam.
    2. Configurar valores de parâmetro de entrada.
  6. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.
  7. Na guia Validação do painel Propriedades, você pode validar a tarefa para verificar erros e advertências em valores de parâmetros configurados, quando aplicável.

Operador de Tarefa de Integração

Um operador de tarefa de integração permite executar um fluxo de dados configurado para um contexto específico. O fluxo de dados deve ser finalizado em uma tarefa de integração.

Adicionando e configurando um operador de tarefa de integração

Um operador de tarefa de integração conectado diretamente ao operador de início sempre é executado.

Para um operador de tarefa não conectado diretamente ao operador de início, você pode usar a propriedade Condição de link de entrada para configurar a tarefa para sempre ser executada ou apenas quando o status do operador anterior atender a uma condição de execução específica.

  1. No painel Operadores, arraste um operador de Integração para a tela.
    O ícone do operador na tela mostra um nome padrão, indicando que o operador ainda não está vinculado a uma tarefa no espaço de trabalho.
  2. Na guia Detalhes do painel Propriedades do operador de tarefa não vinculado, clique em Selecionar. No painel exibido, use o menu para escolher o tipo de tarefa a ser adicionada e, em seguida, selecione a tarefa.

    Tarefas de design: Para usar uma tarefa em um projeto, primeiro selecione um projeto no menu da lista Projetos. Você também pode começar a digitar um nome de projeto para filtrar a lista e selecionar em uma lista filtrada de nomes correspondentes. Somente projetos no espaço de trabalho atual estão disponíveis para seleção.

    Tarefas publicadas: As tarefas publicadas do Aplicativo mais recente e atualizado no espaço de trabalho e compartimento atuais são listadas para seleção. Você pode usar os menus para alternar para outro Aplicativo no espaço de trabalho atual. Você também pode começar a digitar um nome na caixa Espaços de Trabalho ou Aplicativos e selecionar em uma lista filtrada de nomes correspondentes.

  3. No painel Selecionar uma tarefa de integração, selecione uma tarefa e clique em Selecionar.
    O nome no ícone do operador na tela é alterado para o nome da tarefa selecionada.
  4. Na guia Detalhes do painel Propriedades do operador de tarefa selecionado:
    1. Renomeie o operador, se desejar.
    2. Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

      • Executar sempre: Executa a tarefa selecionada, independentemente do status do operador de upstream.

        Uma linha cinza indica a condição Sempre executar.

        Não é possível alterar a condição de link para tarefas conectadas diretamente ao operador de Início.

      • Executar em caso de sucesso do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'sucesso'.

        Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

      • Executar em falha do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'falha'.

        Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na guia Configuração do painel Propriedades, você pode:
    1. Configurar opções de execução para especificar como tratar execuções de tarefas que falharam.
    2. Configurar valores de parâmetro de entrada.
  6. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.
  7. Na guia Validação do painel Propriedades, você pode validar a tarefa para verificar erros e advertências em valores de parâmetros configurados, quando aplicável.

Operador de Tarefa de Pipeline

Um operador de tarefa de pipeline permite que você execute um pipeline dentro de outro pipeline.

Adicionando e configurando um operador de tarefa de pipeline

Um operador de tarefa de pipeline conectado diretamente ao operador de início sempre é executado.

Para um operador de tarefa não conectado diretamente ao operador de início, você pode usar a propriedade Condição de link de entrada para configurar a tarefa para sempre ser executada ou apenas quando o status do operador anterior atender a uma condição de execução específica.

  1. No painel Operadores, arraste o operador de Pipeline para a tela.
    O ícone do operador na tela mostra um nome padrão, indicando que o operador ainda não está vinculado a uma tarefa no espaço de trabalho.
  2. Na guia Detalhes do painel Propriedades do operador de tarefa não vinculado, clique em Selecionar. No painel exibido, use o menu para escolher o tipo de tarefa a ser adicionada e, em seguida, selecione a tarefa.

    Tarefas de design: Para usar uma tarefa em um projeto, primeiro selecione um projeto no menu da lista Projetos. Você também pode começar a digitar um nome de projeto para filtrar a lista e selecionar em uma lista filtrada de nomes correspondentes. Somente projetos no espaço de trabalho atual estão disponíveis para seleção.

    Tarefas publicadas: As tarefas publicadas do Aplicativo mais recente e atualizado no espaço de trabalho e compartimento atuais são listadas para seleção. Você pode usar os menus para alternar para outro Aplicativo no espaço de trabalho atual. Você também pode começar a digitar um nome na caixa Espaços de Trabalho ou Aplicativos e selecionar em uma lista filtrada de nomes correspondentes.

  3. No painel Selecionar uma tarefa de pipeline, selecione uma tarefa e clique em Selecionar.
    O nome no ícone do operador na tela é alterado para o nome da tarefa selecionada.
  4. Na guia Detalhes do painel Propriedades do operador de tarefa selecionado:
    1. Renomeie o operador, se desejar.
    2. Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

      • Executar sempre: Executa a tarefa selecionada, independentemente do status do operador de upstream.

        Uma linha cinza indica a condição Sempre executar.

        Não é possível alterar a condição de link para tarefas conectadas diretamente ao operador de Início.

      • Executar em caso de sucesso do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'sucesso'.

        Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

      • Executar em falha do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'falha'.

        Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na guia Configuração do painel Propriedades, você pode:
    1. Configurar opções de execução para especificar como tratar execuções de tarefas que falharam.
    2. Configurar valores de parâmetro de entrada.
  6. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.
  7. Na guia Validação do painel Propriedades, você pode validar a tarefa para verificar erros e advertências em valores de parâmetros configurados, quando aplicável.

Operador de Tarefa SQL

Um operador de tarefa SQL permite executar um objeto SQL, como um procedimento armazenado.

Adicionando e configurando um operador de tarefa SQL

Um operador de tarefa SQL conectado diretamente ao operador de início sempre é executado.

Para um operador de tarefa não conectado diretamente ao operador de início, você pode usar a propriedade Condição de link de entrada para configurar a tarefa para sempre ser executada ou apenas quando o status do operador anterior atender a uma condição de execução específica.

  1. No painel Operadores, arraste o operador SQL para a tela.
    O ícone do operador na tela mostra um nome padrão, indicando que o operador ainda não está vinculado a uma tarefa no espaço de trabalho.
  2. Na guia Detalhes do painel Propriedades do operador de tarefa não vinculado, clique em Selecionar. No painel exibido, use o menu para escolher o tipo de tarefa a ser adicionada e, em seguida, selecione a tarefa.

    Tarefas de design: Para usar uma tarefa em um projeto, primeiro selecione um projeto no menu da lista Projetos. Você também pode começar a digitar um nome de projeto para filtrar a lista e selecionar em uma lista filtrada de nomes correspondentes. Somente projetos no espaço de trabalho atual estão disponíveis para seleção.

    Tarefas publicadas: As tarefas publicadas do Aplicativo mais recente e atualizado no espaço de trabalho e compartimento atuais são listadas para seleção. Você pode usar os menus para alternar para outro Aplicativo no espaço de trabalho atual. Você também pode começar a digitar um nome na caixa Espaços de Trabalho ou Aplicativos e selecionar em uma lista filtrada de nomes correspondentes.

  3. No painel Selecionar uma tarefa SQL, selecione uma tarefa e clique em Selecionar.
    O nome no ícone do operador na tela é alterado para o nome da tarefa selecionada.
  4. Na guia Detalhes do painel Propriedades do operador de tarefa selecionado:
    1. Renomeie o operador, se desejar.
    2. Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

      • Executar sempre: Executa a tarefa selecionada, independentemente do status do operador de upstream.

        Uma linha cinza indica a condição Sempre executar.

        Não é possível alterar a condição de link para tarefas conectadas diretamente ao operador de Início.

      • Executar em caso de sucesso do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'sucesso'.

        Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

      • Executar em falha do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'falha'.

        Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na guia Configuração do painel Propriedades, você pode:
    1. Configurar opções de execução para especificar como tratar execuções de tarefas que falharam.
    2. Configurar valores de parâmetro de entrada.

      As variáveis definidas em um procedimento armazenado são expostas como parâmetros de entrada, saída e entrada/saída. Somente parâmetros de entrada podem ser configurados.

      Observação

      O valor configurado de um parâmetro de entrada deve corresponder ao tipo de dados definido desse parâmetro. Por exemplo, não é possível fornecer um valor String para um parâmetro de entrada cujo tipo de dados é NUMERIC. Além disso, o valor configurado de um parâmetro de entrada de tipo de dados NUMERIC não pode ser NULL no runtime.
  6. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.

    São mostrados os parâmetros de saída gerados pelo sistema e os de saída do procedimento armazenado SQL. Consulte também Parâmetros de Saída.

  7. Na guia Validação do painel Propriedades, você pode validar a tarefa para verificar erros e advertências em valores de parâmetros configurados, quando aplicável.
    Observação

    Uma tarefa SQL falhará se os parâmetros de entrada do tipo de dados NUMERIC configurados tiverem NULL como valor padrão. Para evitar falhas na execução da tarefa, altere um valor NULL para 0 (zero).

Operador de Tarefa do OCI Data Flow

Um operador de tarefa do OCI Data Flow permite que você execute um aplicativo do OCI Data Flow em um pipeline.

Adicionando e configurando um operador de tarefa do OCI Data Flow

Um operador de tarefa conectado diretamente ao operador de início sempre é executado.

Para um operador de tarefa não conectado diretamente ao operador de início, você pode usar a propriedade Condição de link de entrada para configurar a tarefa para sempre ser executada ou apenas quando o status do operador anterior atender a uma condição de execução específica.

  1. No painel Operadores, arraste o operador do OCI Data Flow para a tela.
    O ícone do operador na tela mostra um nome padrão, indicando que o operador ainda não está vinculado a uma tarefa no espaço de trabalho.
  2. Na guia Detalhes do painel Propriedades do operador de tarefa não vinculado, clique em Selecionar. No painel exibido, use o menu para escolher o tipo de tarefa a ser adicionada e, em seguida, selecione a tarefa.

    Tarefas de design: Para usar uma tarefa em um projeto, primeiro selecione um projeto no menu da lista Projetos. Você também pode começar a digitar um nome de projeto para filtrar a lista e selecionar em uma lista filtrada de nomes correspondentes. Somente projetos no espaço de trabalho atual estão disponíveis para seleção.

    Tarefas publicadas: As tarefas publicadas do Aplicativo mais recente e atualizado no espaço de trabalho e compartimento atuais são listadas para seleção. Você pode usar os menus para alternar para outro Aplicativo no espaço de trabalho atual ou para outro espaço de trabalho no mesmo compartimento ou em outro. Você também pode começar a digitar um nome na caixa Espaços de Trabalho ou Aplicativos e selecionar em uma lista filtrada de nomes correspondentes.

  3. No painel Selecionar uma tarefa do OCI Data Flow, selecione uma tarefa e clique em Selecionar.
    O nome no ícone do operador na tela é alterado para o nome da tarefa selecionada.
  4. Na guia Detalhes do painel Propriedades do operador de tarefa selecionado:
    1. Renomeie o operador, se desejar.
    2. Para Condição de link de entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

      • Executar sempre: Executa a tarefa selecionada, independentemente do status do operador de upstream.

        Uma linha cinza indica a condição Sempre executar.

        Não é possível alterar a condição de link para tarefas conectadas diretamente ao operador de Início.

      • Executar em caso de sucesso do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'sucesso'.

        Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

      • Executar em falha do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'falha'.

        Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na guia Configuração do painel Propriedades, você pode:
    1. Configurar valores de parâmetro de entrada.

      Os valores de parâmetros designados aos valores de propriedade na tarefa subjacente do OCI Data Flow podem ser reconfigurados.

    2. Configurar opções de execução para especificar como tratar execuções de tarefas que falharam.
  6. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.

    São mostrados os parâmetros de saída gerados pelo sistema e os parâmetros de saída do aplicativo. Consulte também Parâmetros de Saída.

  7. Na guia Validação do painel Propriedades, você pode validar a tarefa para verificar erros e advertências em valores de parâmetros configurados, quando aplicável.

Operador de Tarefa REST

Um operador de tarefa REST permite que você execute um ponto final de API REST em um pipeline.

Adicionando e configurando um operador de tarefa REST

Um operador de tarefa conectado diretamente ao operador de início sempre é executado.

Para um operador de tarefa não conectado diretamente ao operador de início, você pode usar a propriedade Condição de Link de Entrada para configurar a tarefa para ser executada sempre ou apenas quando o status do operador anterior atender a uma condição de execução específica.

  1. No painel Operadores, arraste o operador REST para a tela.
    O ícone do operador na tela mostra um nome padrão, indicando que o operador ainda não está vinculado a uma tarefa no espaço de trabalho.
  2. Na guia Detalhes do painel Propriedades do operador de tarefa não vinculado, clique em Selecionar. No painel exibido, use o menu para escolher o tipo de tarefa a ser adicionada e, em seguida, selecione a tarefa.

    Tarefas de design: Para usar uma tarefa em um projeto, primeiro selecione um projeto no menu da lista Projetos. Você também pode começar a digitar um nome de projeto para filtrar a lista e selecionar em uma lista filtrada de nomes correspondentes. Somente projetos no espaço de trabalho atual estão disponíveis para seleção.

    Tarefas publicadas: As tarefas publicadas do Aplicativo mais recente e atualizado no espaço de trabalho e compartimento atuais são listadas para seleção. Você pode usar os menus para alternar para outro Aplicativo no espaço de trabalho atual ou para outro espaço de trabalho no mesmo compartimento ou em outro. Você também pode começar a digitar um nome na caixa Espaços de Trabalho ou Aplicativos e selecionar em uma lista filtrada de nomes correspondentes.

  3. No painel Selecionar uma Tarefa REST, selecione uma tarefa e clique em Selecionar.
    O nome no ícone do operador na tela é alterado para o nome da tarefa selecionada.
  4. Na guia Detalhes do painel Propriedades do operador de tarefa selecionado:
    1. Renomeie o operador, se desejar.
    2. Para Condição de Link de Entrada, você pode selecionar entre as condições de execução a seguir. Quando os operadores estão conectados, uma linha colorida indica a condição selecionada.

      • Executar sempre: Executa a tarefa selecionada, independentemente do status do operador de upstream.

        Uma linha cinza indica a condição Sempre executar.

        Não é possível alterar a condição de link para tarefas conectadas diretamente ao operador de Início.

      • Executar em caso de sucesso do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'sucesso'.

        Uma linha verde com uma marca de seleção indica uma condição bem-sucedida.

      • Executar em falha do operador anterior: Executa a tarefa selecionada somente quando o status do operador de upstream é 'falha'.

        Uma linha vermelha com 'x' indica uma condição de falha.

  5. Na guia Configuração do painel Propriedades, você pode:
    1. Configurar valores de parâmetro de entrada.

      Os valores dos parâmetros de URL e outros parâmetros de tarefa definidos na tarefa REST subjacente podem ser reconfigurados.

    2. Configurar opções de execução para especificar como tratar execuções de tarefas que falharam.
  6. Na guia Saída do painel Propriedades, você pode exibir as saídas que podem ser usadas como entradas para o próximo operador no pipeline.

    Os parâmetros de saída gerados pelo sistema e os parâmetros de saída da resposta REST são mostrados. Consulte também Parâmetros de Saída.

  7. Na guia Validação do painel Propriedades, você pode validar a tarefa para verificar erros e advertências em valores de parâmetros configurados, quando aplicável.