Comando EXTRACT

Informações do conceito

Extrai dados de uma tabela do Analytics e usa esses dados para gerar uma nova tabela do Analytics ou anexá-los a uma tabela do Analytics existente. É possível extrair todos os registros ou campos selecionados.

Sintaxe

EXTRACT {RECORD|FIELDS nome_campo <AS novo_nome_campo> <...n>|FIELDS ALL} <nome_tabela_relacionada.ALL <...n>> <EXCLUDE nome_campo <...n>> TO nome_tabela <LOCAL> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <EOF> <APPEND> <OPEN>

Parâmetros

Nome	Descrição
RECORD \| FIELDS nome_campo \| FIELDS ALL	Os campos a serem incluídos na saída: RECORD use todos os campos no arquivo de dados de origem: todos os campos da tabela e todas as porções indefinidas do registro Os campos são usados na ordem em que aparecem no layout da tabela. Preserva campos calculados. FIELDS nomes_campos usar os campos especificados Os campos são usados na ordem em que são listados. Para usar um campo de uma tabela relacionada, especifique nome_tabela_relacionada.nome_campo. Converte campos calculados em campos físicos com o tipo de dados apropriado na tabela destino – ASCII ou Unicode (dependendo da edição do Analytics), ACL (o tipo de dados numérico nativo), datahora ou lógico. Preenche os campos físicos com os valores calculados reais. FIELDS ALL usar todos os campos da tabela Os campos são usados na ordem em que aparecem no layout da tabela. Converte campos calculados em campos físicos com o tipo de dados apropriado na tabela destino – ASCII ou Unicode (dependendo da edição do Analytics), ACL (o tipo de dados numérico nativo), datahora ou lógico. Preenche os campos físicos com os valores calculados reais.
AS novo_nome_campo opcional	Válido apenas na extração com FIELDS nome_campo. O novo nome físico e o nome de exibição (título alternativo da coluna) para o campo na tabela de saída. Qualquer caractere especial ou espaço especificado é mantido no nome de exibição e convertido automaticamente para sublinhados ( _ ) no nome de campo físico no layout da tabela. Especifique novo_nome_campo como uma cadeia entre aspas. Use um ponto e vírgula (;) entre as palavras se quiser uma quebra de linha no nome de exibição. Nota O parâmetro AS funciona apenas para extração para uma nova tabela. Se você estiver adicionando a uma tabela existente, os nomes de campo físicos e os nomes de exibição nessa tabela terão prioridade.
nome_tabela_relacionada.ALL opcional	Use todos os campos na tabela relacionada especificada.
EXCLUDE nome_campo opcional	Válido apenas ao extrair usando FIELDS ALL ou nome_tabela_relacionada.ALL. O campo ou os campos a serem excluídos do comando. EXCLUDE permite ajustar a palavra-chave ALL, excluindo os campos especificados. EXCLUDE deve seguir FIELDS ALL imediatamente ou a última ocorrência da palavra-chave ALL se você estiver incluindo campos de uma ou mais tabelas relacionadas. Por exemplo: FIELDS ALL EXCLUDE campo_1 campo_2 FIELDS ALL nome_tabela_relacionada.ALL EXCLUDE campo_1 campo_2
TO nome_tabela	A localização para onde enviar os resultados do comando: nome_tabela salva os resultados em uma tabela do Analytics Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL" Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente: TO "C:\Saída.FIL" TO "Resultados\Saída.FIL" Nota Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.
LOCAL opcional	Salva o arquivo de saída no mesmo local que o projeto do Analytics. Nota Aplicável apenas na execução de um comando em uma tabela de servidor com um campo de saída que é uma tabela do Analytics. O parâmetro LOCAL deve seguir imediatamente o parâmetro TO.
IF teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição. Nota O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).
WHILE teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado. Nota Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.
FIRST intervalo \| NEXT intervalo opcional	O número de registros a ser processado: FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado Use intervalo para especificar o número de registros a serem processados. Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.
EOF opcional	Execute o comando uma ou mais vezes após alcançar o fim do arquivo. Isso garante que o registro final na tabela seja processado dentro de um comando GROUP. Use EOF somente se todos os campos forem campos calculados referentes a registros anteriores.
APPEND opcional	Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo. Nota Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos: os mesmos campos a mesma ordem de campos os campos correspondentes têm o mesmo comprimento os campos correspondentes têm o mesmo tipo de dados O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.
OPEN opcional	Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.

Exemplos

Extração de todos os registros de uma tabela para uma nova tabela

Crie uma duplicata exata da tabela AR_Cliente extraindo todos os registros para uma nova tabela do Analytics. Todos os campos calculados são preservados como campos calculados:

OPEN AR_Cliente
EXTRACT RECORD TO "AR_Cliente_2"

Extração de todos os campos de uma tabela para uma nova tabela

Extraia todos os campos definidos da tabela AR_Cliente para uma nova tabela do Analytics. Todos os campos calculados são convertidos em campos físicos e preenchidos com os valores calculados reais:

OPEN AR_Cliente
EXTRACT FIELDS ALL TO "AR_Cliente_2"

Extração de todos os registros de uma tabela e anexação desses registros a uma tabela existente

Extraia todos os registros na tabela AR_Cliente e anexe-os como grupo ao final da tabela AR_Cliente_Mestre:

OPEN AR_Cliente
EXTRACT RECORD TO "AR_Cliente_Mestre" APPEND

Extração de todos os registros de uma tabela e anexação desses registros a uma tabela existente em uma pasta diferente

Extraia todos os registros na tabela AR_Cliente e anexe-os como grupo ao final da tabela AR_Cliente_Mestre, que está em uma pasta diferente da pasta do projeto do Analytics:

OPEN AR_Cliente
EXTRACT RECORD TO "C:\Usuários\Dados do cliente\AR_Cliente_Mestre" APPEND

Extração de um subconjunto de campos de uma tabela para uma nova tabela

Você tem duas opções ao extrair um subconjunto dos campos de uma tabela:

especificar os campos individuais a serem extraídos
especificar FIELDS ALL e especificar os campos a serem excluídos da extração

Dica

Use o método menos trabalhoso.

Os exemplos abaixo se referem à tabela AR_Cliente, que tem sete campos:

número de referência
número do cliente
nome do cliente
tipo de transação
data da fatura
data de vencimento
valor da fatura

Especificar os campos a extrair

Extraia três campos da tabela AR_Cliente para uma nova tabela do Analytics:

OPEN AR_Cliente
EXTRACT FIELDS Nome Prazo Data TO "AR_Datas_Cliente.fil"

Especificar FIELDS ALL e especificar os campos a serem excluídos

Você extrai todos os campos, exceto o campo num_referência, da tabela AR_Cliente para uma nova tabela do Analytics:

OPEN AR_Cliente
EXTRACT FIELDS ALL EXCLUDE num_referência TO "AR_Datas_Cliente.fil"

Criação de novos nomes para campos extraídos

Extraia três campos da tabela AR_Cliente e crie novos nomes físicos e nomes de exibição para os campos na nova tabela do Analytics:

OPEN AR_Cliente
EXTRACT FIELDS Nome AS "Cliente;Nome" Prazo AS "Prazo;Limite" Data AS "Data;Fatura" TO "AR_Datas_Cliente.fil"

O ponto e vírgula (;) entre as palavras cria uma quebra de linha nos nomes de exibição. O ponto e vírgula é convertido automaticamente para sublinhado ( _ ) nos nomes de campo físicos.

Extração de campos com base em uma condição

Extraia três campos da tabela AR_Cliente para uma nova tabela do Analytics se a data no campo Prazo for anterior a 1º de julho de 2014:

OPEN AR_Cliente
EXTRACT FIELDS Nome Prazo Data IF Prazo < `20140701` TO "Vencidos.fil"

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Extrair dados ou Extrair e anexar dados.

EXTRACT vs. cópia de tabela

O EXTRACT cria um novo arquivo de dados de origem (.fil)e um novo layout da tabela.

A cópia de uma tabela usando o Navegador (Editar > Cópia) cria um novo layout da tabela que permanece associado ao arquivo de dados de origem original. Não é criado um novo arquivo de dados.