Programar uma importação de dados

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura
  • Programe importações para tornar possível especificar que determinadas operações de importação ocorram em um intervalo regular.

    Antes de Iniciar

    Função necessária: import_scheduler, import_admin ou admin
    Aviso:

    Conceder ao usuário a função import_scheduler é equivalente a conceder ao usuário a função de administrador, porque o import_scheduler tem a capacidade de executar scripts com privilégios de nível de administrador.

    Procedimento

    1. Navegar até Tudo > Conjuntos para importação do sistema > Administração > Importações agendadas.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de importação de dados programados
      Campo Descrição
      Nome Nome da importação de dados programada.
      Fonte de dados Registro de fonte de dados que define os dados a serem importados.

      Se você selecionar uma fonte de dados remota, ela será atualizada usando a conexão remota antes do início da importação.

      O mapa de transformação ou o transformador robusto usado para a importação de dados está conectado à fonte de dados selecionada. Você pode exibir o mapa de transformação ou o transformador robusto abrindo o registro da fonte de dados e exibindo as guias Transformações e Transformador robusto.

      Executar como Nome de um usuário cujas credenciais são usadas pelo trabalho de importação. Se você não especificar um valor, o trabalho de importação será executado como o usuário convidado.
      Ativo Opção para ativar a importação agendada.
      Usar conexão Opção para especificar o alias de conexão da importação agendada. Esta opção está disponível para Fontes de dados configuradas para usar um alias de conexão.
      Conexão

      Conexão a ser usada para a importação agendada. Selecione o alias primário padrão ou qualquer um dos aliases secundários. Este campo está disponível quando a opção Usar conexão está marcada.

      O sys_id do alias de conexão selecionado é armazenado na sessão do Glide. Ele pode ser acessado no script da fonte de dados personalizada ou em qualquer script de transformação usando o código gs.getSession().getClientData('connection_credential_alias_override').

      Executar Frequência na qual você deseja executar a importação.
      Dia Dia em que a importação será executada. Visível somente se você selecionar Semanalmente ou Mensalmente na lista Executar.
      Hora Hora em que você deseja que a importação comece. Não programe várias importações ao mesmo tempo. A execução de várias importações ao mesmo tempo pode afetar negativamente o desempenho ou causar uma indisponibilidade da instância.
      Intervalo de repetição Período que deve passar antes que a importação se repita. Visível somente se você definir Executar como Periodicamente.
      Iniciando Data em que a importação deve começar (selecionada usando o ícone de seleção de data e hora ( Selecionar data e hora). Visível somente se você definir Executar como Periodicamente.
      Primário(a) O conjunto de importação primário ao qual este conjunto de importação pertence e após o qual esta importação deve ser executada. Visível somente se você definir Executar como Após execuções primárias.
      Condicional Opção para especificar um script que define as condições que devem ser avaliadas como verdadeiras antes que a importação seja executada.
      Condição Script que avalia se uma importação deve ser executada. Visível somente se você selecionar Condicional.
      Importação simultânea Opção para executar uma importação simultânea. Uma importação simultânea divide os dados em vários conjuntos para importação e executa os conjuntos para importação simultaneamente para reduzir o tempo de processamento de grandes conjuntos de dados.
      Nota:
      Uma importação simultânea não transforma dados em uma ordem previsível. Se a ordem for importante, não execute uma importação simultânea.

      Para obter mais informações, consulte Importações simultâneas.

      Método de Partição Método usado para alocar cada registro de conjunto de dados para um conjunto de importação:
      • Round Robin: o sistema define as partições automaticamente.

        Suponha que haja 20 registros e 4 conjuntos para importação. O sistema aloca o registro 1 para o conjunto de importação 1, o registro 2 para o conjunto de importação 2, o registro 3 para o conjunto de importação 3 e o registro 4 para o conjunto de importação 4. O sistema então aloca o registro 5 para o conjunto de importação 1, o registro 6 para o conjunto de importação 2, o registro 7 para o conjunto de importação 3 e o registro 8 para o conjunto de importação 4. Esse padrão continua até que todos os registros sejam atribuídos aos conjuntos para importação.

        Quando a alocação termina, o conjunto de importação 1 contém os registros 1, 5, 9, 13, 17. O conjunto de importação 2 contém os registros 2, 6, 10, 14, 18. O conjunto de importação 3 contém os registros 3, 7, 11, 15 e 19. O conjunto de importação 4 contém os registros 4, 8, 12, 16 e 20.

      • Script personalizado: define as partições com um script de partição fornecido por você.
      • Tamanho personalizado: define o tamanho da partição para o tamanho de partição especificado.

        Depois que o sistema processa a primeira partição, os dados dessa partição podem ser transformados, mesmo que as outras partições não tenham concluído o processamento.

      Script de Partição Script usado para retornar uma chave de partição. O sistema garante que as linhas do conjunto de dados com a mesma chave de partição sejam enviadas para o mesmo conjunto de importação.

      Visível somente se você definir o Método de partição como Script personalizado.

      Tamanho da Partição O número de registros em cada partição.

      Visível somente se você selecionar um Método de partição de Tamanho personalizado.

      Executar script de pré-importação Opção para especificar um script a ser executado antes que a importação aconteça.
      Prescripto Script a ser executado antes das importações de dados. Visível somente se você selecionar Executar script de pré-importação.
      Executar script de pós-importação Opção para executar um script após a importação.
      Post script Script a ser executado após a importação. Visível somente se você selecionar Executar script de pós-importação.
      Nota:
      Para importações simultâneas, o script é executado após a conclusão do último trabalho Import Set Transformer.
    4. Clique em Enviar.
    5. Para interromper uma importação que está demorando muito, navegue até Conjuntos para importação do sistema > Avançado > Andamento.
      1. Abra o trabalhador de andamento que você deve cancelar.
      2. Clique no link relacionado Cancelar trabalho.
    6. Para exibir uma lista de registros de execuções, clique em Execuções.
    7. Na lista Execuções, selecione o registro de execução que você deseja exibir.

      O registro de execução mostra:

      • O número de execução.
      • O nome da importação programada.
      • O nome do conjunto de importação.
      • O número do contexto de execução.
    8. Para exibir detalhes sobre as execuções, selecione o registro de contextos de execuções que você deseja exibir.