Comando IMPORT DELIMITED

Informações do conceito

Importar um arquivo de texto delimitado

Cria uma tabela do Analytics definindo e importando um arquivo de texto delimitado.

Sintaxe

IMPORT DELIMITED TO tabela nome_arquivo_importação FROM nome_arquivo_origem <SERVER nome_perfil> codificação_caracteres_origem SEPARATOR {carac|TAB|SPACE} QUALIFIER {carac|NONE} <CONSECUTIVE> STARTLINE número_da_linha <KEEPTITLE> <CRCLEAR> <LFCLEAR> <REPLACENULL> <ALLCHAR> {ALLFIELDS|[sintaxe_do_campo] <...n> <IGNORE num_campo> <...n>}
sintaxe_campo ::=
FIELD nome tipo AT posição_inicial DEC valor WID bytes PIC formato AS nome_exibicao

Parâmetros

Nome Descrição
TO tabela

O nome da tabela do Analytics na qual os dados serão importados.

Nota

Os nomes de tabela são limitados a 64 caracteres alfanuméricos. 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.

nomearquivo_importação

O nome do arquivo de dados do Analytics a ser criado.

Especifique nome_arquivo_importação como uma cadeia entre aspas com uma extensão de arquivo .FIL. Por exemplo, "Faturas.FIL".

Por padrão, o arquivo de dados (.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:

  • "C:\dados\Faturas.FIL"
  • "dados\Faturas.FIL"

FROM nome_arquivo_origem

O nome do arquivo de dados de origem. nome_arquivo_origem deve ser uma cadeia entre aspas.

Se o arquivo de dados de origem não está localizado no mesmo diretório que o projeto do Analytics, é necessário usar um caminho absoluto para especificar a localização do arquivo:

  • "C:\dados\nome_arquivo_origem"
  • "dados\nome_arquivo_origem"
SERVER nome_perfil

opcional

 O nome do perfil do servidor do Servidor AX onde os dados que você deseja importar estão localizados.
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.
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_da_linha

O número da linha na qual iniciar a leitura do arquivo.

Por exemplo, se as primeiras três linhas de um arquivo contiverem informações de cabeçalho indesejadas, especifique STARTLINE 4 para começar a ler os dados a partir da quarta linha.
KEEPTITLE

opcional
  • KEEPTITLE usado com ALLFIELDS 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 e o número de linha especificado por STARTLINE será tratado como dado.

  • KEEPTITLE usado com sintaxe FIELD individual Não importe o número especificado por STARTLINE. FIELD nome especifica os nomes dos campos.

    Se você omitir KEEPTITLE, o número de linha especificado por STARTLINE será tratado como dado. FIELD nome especifica os nomes dos campos.
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.
ALLFIELDS

Todos os campos no arquivo de dados de origem são importados.

Para obter informações sobre como o Analytics atribui tipos de dados quando você usa ALLFIELDS, consulte Observações.

Nota

Se você especificar ALLFIELDS, não especifique nenhuma sintaxe FIELD individual ou IGNORE.
FIELD nome tipo

Os campos individuais no arquivo de dados de origem a importar, incluindo o nome e o tipo de dados do campo. Para excluir um campo da importação, não o especifique.

Para obter mais informações sobre tipo, consulte Identificadores para os tipos de dados de campo.

Nota

tipo será ignorado se você especificar ALLCHAR.
AT posição_inicial

A posição inicial em bytes do campo no arquivo de dados do Analytics.

Nota

Analytics não Unicode 1 byte = 1 caractere
Analytics Unicode 2 bytes = 1 caractere

No Analytics Unicode, normalmente você deve especificar uma posição inicial em bytes ímpar. A especificação de uma posição inicial par pode causar exibição incorreta de caracteres.
DEC valor

O número de casas decimais para campos numéricos.

Nota

DEC será ignorado se você especificar ALLCHAR.
WID bytes

O comprimento em bytes do campo no layout da tabela do Analytics.

Nota

Analytics não Unicode 1 byte = 1 caractere
Analytics Unicode 2 bytes = 1 caractere

No Analytics Unicode, especifique apenas um número de bytes par. A especificação de um número ímpar de bytes pode causar exibição incorreta de caracteres.
PIC formato

Nota

Aplica-se somente a campos numéricos ou de datahora.

  • campos numéricos o formato de exibição de valores numéricos em exibições e relatórios do Analytics
  • campos datahora o formato físico dos valores datahora nos dados de origem (ordem de caracteres de data e hora, separadores e assim por diante)

    Nota

    Para campos de datahora, formato deve corresponder exatamente ao formato físico dos dados de origem. Por exemplo, se os dados de origem são 31/12/2014, você deve inserir o formato como "DD/MM/AAAA".

formato deve estar entre aspas.

Nota

PIC será ignorado se você especificar ALLCHAR.
AS nome_exibicao

O nome de exibição (título alternativo da coluna) para o campo na exibição na nova tabela do Analytics.

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.

AS é obrigatório na definição de um FIELD. Para que o nome de exibição seja igual ao nome do campo, insira um valor de nome_exibicao em branco usando a seguinte sintaxe: AS "". Verifique se não há espaço entre as duas aspas.
IGNORE num_campo <...n>

opcional

Exclui o campo do layout da tabela.

num_campo especifica a posição do campo excluído no arquivo de dados de origem. Por exemplo, IGNORE 5 exclui o quinto campo no arquivo de dados de origem do layout da tabela do Analytics.

Nota

Os dados do campo ainda são importados, mas são indefinidos, e não são exibidos na nova tabela do Analytics. Os dados podem ser definidos posteriormente, se necessário, e adicionados à tabela.

Para excluir completamente um campo da importação, não o especifique durante a especificação dos campos individuais.

Exemplos

Importar todos os campos

Importe todos os campos de um arquivo delimitado por vírgula para uma tabela do Analytics chamada Funcionários. O arquivo usa aspas como qualificador de texto. Os tipos de dados são atribuídos automaticamente com base no conjunto de regras descrito em Observações:

IMPORT DELIMITED TO Funcionários "Funcionários.fil" FROM "Funcionários.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLFIELDS

Importar todos os campos, atribuindo automaticamente um tipo de dados caractere

Importe todos os campos de um arquivo delimitado por vírgula para uma tabela do Analytics chamada Funcionários. O arquivo usa aspas como qualificador de texto. O tipo de dados caractere é atribuído automaticamente a todos os campos importados:

IMPORT DELIMITED TO Funcionários "Funcionários.fil" FROM "Funcionários.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR ALLFIELDS

Importar os campos especificados, atribuindo automaticamente um tipo de dados caractere

Importe os campos especificados de um arquivo delimitado por tabulação para uma tabela do Analytics chamada Funcionários. O arquivo usa aspas como qualificador de texto. O tipo de dados caractere é atribuído automaticamente a todos os campos importados:

IMPORT DELIMITED TO Funcionários "Funcionários.fil" FROM "Funcionários.csv" 0 SEPARATOR TAB QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR FIELD "Nome" C AT 1 DEC 0 WID 25 PIC "" AS "Nome" FIELD "Sobrenome" C AT 26 DEC 0 WID 25 PIC "" AS "Sobrenome" FIELD "NumCart" C AT 51 DEC 0 WID 16 PIC "" AS "Número de cartão" FIELD "NumFunc" C AT 67 DEC 0 WID 6 PIC "" AS "Número do funcionário" FIELD "DataContratação" C AT 73 DEC 0 WID 10 PIC "" AS "Data de contratação" FIELD "Salário" C AT 83 DEC 0 WID 5 PIC "" AS "" FIELD "Bônus_2016" C AT 88 DEC 0 WID 10 PIC "" AS "Bônus 2016"

Importar campos especificados, atribuindo tipos de dados individualmente

Importe os campos especificados de um arquivo delimitado por ponto e vírgula para uma tabela do Analytics chamada Funcionários. O arquivo não usa qualificadores de texto. Especifique o tipo de dados de cada campo importado:

IMPORT DELIMITED TO Funcionários "Funcionário.fil" FROM "Funcionários.csv" 0 SEPARATOR ";" QUALIFIER "" CONSECUTIVE STARTLINE 1 KEEPTITLE FIELD "Nome" C AT 1 DEC 0 WID 25 PIC "" AS "Nome" FIELD "Sobrenome" C AT 26 DEC 0 WID 25 PIC "" AS "Sobrenome" FIELD "NumCart" C AT 51 DEC 0 WID 16 PIC "" AS "Número de cartão" FIELD "NumFunc" C AT 67 DEC 0 WID 6 PIC "" AS "Número do funcionário" FIELD "DataContratação" D AT 73 DEC 0 WID 10 PIC "DD/MM/AAAA" AS "Data de contratação" FIELD "Salário" N AT 83 DEC 0 WID 5 PIC "" AS "" FIELD "Bônus_2016" N AT 88 DEC 2 WID 10 PIC "" AS "Bônus 2016"

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Importar um arquivo de texto delimitado.

Como o Analytics atribui tipos de dados quando você usa ALLFIELDS

Quando você usa o parâmetro ALLFIELDS, em vez de definir campos individualmente, o Analytics examina um subconjunto de registros do início do arquivo delimitado e atribui tipos de dados aos campos de acordo com o conjunto de regras definido a seguir.

Quando os dados estiverem no Analytics, se necessário, você poderá atribuir aos campos tipos de dados diferentes, como numérico ou datahora, e especificar detalhes de formato.

Descrição dos valores de campo no arquivo delimitado Exemplos Tipo de dados atribuído
Valores entre qualificadores de texto "Fornecedores ABC"

"6.990,75"

 Caractere
Os valores incluem um caractere não numérico em qualquer lugar do campo, com a exceção de vírgulas e pontos usados como separadores numéricos e o sinal negativo (-) $995

(995)

 Caractere
Os valores incluem somente números, separadores numéricos ou o sinal negativo 6,990.75

-6,990.75

995

 Numérico
Um ou mais valores em branco ocorrem em um campo   Caractere
Valores datahora com separadores ou meses alfabéticos

2016/12/31

31 dez 2016

 Caractere
Valores datahora totalmente numéricos 20161231 Numérico

Identificadores para os tipos de dados de campo

A tabela abaixo lista as letras que você deve usar ao especificar o tipo para FIELD. Cada letra corresponde a um tipo de dados do Analytics.

Por exemplo, se você estiver definindo um campo Sobrenome, que exige um tipo de dados de caractere, você especificaria "C": FIELD "Sobrenome" C.

Para obter mais informações, consulte Tipos de dados no Analytics.

Nota

Ao usar o Assistente de Definição de Dados para definir uma tabela que inclui campos EBCDIC, Unicode ou ASCII, os campos recebem automaticamente a letra “C” (para o tipo CARACTERE).

Ao inserir a instrução IMPORT manualmente ou editar uma instrução IMPORT, você pode substituir as letras mais específicas “E” ou “U” para os campos EBCDIC ou Unicode.

Letra

Tipo de dados do Analytics

A

ACL

B

BINARY

C

CHARACTER

D

DATETIME

E

EBCDIC

F

FLOAT

G

ACCPAC

I

IBMFLOAT

K

UNSIGNED

L

LOGICAL

N

PRINT

P

PACKED

Q

BASIC

R

MICRO

S

CUSTOM

T

PCASCII

U

UNICODE

V

VAXFLOAT

X

NUMERIC

Y

UNISYS

Z

ZONED