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

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 campo 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.
      • importLog: O log 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 onAfter script 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, este parâmetro acessa dados transformados depois que são inseridos na tabela de destino. Quando um registro é inserido ou atualizado, ele tem um sys_id.
      • importLog: O log 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 repete os 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 Integration Hub - Importar.
    • Se sua tabela ou aplicação de destino estiver relacionada ao CMDB, use IntegrationHub ETLexperiência assistida.