Comando IMPORT ODBC
Cria uma tabela do Analytics definindo e importando dados de uma origem de dados ODBC.
ODBC significa Open Database Connectivity (conectividade aberta de banco de dados), um padrão da Microsoft para acessar bancos de dados.
Sintaxe
IMPORT ODBC SOURCE nome_da_fonte TABLE nome_tabela <QUALIFIER qualificador_de_dados> <OWNER nome_do_usuário> <USERID id_do_usuário> <PASSWORD num> <WHERE clausula_where> <TO nome_tabela> <WIDTH tamanho_máximo_do_campo> <MAXIMUM tamanho_máximo_do_campo> <FIELDS campo <;...n>>
Parâmetros
Nome | Descrição |
---|---|
SOURCE nome_da_fonte |
O nome da fonte de dados (DSN) ODBC com que será feita a conexão. O DSN já deve existir e estar configurado corretamente. Nota Você está limitado a usar fontes de dados que usam os drivers ODBC do Windows instalados no seu computador. Os conectores de dados nativos do Analytics que podem ser usados com o comando ACCESSDATA podem não estar disponíveis com o ODBC IMPORT. |
TABLE nome_tabela |
O nome da tabela na fonte de dados ODBC de que os dados serão importados. nome_tabela geralmente é uma referência a uma tabela de dados nos dados de origem, mas pode ser uma referência a tudo que o Analytics importa como tabela. Por exemplo, se usar o Microsoft Text Driver, nome_tabela é uma referência ao arquivo de texto do qual você quer importar os dados. |
QUALIFIER qualificador_de_dados opcional |
O caractere qualificador de texto. Os valores dos campos são colocados entre caracteres qualificadores para identificação. É preciso especificar o caractere como uma cadeia entre aspas. Use apóstrofos para especificar o caractere aspas: '"'. |
OWNER nome_do_usuário opcional |
O nome da conta de usuário do banco de dados que é o proprietário da tabela à qual você está se conectando. |
USERID id_do_usuário opcional |
O nome de usuário para acessar a fonte de dados. |
PASSWORD num opcional |
A definição de senha a ser usada. PASSWORD num não é usado para solicitar ou especificar uma senha real. A definição de senha faz referência a uma senha previamente fornecida ou definida com o comando PASSWORD, o comando SET PASSWORD ou a tag de análise PASSWORD. num é o número da definição de senha. Por exemplo, se as duas senhas foram previamente fornecidas ou definidas em um script, ou no agendamento de um script de análise, PASSWORD 2 especifica o uso da senha nº 2. Para obter mais informações sobre o fornecimento ou a definição de senhas, consulte: |
WHERE clausula_onde opcional |
Uma cláusula SQL WHERE que limita os registros retornados com base em critérios especificados. Deve ser uma instrução SQL válida e ser inserida como uma cadeia entre aspas: WHERE "SALARY > 50000". |
TO nome_tabela opcional |
O nome da tabela do Analytics a ser criada. Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. Por exemplo, TO "Faturas.FIL" Por padrão, o arquivo de dados da tabela (.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:
Nota Os nomes de tabela do Analytics são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. 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. |
WIDTH tamanho_máximo_do_campo opcional |
O tamanho máximo em caracteres de qualquer campo na tabela do Analytics originada como dados caractere no arquivo de dados de origem que você está importando. Você pode digitar qualquer valor entre 1 e 254. O valor padrão é 50. Dados que ultrapassem o comprimento máximo do campo são truncados quando importados para o Analytics. |
MAXIMUM tamanho_máximo_do_campo opcional |
O comprimento máximo, em caracteres, do texto, anotação ou campos de memorando que você está importando. Você pode digitar qualquer valor entre 1 e 1.100. O valor padrão é 100. Dados que ultrapassem o comprimento máximo do campo são truncados quando importados para o Analytics. |
FIELDS campo <,...n> opcional |
Campos individuais nos dados de origem a serem importados. Especifique o nome. Se especificar vários campos, cada campo deve ser separado por um ponto e vírgula. Se você omitir FIELDS, todos os campos serão importados. Colocando os nomes de campo entre aspas faz com que diferenciem maiúsculas de minúsculas. Se você usar aspas, os nomes de campo de FIELDS e da origem de dados ODBC devem corresponder exatamente, inclusive maiúsculas e minúsculas. Se você usar aspas e as maiúsculas e minúsculas dos nomes de campo não corresponderem, os campos não serão importados. Nota FIELDS deve estar posicionado em último entre os parâmetros de IMPORT ODBC. Caso contrário, o comando falhará. |
Exemplos
Importação de dados do SQL Server
Importe dados de um banco de dados do SQL Server para uma tabela do Analytics denominada Trans_Dec11:
IMPORT ODBC SOURCE "SQLServerAudit" TABLE "Transações" OWNER "audit" TO "C:\ACL DATA\Trans_Dec11.FIL" WIDTH 100 MAXIMUM 200 FIELDS "CARDNUM","CREDLIM","CUSTNO","PASTDUEAMT"
Observações
Método anterior de conectar-se a origens de dados ODBC
O comando IMPORT ODBC é o método anterior de conectar-se a origens de dados compatíveis com ODBC a partir do Analytics. O novo método de conexão com origens dos dados ODBC usa a janela de Acesso a Dados e o comando ACCESSDATA.
Você pode continuar a usar IMPORT ODBC no Analytics. No entanto, esse método de conexão agora está disponível apenas em scripts e a partir da linha de comando do Analytics. Você não pode mais acessar esse método de conexão no Assistente de Definição de Dados.
Suprime a parte de tempo dos valores de datahora
Ao usar o comando IMPORT ODBC para definir uma tabela do Analytics, é possível suprimir a parte da hora dos valores de datahora precedendo o comando com o comando SET SUPPRESSTIME ON.
Esse recurso permite alterar retroativamente scripts do Analytics criados antes da versão 10.0 do Analytics, quando a parte de tempo dos valores de datahora eram automaticamente truncados. Se SET SUPPRESSTIME ON não for adicionado a esses scripts, eles não serão executados na versão com suporte a datahora do Analytics.
Para obter mais informações, consulte a seção "SET SUPPRESSTIME" no Comando SET.