Criar definições de carga de transformação de extração (ETL)

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • Crie definições de ETL para extrair dados de uma tabela de origem, transformar os dados conforme desejado e carregar os dados em várias tabelas de destino. As definições de ETL também são compatíveis com estruturas de dados aninhadas.

    Antes de Iniciar

    Função necessária: Import_transformer

    Procedimento

    1. Navegar até Tudo > Conjuntos para importação do sistema > Administração > Definições ETL.
    2. Clique em Nova.
    3. Preencha o formulário.
      Campo Descrição
      Nome Nome da definição de ETL.
      Descrição Descrição da definição de ETL.
      Copiar campos vazios Opção para copiar valores de campos vazios. Se os dados de entrada tiverem um campo com um valor vazio, você poderá copiar o valor vazio ou ignorá-lo e manter o valor existente.
      Execute o script onBefore Opção para executar um script antes de inserir ou atualizar dados.
      O script onBefore tem três parâmetros.
      • source: Os dados de origem do registro de importação.
      • target: Os dados transformados do registro de importação. No script onBefore, este parâmetro acessa dados transformados antes de serem inseridos na tabela de destino.
      • importLogLog que registra informações sobre a atividade de importação de dados.
      O script onBefore tem duas variáveis.
      • ignore. Tipo: Booliano. Quando verdadeiro , a linha do conjunto de importação especificado é ignorada.
      • ignore_reason. Tipo: cadeia de caracteres. Mensagem descrevendo por que a linha do conjunto de importação foi ignorada.
      Execute o script onAfter Opção para executar um script após inserir ou atualizar dados.
      O script onAfter tem três parâmetros.
      • source: Os dados de origem do registro de importação.
      • target: Os dados transformados do registro de importação. No script onAfter, esse parâmetro acessa dados transformados depois que eles são inseridos na tabela de destino. Quando um registro é inserido ou atualizado, ele tem um sys_id.
      • importLogLog que registra informações sobre a atividade de importação de dados.
      Aplicação Escopo da aplicação para este registro.
      Ativo Selecionado se a definição de ETL estiver ativa. Se a definição de ETL não estiver ativa.
    4. Clique em Enviar.

    Exemplo

    Neste exemplo, a Definição de ETL para trabalhador tem um script onBefore e onAfter. No script onBefore, o registro de origem com um ID de 124 é ignorado porque esse trabalhador já se demitiu. Os dados de origem e de destino são gravados no log de importação. Por fim, o script itera por meio dos valores transformados da tabela sn_etl_demo_worker para obter o ID e o nome de cada trabalhador e registrá-los no log de importação.

    No script onAfter, os dados de origem e de destino são gravados no log de importação. Novamente, o script itera por meio dos valores transformados da tabela sn_etl_demo_worker. Agora que os dados foram inseridos na tabela de destino, cada registro tem um sys_id. O script registra o SYS ID, ID e nome de cada trabalhador no log de importação.

    Exemplo de definição de ETL com scripts onBefore e onAfter.
    Nota:
    • Para criar essas definições e mapeamento usando uma experiência assistida ou passo a passo, consulte IntegrationHub - Importar.
    • Se sua tabela ou aplicação de destino estiver relacionada ao CMDB, use IntegrationHub ETL experiência assistida.