Skip to main content

Ferramenta União

Use a ferramenta União para combinar dois ou mais conjuntos de dados com base nos nomes ou na posição das colunas.

Na saída, cada coluna contém as linhas de cada entrada. Você pode configurar como essas colunas são empilhadas ou combinadas.

Dica

Esta ferramenta tem um fluxo de trabalho de exemplo. Visite Exemplos de fluxos de trabalho para saber como acessar esse e muitos outros exemplos diretamente no Designer Cloud.

Componentes da ferramenta

Union tool anchors.png

Figura: ferramenta União com duas âncoras.

A ferramenta União tem duas âncoras:

  • Âncora de entrada: a âncora de entrada se conecta aos fluxos de dados que você deseja unificar. Os dois colchetes angulares ilustrados na âncora indicam que a ferramenta aceita múltiplas entradas.

  • Âncora de saída: a âncora de saída exibe o conjunto de dados de saída.

Configurar a ferramenta

Empilhar colunas verticalmente usando : selecione como empilhar as colunas. A configuração padrão é configurar automaticamente pelo nome da coluna .

  • Nome : empilha os dados com base no nome das colunas.

  • Posição : empilha os dados com base na ordem das colunas do fluxo.

  • Configuração manual : permite especificar manualmente como os dados devem ser empilhados. Quando esse método é escolhido, as colunas de cada entrada são exibidas (as entradas são indicadas pelas linhas #1, #2 etc.). Você pode Redefinir uma tabela Por posição ou Por nome .

Atenção

Quando o modo é definido para Configuração manual , o Designer Cloud pressupõe que a configuração não será alterada entre o momento da configuração da ferramenta e o momento em que o fluxo de trabalho for executado. Se algo estiver faltando, um erro é gerado e o fluxo de trabalho é interrompido.

Configuração manual de campos

Para o método de Configuração manual é preciso configurar as propriedades de Saída .

Para começar, os fluxos de dados são empilhados de maneira irregular horizontal e verticalmente para que os dados de cada entrada estejam em células diferentes.

  1. (Opcional) No menu suspenso Redefinir , você pode selecionar Por posição ou Por nome . Clique em Redefinir para redefinir as colunas. Use essa opção se você sabe que seus fluxos de dados têm algumas colunas que correspondem entre si por posição ou por nome.

  2. Em seguida, use as setas para começar a empilhar seus dados. Selecione uma célula e clique nas setas para a esquerda ou para a direita para dispor essa célula no campo a que corresponde.

Propriedades

Quando as colunas diferirem

Para os modos de configuração automática, você tem que selecionar como lidar com colunas que diferem.

  • Aviso (continuar o processamento dos dados) : gera um aviso na grade de resultados, mas continua o processamento das linhas.

  • Erro (interromper o processamento dos dados) : gera um erro na grade de resultados e interrompe o processamento dos registros.

  • Ignorar (continuar o processamento dos dados) : ignora as colunas que diferem e continua o processamento das linhas.

Opções de saída das colunas

  • Gerar todas as colunas : a saída inclui todas as colunas. Valores nulos preenchem colunas vazias.

  • Gerar apenas as colunas em comum : a saída inclui somente as colunas que todas as entradas têm em comum.

Ordem de saída

Na seção Ordem de saída , marque Especificar  para especificar qual dos conjuntos de dados de entrada deve ser exibido primeiro na saída. Após marcar essa caixa, selecione e mantenha pressionado o ícone de reorganização na tabela e arraste a conexão para cima ou para baixo.

Atenção

A opção Especificar ordem de saída pode tornar o desempenho mais lento.

Entendendo a saída

É importante entender dois aspectos da saída da ferramenta União: os nomes das colunas e a ordem dos dados.

Entendendo os nomes das colunas nos dados de saída

Os nomes das colunas que são usados no conjunto de dados de saída são obtidos do fluxo de entrada com o primeiro valor alfanumérico.

Por padrão, os fluxos de dados de entrada são rotulados #1 e #2 com base na ordem em que você os conecta à âncora de entrada da ferramenta União. Assim, quando os nomes das colunas forem diferentes, o conjunto de dados de saída usa o nome das colunas do conjunto de entrada #1.

Se preferir usar os nomes das colunas do conjunto de entrada #2, altere o nome das conexões de entrada. Clique nos fluxos de entrada e insira os novos valores. Os nomes das colunas na saída são extraídos da conexão que apresenta o primeiro valor alfabético/numérico em seu nome.

union-change-connection-name.png

Figura: alterar a fonte de entrada para os nomes das colunas de saída.

Entendendo a ordem dos dados de saída

A ordem padrão da saída corresponde à ordem em que você conectou seus conjuntos de dados à âncora de entrada da ferramenta União. Visite a sessão "Ordem de saída" para saber como alterar a ordem dos seus dados de saída.