Documentação do Oracle Cloud Infrastructure

Criando uma Tarefa SQL

Uma tarefa SQL no Data Integration está associada a um procedimento armazenado em um banco de dados.

O banco de dados deve estar associado a um ativo de dados que já foi criado no espaço de trabalho. Para criar um ativo de dados, consulte Criando um Ativo de Dados.

Crie uma tarefa SQL em um projeto ou pasta. O Data Integration inclui um projeto padrão para você começar. Para criar outro projeto ou pasta, consulte Projetos e Pastas.

No Data Integration, por padrão, você pode ter execuções de tarefas simultâneas ou paralelas de uma tarefa em um determinado momento. Para não permitir execuções de tarefas simultâneas iniciadas manualmente, marque a caixa de seleção Desativar execução simultânea da tarefa ao criar a tarefa. Quando execuções de tarefas simultâneas não são permitidas, uma solicitação de execução para a tarefa falha se já houver uma execução de tarefa em andamento que esteja em um estado não terminal.

    1. Na página Tarefas do projeto ou pasta em que você deseja criar uma tarefa, selecione Criar tarefa e, em seguida, selecione SQL. Se precisar de ajuda para localizar a página Tarefas em um projeto ou pasta, consulte Listando Tarefas.
    2. Na página Criar tarefa SQL, digite um nome e uma descrição opcional.

      O identificador é um valor gerado pelo sistema com base no nome. Você pode alterar o valor, mas depois de criar e salvar a tarefa, não será possível atualizar o identificador.

    3. Marque a caixa de seleção Desativar execução simultânea da tarefa se quiser não permitir execuções simultâneas desta tarefa.
    4. (Opcional) Para Projeto ou pasta, clique em Selecionar e selecione outro projeto ou pasta na qual salvar a tarefa.
    5. Para salvar a tarefa pela primeira vez, selecione um dos seguintes botões:

      • Criar: Cria e salva a tarefa. Você pode continuar a criar e editar a tarefa.

      • Criar e fechar: Cria e salva a tarefa, fecha a página e retorna você à lista de tarefas na página de detalhes do projeto ou da pasta.

    6. Salve periodicamente enquanto trabalha selecionando um dos seguintes botões:

      • Salvar: Confirma alterações desde o último salvamento. Você pode continuar editando depois de salvar.

      • Salvar e fechar: Confirma alterações, fecha a página e retorna você à lista de tarefas na página de detalhes do projeto ou da pasta.

      • Salvar como: Confirma as alterações (desde o último salvamento) e salva em uma cópia em vez de substituir a tarefa atual. Você pode fornecer um nome para a cópia e selecionar outro projeto ou pasta para a cópia ou salvar a cópia no mesmo projeto ou pasta da tarefa existente.

    7. Na seção SQL, clique em Selecionar e selecione o ativo de dados associado ao banco de dados no qual o procedimento armazenado que você deseja usar é salvo.

      Na página Selecionar SQL exibida, selecione os tipos diretamente ou parametrize os tipos de recursos apenas na ordem em que os tipos são mostrados.

      1. Para localizar e selecionar tipos de recursos diretamente, clique em Selecionar ao lado de um tipo quando ele estiver disponível para seleção.

        • Ativo de dados: O nome do ativo de dados.

        • Conexão: A conexão a ser usada para acessar o banco de dados associado ao ativo de dados.

        • Esquema: O esquema que possui o procedimento armazenado.

        • Procedimento armazenado: O nome do procedimento armazenado a ser usado para esta tarefa SQL.

          Para exibir os parâmetros em um procedimento armazenado antes de selecionar o procedimento:

          1. No painel Selecionar procedimento armazenado, selecione Exibir tudo.
          2. No painel Pesquisar procedimento armazenado, localize o procedimento armazenado desejado e selecione Exibir parâmetros no menu Ações (Menu Ações) desse procedimento armazenado.
      2. Para atribuir parâmetros aos tipos de recursos:

        1. Selecione Designar parâmetro ao lado de um tipo de recurso.

        2. Na página Designar parâmetro, execute uma das seguintes ações:

          • Selecione um parâmetro na lista. Somente parâmetros do mesmo tipo de recurso aparecem na lista para seleção.

          • Selecione Adicionar parâmetro para adicionar um parâmetro para o tipo de recurso.

            1. No painel Adicionar parâmetro, informe um identificador e uma descrição opcional.

            2. Defina o valor padrão do parâmetro para o tipo de recurso.

              Para o tipo de procedimento armazenado, você pode exibir os parâmetros em um procedimento armazenado antes de selecionar a opção. Selecione View all que está ao lado do menu Stored procedure. No painelProcurar procedimento armazenado que é exibido, localize o procedimento armazenado desejado e selecione Exibir parâmetros no menu Ações (Menu Ações) desse procedimento armazenado.

            3. Selecione Adicionar.

              O parâmetro do tipo de recurso adicionado é selecionado automaticamente na página Designar parâmetro.

        3. Selecione Atribuir.
      3. Na página Selecionar SQL, selecione Concluído.

        Você retornará à página Criar tarefa SQL.

    8. Na seção Configurar parâmetros, selecione Configurar para revisar a lista de parâmetros e configurar seus valores.

      O número de parâmetros no procedimento armazenado é mostrado ao lado de Parâmetros configurados. Somente os valores de parâmetro de entrada no procedimento armazenado podem ser configurados.

      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.

      Na página Configurar parâmetros de procedimento armazenado, configure um valor de parâmetro seguindo estas etapas:

      1. Na linha do valor do parâmetro de entrada que você deseja configurar, selecione Configurar.
      2. No painel Editar parâmetro, informe um valor para o parâmetro de entrada e selecione Salvar.

        Depois de configurar um parâmetro de entrada, você poderá editar ou limpar o valor.

      3. Quando terminar de configurar os parâmetros de entrada, selecione Configurar.
    9. (Opcional) Na seção Validar tarefa, selecione Validar para verificar os valores de parâmetro configurados.

      Se houver erros ou avisos, selecione Exibir mensagens. Resolva os erros antes de publicar a tarefa.

      Observação

      Uma tarefa SQL falhará se os parâmetros de entrada do tipo de dados NUMERIC tiverem NULL como valores padrão configurados. Para evitar falhas na execução da tarefa, altere um valor NULL para 0 (zero).
    10. Quando terminar de configurar a tarefa, selecione Criar e Fechar ou Salvar e fechar.
    Publique a tarefa SQL em um aplicativo no Data Integration antes de executar a tarefa ou programá-la para execução. Para publicar informações, consulte Publicando em um Aplicativo Data Integration.

  • Use o comando oci data-integration task create-task-from-SQL-task e os parâmetros necessários para criar uma tarefa SQL:

    oci data-integration task create-task-from-sql-task [OPTIONS]

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação CreateTask com o subtipo de recurso apropriado para criar uma tarefa SQL.