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

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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 oferecem suporte a estruturas de dados aninhadas.

    Antes de Iniciar

    Função necessária: import_transformer

    Procedimento

    1. Navegar até Todos > 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.
      Executar 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 os dados transformados antes que eles sejam 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 especificada é ignorada.
      • ignore_reason. Tipo: cadeia de caracteres. Mensagem que descreve o motivo pelo qual a linha do conjunto de importação foi ignorada.
      Executar 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, este parâmetro acessa os dados transformados depois que eles são inseridos na tabela de destino. Depois que 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. Desmarcado 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á foi demitido. Os dados de origem e os dados 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. O script itera novamente 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, o ID e o 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 guiada ou passo a passo, consulte Integration Hub - Importar.
    • Se a sua tabela de destino ou aplicação estiver relacionada ao CMDB, use a experiência orientada IntegrationHub ETL.