Comando APPEND

Combina registros de duas ou mais tabelas do Analytics anexando-os em uma nova tabela do Analytics.

Sintaxe

APPEND tabela_1; tabela_2; <...n> TO nome_tabela <COMMONFIELDS> <OPEN> <ASCHAR> <ALLCHAR>

Parâmetros

Exemplos

APPEND Trans_Jan; Trans_Fev; Trans_Mar TO Trans_T1

APPEND Funcionários_central; Funcionários_leste; Funcionários_oeste TO Funcionários_mestre COMMONFIELDS

APPEND Funcionários_central; Funcionários_leste; Funcionários_oeste TO Funcionários_mestre ASCHAR

APPEND Funcionários_central; Funcionários_leste; Funcionários_oeste TO Funcionários_mestre ALLCHAR

Observações

Como funciona?

O comando APPEND combina registros de duas ou mais tabelas anexando-os e criando uma nova tabela. Anexar significa adicionar um grupo de registros na parte inferior de outro grupo de registros.

Campos da tabela de origem com nomes físicos idênticos e categorias de dados idênticas são diretamente anexados uns aos outros.

Campos com nomes físicos únicos em todas as tabelas de origem são adicionados à tabela de saída, mas não são diretamente anexados a nenhum outro campo.

Quando usar APPEND

Use APPEND quando quiser combinar dados de várias tabelas com uma estrutura idêntica ou similar. Por exemplo, APPEND é uma boa escolha para combinar tabelas mensais ou trimestrais em uma tabela anual.

Não é um substituto para JOIN ou DEFINE RELATION

APPEND geralmente não é substituto do comando JOIN ou DEFINE RELATION, pois não permite que você inclua ou exclua registros com base em valores correspondentes ou não correspondentes em um campo-chave comum. Com APPEND, todos os registros de cada tabela de origem são incluídos na tabela de saída.

Anexação de tabelas totalmente diferentes

Você pode anexar tabelas totalmente diferentes, isso é, duas ou mais tabelas que não tenham nenhum campo em comum. Embora não seja o uso principal pretendido para o comando APPEND, pode haver situações em que anexar tabelas diferentes serve para uma finalidade analítica.

Anexação de campos de datahora

Para dois ou mais campos de datahora serem anexados, as seguintes condições devem ser atendidas:

• nomes físicos idênticos
• categoria de dados idêntica (datahora)
• subtipos de dados idênticos (data, datahora ou hora)
• uso idêntico do indicador de fuso horário, usado ou não usado, por todos os campos a serem anexados

Se dois campos de datahora tiverem nome idêntico, mas não atenderem a uma das outras condições, uma mensagem de erro é exibida e o comando APPEND não é executado.

A mensagem de erro contém todas as condições de falha no conjunto de tabelas especificado por APPEND. A mensagem é salva no log de comando.

Harmonização automática

Em algumas situações, o comando APPEND harmoniza automaticamente os campos para anexá-los:

Quando a harmonização automática não é realizada

O Analytics não harmoniza automaticamente os campos nas seguintes situações. Uma mensagem de erro é exibida e a operação anexar não é executada.

• Dois campos com um nome idêntico pertencem a diferentes categorias de dados.
• Dois campos datahora com um nome idêntico pertencem a diferentes subtipos de datahora (data, datahora ou hora).
• Dois campos datahora com um nome idêntico são inconsistentes na maneira que usam o indicador de fuso horário.

Campos calculados não são compatíveis

O comando APPEND não é compatível com a anexação de campos calculados. Ao anexar tabelas, todos os campos calculados nas tabelas são automaticamente excluídos da tabela de saída.

Se um campo calculado em uma tabela de origem tiver o mesmo nome que um campo físico em outra tabela de origem, uma mensagem de erro será exibida e o comando APPEND não será executado.

Campos de nota de registro não são compatíveis

O comando APPEND não é compatível com a anexação de campos de notas de registros. Ao anexar tabelas, todos os campos de nota de registro nas tabelas de origem são automaticamente excluídos da tabela de saída.

Se um campo de nota de registro em uma tabela de origem tiver o mesmo nome que um campo físico em outra tabela de origem, uma mensagem de erro será exibida e o comando APPEND não será executado.

Um campo de nota de registro é automaticamente gerado pelo Analytics ao anexar uma nota a um registro.

Comprimento de registro

Se incluir todos os campos de todas as tabelas de origem ao anexar, o comprimento de registro na tabela de saída poderá ser maior que o registro mais longo nas tabelas de origem.

Uma mensagem de erro é exibida se o comprimento de registro de saída ultrapassar o máximo de 32 KB do Analytics.

Anexação e casas decimais

Comportamento específico rege a anexação de campos numéricos que incluem casas decimais.

Configuração decimal

O comando APPEND usa o número de casas decimais definido na configuração Dec na definição de campo no layout da tabela.

Configurações decimais inconsistentes

Se os campos numéricos anexados tiverem configurações Dec inconsistentes, os campos serão convertidos para o tipo de dados ACL e automaticamente harmonizados na configuração mais longa de Dec.

Qualquer casa decimal nos arquivos de dados de origem que ultrapasse a configuração Dec mais longa é excluída da tabela de saída gerada por APPEND.

Configuração decimal consistente

Se os campos numéricos anexados tiverem uma configuração Dec consistente, nenhuma conversão de tipo de dados ou harmonização ocorrerá.

Qualquer casa decimal nos arquivos de dados de origem que ultrapasse a configuração Dec é incluída da tabela de saída gerada por APPEND.

Ordenação

Qualquer ordem de classificação existente nas tabelas de origem é mantida separadamente nos respectivos conjuntos de registros na tabela de saída.

Mesmo se todos os registros em todas as tabelas de origem forem ordenados, a tabela de saída é considerada não ordenada, pois os registros de origem são anexados como grupos, sem considerar nenhuma ordem de classificação existente nas tabelas de origem.

Por exemplo, se você anexar tabelas mensalmente ou trimestralmente para criar uma tabela anual, toda a ordenação interna dos dados mensais ou trimestrais é mantida. Se necessário, é possível ordenar a tabela de saída depois de realizar a operação de anexação.

Como funciona a ordem do campo

Campos comuns

Campos comuns em tabelas de origem não têm de estar na mesma ordem para ser anexados.

Por exemplo, esses campos são corretamente anexados, mesmo se estiverem em uma ordem diferente:

A primeira tabela especificada no comando APPEND dita a ordem dos campos na tabela de saída. Portanto, no exemplo acima, a ordem na tabela de saída é:

• Sobrenome | Nome | Nome_do_meio

Campos não comuns

Campos não comuns nas tabelas de origem aparecem na tabela de saída na ordem em que aparecem no grupo selecionado de tabelas de origem.

Por exemplo, ao anexar essas duas tabelas:

a ordem da tabela de saída é:

• Título | Sobrenome | Nome | Nome_do_meio | Data_de_nascimento

Título de coluna alternativo

Títulos de coluna alternados nas tabelas de origem aparecem na tabela de saída. Se mais de uma tabela de origem tiver um título alternativo da coluna para o mesmo campo, o título da primeira tabela selecionada tem precedência.