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> <STARTLINE número_linha> <ALLCHAR> {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

Nota

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

O Analytics não conseguirá importar uma pasta de trabalho do Excel se o Modo de Exibição Protegido do Excel estiver ativo nessa pasta. Você precisa habilitar a edição na pasta de trabalho, salvá-la e fechá-la antes de fazer a importação.

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 a ser importado do arquivo de dados de origem do Microsoft Excel.

Requisitos:

  • adicione um símbolo "$" ao final do nome de uma planilha

    Por exemplo, TABLE "Cartões_Crédito_Corp$"

  • especifique um intervalo nomeado exatamente da forma como aparece no Excel

    Por exemplo, TABLE "Vendas_Funcionários"

  • especifique planilha_ou_intervalo_nomeado como uma cadeia entre aspas
KEEPTITLE

opcional
  • KEEPTITLE usado com ALLFIELDS ou CHARMAX 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.
STARTLINE número_linha

opcional

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

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

Se você omitir STARTLINE, a linha de início será a primeira linha da planilha.

Nota

A linha de início de um intervalo nomeado é sempre a primeira linha do intervalo nomeado, independentemente da configuração de STARTLINE.
ALLCHAR

opcional

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

Dica

Atribuir o tipo de dados Caractere a todos os campos importados simplifica o processo de importar arquivos do Excel.

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.

Nota

Se você especificar ALLFIELDS, não especifique nenhuma sintaxe FIELD individual, CHARMAX ou IGNORE.
CHARMAX tamanho_máximo_do_campo

O tamanho máximo em caracteres de qualquer campo na tabela do Analytics originada como dados caractere no arquivo de dados de origem.

Dados de caracteres de origem que ultrapassem o comprimento máximo são truncados.

Todos os campos no arquivo de dados de origem, independentemente do tipo de dados, são importados.

Nota

Se você especificar CHARMAX, não especifique nenhuma sintaxe FIELD individual, ALLFIELDS ou IGNORE.
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.

Nota

Se você especificar ALLCHAR, tipo será ignorado.

Se você especificar uma sintaxe FIELD individual, não especifique ALLFIELDS ou CHARMAX.

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 ou CHARMAX, 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

Importar 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" C WID 16 AS "Número de cartão" FIELD "EXPDT" D WID 10 PIC "AAAA-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

Importar 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 50 caracteres, o que for menor:

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

Importar todos os campos como dados de caracteres

Execute uma importação que define uma nova tabela do Analytics denominada Transações_Maio. Todos os campos, incluindo números e datas, são importados como dados de caracteres.

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

Importar todos os campos como dados de caracteres, ignorar informações de cabeçalho

Execute uma importação que define uma nova tabela do Analytics denominada Relatório_Atrasos.

Ignore as duas primeiras linhas do arquivo do Excel, que contém informações do cabeçalho do relatório, e inicie a leitura do arquivo na terceira linha, que contém nomes de campos. Todos os campos, incluindo números e datas, são importados como dados de caracteres.

IMPORT EXCEL TO Relatório_Atrasos "Relatório_Atrasos.fil" FROM "Relatório_Atrasos.xlsx" TABLE "Plan1$" KEEPTITLE STARTLINE 3 ALLCHAR ALLFIELDS

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.

Combinações diferentes de parâmetros geram resultados diferentes. A tabela a seguir resume as diferentes possibilidades.

Nota

"Definir" significa especificar manualmente coisas como nome do campo, tipo de dados, comprimento, formato datahora etc.

Eu quero: Use estes parâmetros: Não use estes parâmetros:
  • importar automaticamente todos os campos com as definições padrão
  • se necessário, definir campos após a importação no Analytics
 ALLFIELDS CHARMAX, FIELD
  • importar automaticamente todos os campos com as definições padrão
  • se necessário, definir campos após a importação no Analytics
  • truncar campos de caracteres longos
 CHARMAX ALLFIELDS, FIELD
  • definir campos antes da importação

FIELD

 ALLFIELDS, CHARMAX
  • definir campos antes da importação
  • excluir alguns campos da importação

FIELD

IGNORE

 ALLFIELDS, CHARMAX
  • definir parcialmente campos antes da importação
  • importar automaticamente todos os campos como dados de caracteres

ALLCHAR

FIELD

 ALLFIELDS, CHARMAX
  • omitir linhas em branco ou informações de cabeçalho na parte superior de uma planilha
 STARTLINE  
  • usar a primeira linha da planilha como nomes de campo
 KEEPTITLE  
  • usar a linha da planilha especificada por STARTLINE como nomes de arquivo

KEEPTITLE

STARTLINE

  

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

Quando você usa os parâmetros ALLFIELDS ou CHARMAX, em vez de definir campos individualmente, o Analytics examina um subconjunto de registros do início do arquivo Excel e atribui tipos de dados aos campos de acordo com um conjunto de regras internas.

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.

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.

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