Comando EXTRACT
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 nome_exibição> <...n>|FIELDS ALL} TO nome_tabela <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <EOF> <APPEND> <OPEN> <LOCAL>
Parâmetros
| Nome | Descrição |
|---|---|
| RECORD | FIELDS nome_campo | FIELDS ALL |
Os campos a serem incluídos na saída:
|
| AS nome_exibicao opcional |
Usado apenas na extração com FIELDS nome_campo. O nome de exibição (título alternativo da coluna) para o campo na exibição na nova tabela do Analytics. Se você quiser que o nome de exibição seja o mesmo que o nome do campo ou um nome de exibição já existente na tabela de origem, não use AS. Especifique nome_exibicao como uma cadeia entre aspas. Utilize um ponto e vírgula (;) entre palavras se quiser uma quebra de linha no título da coluna. Nota
O parâmetro AS funciona apenas para extração para uma nova tabela. Se estiver adicionando a uma tabela existente, os títulos de coluna alternativos na tabela existente prevalecem. |
| TO nome_tabela |
A localização para onde enviar os resultados do comando:
|
|
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:
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:
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. |
|
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. |
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
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"
Criação de nomes de exibição para campos extraídos
Extraia três campos da tabela AR_Cliente e criação de 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"
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
Nota
Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.
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 () cria um novo layout da tabela que permanece associado ao arquivo de dados de origem original. Não é criado um novo arquivo de dados.
Guia de scripting do ACL 14.1