Comando IMPORT MULTIDELIMITED

Cria várias tabelas do Analytics definindo e importando várias planilhas do Microsoft Excel.

Sintaxe

IMPORT MULTIDELIMITED <TO pasta_importação> FROM {nome_arquivo_origem|pasta_origem} codificação_caracteres_origem SEPARATOR {carac|TAB|SPACE} QUALIFIER {carac|NONE} <CONSECUTIVE> STARTLINE número_linha <KEEPTITLE> <CRCLEAR> <LFCLEAR> <REPLACENULL> <ALLCHAR>

Nota

Você deve especificar os parâmetros de IMPORT MULTIDELIMITED exatamente na mesma ordem mostrada acima e na tabela abaixo.

Para importar vários arquivos delimitados corretamente, a estrutura de todos os arquivos deve ser consistente antes da importação.

Para obter mais informações, consulte Estrutura de arquivos consistente obrigatória.

Parâmetros

Nome Descrição
TO pasta_importação

opcional

A pasta onde os dados serão importados.

Para especificar a pasta, use um caminho de arquivo absoluto ou relativo à pasta que contém o projeto do Analytics. Especifique pasta_importação como uma cadeia entre aspas.

Exemplo

TO "C:\Auditoria de pontos de venda\Dados\Dados de trabalho das transações"
TO "Dados\Dados de trabalho das transações"

Se você omitir TO, os dados serão importados na pasta que contém o projeto do Analytics.

FROM nome_arquivo_origem | pasta_origem

O nome dos arquivos de dados de origem, ou a pasta que contém esses arquivos.

Especifique nome_arquivo_origem ou pasta_origem como uma cadeia entre aspas.

O comando permite a importação de quatro tipos de arquivos delimitados:

  • *.csv
  • *.dat
  • *.del
  • *.txt

Arquivos de dados de origem na pasta raiz do projeto do Analytics

Para especificar vários arquivos, use um curinga (*) no lugar de caracteres únicos em nomes de arquivos. O caractere curinga representa zero (0) ou mais ocorrências de qualquer letra, número ou caractere especial.

Exemplo

FROM "Transações_AF*.csv"

seleciona:

Transactions_AF18.csv

Transactions_AF17.csv

Você pode usar um curinga em mais de um local em um nome de arquivo e em uma extensão de arquivo.

Exemplo

FROM "Transações_AF*.*"

seleciona:

Transactions_AF18.txt

Transactions_AF17.csv

Arquivos de dados de origem fora da pasta raiz do projeto do Analytics

Se os arquivos de dados de origem não estão localizados na mesma pasta do projeto do Analytics, você deve usar um caminho de arquivo absoluto ou relativo à pasta que contém o projeto para especificar a localização dos arquivos.

Exemplo

FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações\Transações_AF*.csv"
FROM "Dados\Arquivos mestre de transações\Transações_AF*.csv"

Pasta que contém os arquivos de dados de origem

Em vez de especificar nomes de arquivos, basta especificar o nome da pasta que contém os arquivos de dados de origem. Todos os tipos de arquivos delimitados permitidos na pasta são importados (*.csv, *.dat, *.del, *.txt).

Para especificar uma pasta de dados de origem, use um caminho de arquivo absoluto ou relativo à pasta que contém o projeto do Analytics.

Exemplo

FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações"
FROM "Dados\Arquivos mestre de transações"
codificação_caracteres_origem

O conjunto de caracteres e a codificação dos dados de origem.

Dependendo da edição do Analytics usada e da codificação dos dados de origem, use uma das seguintes opções:

Código Edição do Analytics Codificação dos dados de origem
0

Edição não Unicode

 todos os dados
0

Edição Unicode

 Dados ASCII
2 Edição Unicode dados Unicode, codificação UTF-16 LE
3 código_numérico Edição Unicode

Dados Unicode que não usam a codificação UTF-16 LE

Para determinar o código numérico correspondente à codificação dos dados de origem, execute uma importação usando o Assistente de Definição de Dados, selecione a opção Texto codificado e encontre a codificação na lista suspensa.

Para especificar o código, especifique 3, acrescente um espaço e, em seguida, o código numérico.

Nota

Se você não especificar um código, o Analytics não Unicode automaticamente usará 0 e o Analytics Unicode, 2 .
SEPARATOR caractere | TAB | SPACE

O caractere separador (delimitador) usado entre campos nos dados de origem. É preciso especificar o caractere como uma cadeia entre aspas.

Você pode especificar um separador tabulação ou espaço digitando o caractere entre aspas ou usando uma palavra-chave:

  • SEPARATOR "   " ou SEPARATOR TAB
  • SEPARATOR " " ou SEPARATOR SPACE
QUALIFIER caractere | NONE

O caractere qualificador de texto para os dados de origem. Os valores dos campos desses dados são colocados entre caracteres qualificadores para identificação. É preciso especificar o caractere como uma cadeia entre aspas.

Para especificar o caractere aspas como um qualificador de texto, coloque o caractere entre apóstrofos: QUALIFIER '"'.

Você pode especificar que não há qualificadores de texto usando um dos seguintes métodos:

  • QUALIFIER ""
  • QUALIFIER NONE

CONSECUTIVE

opcional

Qualificadores consecutivos de texto devem ser tratados como um único qualificador.
STARTLINE número_linha

A linha em que começam os dados.

Por exemplo, se as primeiras quatro linhas de dados contiverem informações de cabeçalho indesejadas, especifique 5 como número_linha.

Nota

O ideal é que a linha inicial dos dados seja a mesma em todos os arquivos delimitados importados com uma única execução de IMPORT MULTIDELIMITED.

Se as linhas iniciais forem diferentes, consulte Estrutura de arquivos consistente obrigatória.
KEEPTITLE

opcional

Trate o número de linha especificado por STARTLINE como nomes de campos em vez de dados. Se você omitir KEEPTITLE, serão usados nomes de campo genéricos.

Nota

Os nomes dos campos devem estar no mesmo número de linha em todos os arquivos delimitados importados com uma única execução de IMPORT MULTIDELIMITED.

Se os nomes de campos estiverem em números de linha diferentes, consulte Estrutura de arquivos consistente obrigatória.
CRCLEAR

opcional

Substitui todos os caracteres CR (retorno de carro) que ocorrem entre qualificadores de texto por caracteres de espaço. Você deve especificar QUALIFIER com um valor caractere para usar CRCLEAR.

Se você usar CRCLEAR e LFCLEAR, CRCLEAR deve ser o primeiro.
LFCLEAR

opcional

Substitui todos os caracteres LF (quebra de linha) que ocorrem entre qualificadores de texto por caracteres de espaço. Você deve especificar QUALIFIER com um valor caractere para usar LFCLEAR.

Se você usar CRCLEAR e LFCLEAR, CRCLEAR deve ser o primeiro.
REPLACENULL

opcional

Substitui todos os caracteres NUL que ocorrem no arquivo delimitado por caracteres de espaço. O número dos caracteres NUL substituídos é gravado no log.
ALLCHAR

opcional

O tipo de dados caractere é atribuído automaticamente a todos os campos importados.

Dica

A atribuição do tipo de dados caractere a todos os campos importados simplifica o processo de importação de arquivos texto delimitados. Quando os dados estiverem no Analytics, você poderá atribuir aos campos tipos de dados diferentes, como numérico ou datahora, e especificar detalhes de formato.

ALLCHAR é útil na importação de uma tabela com campos identificadores com o tipo de dados numérico atribuído automaticamente pelo Analytics, quando na verdade o tipo de dados deveria ser caractere.

Exemplos

Os exemplos abaixo supõem que você tem dados de transações mensais armazenados em 12 arquivos do Excel:

  • Transações_Jan.csv a Transações_Dez.csv

Nota

Uma tabela do Analytics separada será criada para cada planilha ou arquivo nomeado que você importar.

Importar todos os arquivos delimitados

Você quer importar todos os 12 arquivos delimitados. O símbolo de curinga (*) é usado onde o nome do mês ocorre em cada nome de arquivo.

O Analytics tenta atribuir o tipo de dados apropriado a cada campo.

IMPORT MULTIDELIMITED FROM "Transações_*.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE

Importar todos os arquivos delimitados como dados de caracteres

Este exemplo é o mesmo exemplo acima, exceto que o Analytics atribui automaticamente o tipo de dados de caracteres a todos os campos importados.

IMPORT MULTIDELIMITED FROM "Transações_*.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR

Importar todos os arquivos delimitados da pasta especificada

Você quer importar todos os arquivos delimitados na pasta C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações.

IMPORT MULTIDELIMITED FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE

Importar todos os arquivos delimitados na pasta especificada e salvar as tabelas do Analytics em outra pasta

Este exemplo é o mesmo exemplo acima, mas em vez de salvar as tabelas do Analytics na pasta raiz do projeto, você quer salvá-las na pasta "C:\Auditoria de pontos de venda\Dados\Dados de trabalho das transações".

IMPORT MULTIDELIMITED TO "C:\Auditoria de pontos de venda\Dados\Dados de trabalho das transações" FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE

Observações

Estrutura de arquivos consistente obrigatória

Para importar um grupo de arquivos delimitados corretamente usando IMPORT MULTIDELIMITED, a estrutura de todos os arquivos do grupo deve ser consistente.

Você pode importar arquivos delimitados com estruturas inconsistentes e depois limpar e padronizar os dados no Analytics. No entanto, essa abordagem é trabalhosa. Em muitos casos, é mais fácil tornar os arquivos delimitados consistentes antes da importação.

Para importar vários arquivos delimitados corretamente, os itens a seguir devem ser consistentes em todos os arquivos:

Item Palavra-chave do ACLScript Problema Solução

O conjunto de caracteres e a codificação dos dados de origem

 código numérico

(somente para edição Unicode do Analytics)

Os arquivos de origem delimitados usam codificações de caracteres diferentes. Por exemplo, alguns arquivos têm a codificação ASCII e outros têm a codificação Unicode.

 Agrupe os arquivos de origem pelo tipo de codificação e faça uma importação separada para cada grupo.
Caractere delimitador SEPARATOR Os arquivos de origem delimitados usam um caractere separador diferente (delimitador) entre os campos.

Execute uma das seguintes ações:

  • Padronize o caractere separador nos arquivos de origem antes de importá-los.
  • Agrupe os arquivos de origem pelo caractere separador e faça uma importação separada para cada grupo.
Caractere qualificador de texto QUALIFIER Os arquivos de origem delimitados usam um caractere qualificador de texto diferente para envolver e identificar os valores de campo.

Execute uma das seguintes ações:

  • Padronize o caractere qualificador nos arquivos de origem antes de importá-los.
  • Agrupe os arquivos de origem pelo caractere qualificador e faça uma importação separada para cada grupo.
Linha inicial dos dados STARTLINE

Os arquivos de origem delimitados têm linhas iniciais diferentes para os dados.

Execute uma das seguintes ações:

  • Padronize a linha inicial nos arquivos de origem antes de importá-los.
  • Agrupe os arquivos de origem que têm a mesma linha inicial e faça uma importação separada para cada grupo.
  • Defina o campo número_linha como a linha inicial mais baixa de todos os arquivos. Após a importação dos arquivos para as tabelas do Analytics, você poderá usar o Comando EXTRACT para extrair apenas os registros de qualquer tabela com informações de cabeçalho indesejadas.
Nomes de campo KEEPTITLE Os arquivos de origem delimitados têm nomes de campo em diferentes números de linha.

Execute uma das seguintes ações:

  • Padronize o número de linha com os nomes de campo nos arquivos de origem antes de importá-los.
  • Agrupe os arquivos de origem que têm os nomes de campo no mesmo número de linha e faça uma importação separada para cada grupo.
Nomes de campo KEEPTITLE Alguns arquivos de origem delimitados têm nomes de campo, outros não.

Execute uma das seguintes ações:

  • Adicione nomes de campo aos arquivos de origem em que são necessários antes de importar todos os arquivos.
  • Agrupe os arquivos de origem que têm nomes de campo, e os arquivos que não têm nomes de campo, e faça uma importação separada para cada grupo.
  • Omita KEEPTITLE para importar todos os arquivos usando nomes de campo genéricos. Após a importação dos arquivos para as tabelas do Analytics, você poderá usar o Comando EXTRACT para extrair apenas os dados que quiser de qualquer tabela.

Vários comandos IMPORT DELIMITED

O comando IMPORT MULTIDELIMITED na verdade executa vários comandos IMPORT DELIMETED individuais, um para cada arquivo importado. Se você clicar na entrada de IMPORT MULTIDELIMITED no log, os comandos IMPORT DELIMITED individuais serão exibidos na área de exibição.

Combinação de vários arquivos delimitados após a importação

Após importar vários arquivos delimitados para tabelas do Analytics individuais, você pode combiná-las em uma única tabela do Analytics. Por exemplo, você pode combinar os dados de doze tabelas mensais em uma única tabela anual contendo todos os dados.

Para obter informações sobre como combinar várias tabelas do Analytics, consulte Comando APPEND.