Comando IMPORT EXCEL

Cria uma tabela do Analytics definindo e importando uma planilha ou intervalo nomeado do Microsoft Excel.

Sintaxe

IMPORT EXCEL TO tabela nome_arquivo_importação FROM nome_arquivo_origem TABLE planilha_ou_intervalo_nomeado_de_entrada <KEEPTITLE> {ALLFIELDS|CHARMAX tamanho_máximo_do_campo|[sintaxe_do_campo] <...n> <IGNORE num_campo> <...n>} <OPEN>

sintaxe_campo ::=
FIELD nome_importação tipo {PIC formato|WID caracteres DEC valor} 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"
TABLE planilha_ou_intervalo_nomeado	A planilha ou o intervalo nomeado do Microsoft Excel no arquivo de dados de origem a ser importado: será necessário inserir um sinal de "$" no final do nome da planilha planilha_ou_intervalo_nomeado deve ser especificado como uma cadeia entre aspas
KEEPTITLE opcional	Trate a primeira linha de dados como nomes de campos em vez de dados. Se omitida, serão usados nomes de campo genéricos. Se os campos forem definidos individualmente, KEEPTITLE deverá aparecer antes do primeiro FIELD.
ALLFIELDS	Todos os campos no arquivo de dados de origem são importados. Nota Se você especificar ALLFIELDS, não especifique nenhuma sintaxe FIELD individual, CHARMAX ou IGNORE.
CHARMAX tamanho_máximo_do_campo	Aplica-se somente quando você não está definindo campos individualmente. O tamanho máximo em caracteres de qualquer campo na tabela do Analytics originada como dados caractere no arquivo de dados de origem.
FIELD nome_importação tipo	Os campos individuais no arquivo de dados de origem a importar, incluindo o nome e o tipo de dados do campo. nome_importação torna-se o nome do campo na tabela do Analytics. nome_importação não precisa ser o mesmo que o nome do campo no arquivo de dados de origem, mas pode ser. Dica Você também pode usar AS para especificar um nome de exibição diferente de nome_importação. tipo torna-se o tipo de dados do campo na tabela do Analytics. tipo não precisa ser o mesmo que o tipo de dados do campo no arquivo de dados de origem, mas pode ser. Para obter mais informações sobre tipo, consulte Identificadores para os tipos de dados de campo. Exclusão de um campo Para excluir um campo da importação, não o especifique. Também é necessário especificar IGNORE para campos excluídos.
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.
WID caracteres	O comprimento em caracteres do campo no layout da tabela do Analytics.
DEC valor	O número de casas decimais para campos numéricos.
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 Tenha cuidado para alinhar corretamente num_campo com a posição dos campos excluídos. Se você especificar num_campo para um campo incluído (definição FIELD) ou para uma posição de campo que não existe, a importação não funcionará corretamente. O número de parâmetros FIELD e IGNORE combinados deve ser igual ao número total de campos na tabela de dados de origem. Se os números totais não corresponderem, a importação não funcionará corretamente. Se você especificar ALLFIELDS, não especifique IGNORE.
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

Importação de campos específicos

Execute uma importação que define uma nova tabela do Analytics denominada Cartões_Crédito. A importação usa a primeira linha de dados do Excel como nomes de arquivo.

Dos doze campos na tabela de origem, a tabela do Analytics define e inclui três campos e exclui nove campos:

IMPORT EXCEL TO Cartões_Crédito "Cartões_Crédito.fil" FROM "Cartões_Crédito_Metaphor.xls" TABLE "Cartões_Crédito_Corp$" KEEPTITLE FIELD "CARDNUM" N WID 16 DEC 0 AS "Número de cartão" FIELD "EXPDT" D WID 10 PIC "YYYY-MM-DD"  AS "Data de expiração" FIELD "PASTDUEAMT" N WID 6 DEC 2 AS "Past Due" IGNORE 2 IGNORE 3 IGNORE 5 IGNORE 6 IGNORE 7 IGNORE 9 IGNORE 10 IGNORE 11 IGNORE 12

Importação de todos os campos

Execute uma importação que define uma nova tabela do Analytics denominada Transações_Maio. A importação usa a primeira linha de dados do Excel como nomes de arquivo.

A tabela do Analytics inclui todos os campos da tabela de origem e usa definições de campo padrão.

Comprimento do campo definido como o valor mais comprido

No primeiro exemplo, os campos originados como dados de caracteres no arquivo de dados de origem são definidos como o comprimento do valor mais longo do campo:

IMPORT EXCEL TO Transações_Maio "Transações_Maio.fil" FROM "Trans_Maio.xls" TABLE "Trans1_Maio$" KEEPTITLE ALLFIELDS

Comprimento restrito do campo

No segundo exemplo, os campos originados como dados de caracteres no arquivo de dados de origem são definidos como o comprimento do valor mais longo do campo ou como o valor de CHARMAX de 100 caracteres, o que for menor:

IMPORT EXCEL TO Transações_Maio "Transações_Maio.fil" FROM "Trans_Maio.xls" TABLE "Trans1_Maio$" KEEPTITLE CHARMAX 100

Observações

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

Defina os campos individualmente, ou importe todos os campos usando uma definição padrão

Quando você importa um arquivo Excel para uma tabela do Analytics, pode usar os parâmetros FIELD para definir cada campo individualmente ou usar o parâmetro ALLFIELDS ou o parâmetro CHARMAX para importar todos os campos usando definições de campo padrão do Analytics.

Tamanho máximo de importação de dados

Formato de arquivo .xlsx ou .xlsm

O número máximo de colunas do Excel e o número máximo de caracteres em um campo que podem ser importados de arquivos .xlsx ou .xlsm não são limitados a um número específico.

A importação desses tipos de arquivo do Excel é controlada pelo limite do comprimento do registro nos arquivos de dados do Analytics (.fil) de 32 KB. Se qualquer registro no arquivo Excel de origem possibilitar a criação de um registro do Analytics maior que 32 KB, a importação falhará.

Formato do arquivo .xls

A importação de arquivos .xls (Excel 97 - 2003) usa um tipo diferente de processamento e está sujeita aos limites máximos de:

255 colunas
255 caracteres por campo
32 KB por registro
65.000 linhas

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 do Analytics.