Notas de Instalação de ODBC do Oracle Instant Client

O software ODBC do Instant Client da Oracle é um pacote independente que oferece a funcionalidade completa do Oracle ODBC Driver (exceto o Oracle service para Microsoft Transaction Server) com uma instalação simples.

O driver ODBC possui a interoperabilidade da versão cliente-servidor padrão da Oracle, consulte ID do documento de suporte 207303.1. Por exemplo, o Instant Client ODBC 19c pode se conectar ao Oracle Database 11.2 ou posterior.

Como Instalar o Oracle Instant Client Basic e Basic Lite

O Instant Client ODBC exige que o pacote Oracle Instant Client Basic ou Basic Light (dependendo dos requisitos de localidade) também esteja instalado. Faça o download do pacote do OTN para o seu sistema operacional e siga as instruções de instalação na página de download. Por exemplo, descompacte o pacote para C:\instantclient_19_3 no Windows, descompacte para /opt/oracle/instantclient_19_3 no Linux ou outras plataformas, ou use yum para instalar os pacotes RPM no Linux.

Mais detalhes sobre o Oracle Instant Client estão no Guia do Programador do Oracle Call Interface.

Instalação do Oracle Instant Client ODBC

No Linux e UNIX

1. Faça o download e instale o pacote Instant Client Basic ou Basic Light, conforme descrito acima.

2. Faça o download do pacote do Instant Client ODBC. Descompacte-o no mesmo diretório que o seu pacote Basic ou Basic Light. Ou, se estiver usando o pacote RPM no Linux, instale-o com yum.

3. Instale o gerenciador de driver unixODBC, se ainda não estiver disponível. Consulte a "versão recomendada do unixODBC Driver Manager" neste documento para obter mais informações.

4. Executar odbc_update_ini.sh no diretório Instant Client.

5. Defina quaisquer variáveis de Globalização Oracle necessárias para sua localidade. Veja o Guia de Suporte de Globalização do Oracle Database para obter mais informações. Por exemplo, no Linux, você pode definir export NLS_LANG=JAPANESE_JAPAN.JA16EUC para trabalhar no caractere JA16EUC em japonês.

Uso: odbc_update_ini.sh <ODBCDM_Home> [<Install_Location> <Driver_Name> <DSN> <ODBCINI>]

Parâmetro Descrição
ODBCDM_Home caminho do diretório inicial do gerenciador de driver unixODBC
Install_Location* Caminho do diretório Oracle Instant Client. O caminho padrão é o diretório atual
Driver_Name* O nome do driver para identificar o Oracle ODBC Driver que reside na página inicial atual do Oracle Instant Client. O nome padrão será como "Oracle 19c ODBC driver"
DSN* Define o nome do DSN do ODBC. O nome padrão será "OracleODBC-19c"
ODBCINI* Caminho do diretório do .odbc.ini arquivo. O caminho padrão é o diretório inicial do usuário, por exemplo ~/.odbc.ini

* - Parâmetros opcionais

No Windows:

  1. Instale o pacote Instant Client Basic ou Basic Light, conforme descrito acima.
  2. Faça o download do pacote do Instant Client ODBC. Descompacte-o no mesmo diretório que o seu pacote Basic ou Basic Light.
  3. Executar odbc_install.exe no diretório Instant Client. Se o Instant Client for 11g ou inferior, inicie o prompt de comando com o privilégio de Administrador. Para instalar com suporte ao idioma japonês, execute o comando odbc_install.exe JA.

Configuração do ambiente para aplicativos ODBC

Um aplicativo ODBC precisa carregar o arquivo de biblioteca compartilhada do driver do Oracle Instant Client ODBC (consulte a próxima seção) para conectar-se ao Oracle Database. No Linux/Unix, o caminho do diretório da biblioteca compartilhada deve ser configurado na variável de ambiente LD_LIBRARY_PATH, ou equivalente na plataforma. Também pode ser configurado em /etc/ld.so.conf. No Windows, ele deve ser definido na variável de ambiente PATH.

Consulte os tópicos Variáveis de Ambiente para o OCI Instant Client e Sequências de Conexão de Banco de Dados para Instant Client'no Guia do Programador do Oracle Call Interface para configurar a sequência de Conexão de Banco de Dados e variáveis de ambiente relacionadas, como TNS_ADMIN, TWO_TASK, LOCAL etc.

Conteúdo do Pacote Oracle Instant Client ODBC

Descrição Linux e UNIX Windows
Biblioteca compartilhada do Oracle ODBC Driver libsqora.so.XX.Y. Por exemplo, libsqora.so.19.1 sqora32.dll
Arquivo de instalação odbc_update_ini.sh odbc_install.exe, odbc_uninstall.exe
Janela de configuração do Oracle ODBC Driver (GUI) Não disponível sqoras32.dll, sqresus.dll, sqresja.dll
Sistema de Ajuda ajuda/ ajuda/

Patches do Oracle Instant Client ODBC

Observação: faça backup da biblioteca compartilhada do Oracle ODBC Driver e de outros arquivos antes de fazer o patch.

No Linux e UNIX A correção do driver ODBC do Instant Client no Linux/UNIX pode ser feita gerando o pacote do Instant Client ODBC e o pacote Basic ou Basic Light em um ORACLE_HOME corrigido. O procedimento para aplicar patches e gerar pacotes Basic e Basic Light do Instant Client ODBC é fornecido no Guia do Programador do Oracle Call Interface. Esses novos pacotes devem ser descompactados no diretório do Instant Client que precisa ser corrigido. Este método de aplicação de patches é recomendado.

Como alternativa, o driver do Oracle Instant Client ODBC pode ser corrigido copiando os arquivos listados abaixo de um ORACLE_HOME corrigido:

  • Arquivo de biblioteca compartilhada do driver ODBC:
    Para 19c: libsqora.so.19.1
    Para 18c: libsqora.so.18.1
    Para 12c: libsqora.so.12.1
    Para 11g: libsqora.so.11.1
  • Arquivos adicionais necessários ao usar Oracle Instant Client Basic:
    Para 19c: libociei.so, libclntshcore.so.19.1, libclntsh.so.19.1, libnnz19.so, libons.so
    Para 18c: libociei.so, libclntshcore.so.18.1, libclntsh.so.18.1, libnnz18.so, libons.so
    Para 12c: libociei.so, libclntshcore.so.12.1, libclntsh.so.12.1, libnnz12.so, libons.so
    Para 11g: libclntsh.so.11.1, libociei.so, libnnz11.so
  • Arquivos adicionais necessários ao usar Oracle Instant Client Basic Light:
    Para 19c: libclntsh.so.19.1, libclntshcore.so.19.1, libociicus.so, libnnz19.so, libons.so
    Para 18c: libclntsh.so.18.1, libclntshcore.so.18.1, libociicus.so, libnnz18.so, libons.so
    Para 12c: libclntsh.so.12.1, libclntshcore.so.12.1, libociicus.so, libnnz12.so, libons.so
    Para 11g: libclntsh.so.11.1, libociicus.so, libnnz11.so
 

No Windows A correção do driver do Instant Client ODBC no Windows pode ser feita apenas copiando manualmente os arquivos da biblioteca compartilhada do driver ODBC e suportando os arquivos de biblioteca de um ORACLE_HOME corrigido ou de um patch do Pacote do Oracle Database descompactado. Eles devem ser copiados para o diretório do Instant Client. A geração de um pacote do Instant Client ODBC não está disponível no Windows.

Os arquivos que devem ser copiados para o diretório do Instant Client:

  • Arquivos de biblioteca compartilhada do driver ODBC: sqora32.dll, sqoras32.dll, sqresus.dll, sqresja.dll
  • Arquivos adicionais necessários ao usar Oracle Basic Instant Client:
    Para 19c: oraociei19.dll, orannzsbb19.dll, oci.dll, oraons.dll, ociw32.dll, oraociei19.sym, orannzsbb19.sym, oci.sym, ociw32.sym
    Para 18c: oraociei18.dll, orannzsbb18.dll, oci.dll, oraons.dll, ociw32.dll, oraociei18.sym, orannzsbb18.sym, oci.sym, ociw32.sym
    Para 12c: oraociei12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociei12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
    Para 11g: oraociei11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociei11.sym, orannzsbb11.sym, oci.sym, ociw32.sym
  • Arquivos adicionais necessários ao usar Oracle Basic Light Instant Client:
    Para 19c: oraociicus19.dll, orannzsbb19.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus19.sym, orannzsbb19.sym, oci.sym, ociw32.sym
    Para 18c: oraociicus18.dll, orannzsbb18.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus18.sym, orannzsbb18.sym, oci.sym, ociw32.sym
    Para 12c: oraociicus12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
    Para 11g: oraociicus11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociicus11.sym, orannzsbb11.sym, oci.sym, ociw32.sym

Observação: ao copiar do patch do Pacote Oracle Database, alguns dos arquivos acima podem estar ausentes. Isso significa que esses arquivos permanecem inalterados e não precisam ser corrigidos.

Desinstalação do Oracle ODBC Instant Client

No Linux e UNIX

O procedimento para desinstalar o Instant Client ODBC no Linux/UNIX é:

  1. Remova a entrada do Oracle ODBC Driver do arquivo odbcinst.ini do gerenciador de driver unixODBC. O nome padrão desta entrada é [Oracle 19c ODBC driver].
  2. Remova a entrada DSN do Oracle ODBC Driver de odbc.ini. O nome padrão da entrada DSN é [OracleODBC-19c]..
  3. Exclua todos os arquivos e diretórios no diretório Instant Client ODBC.
 

No Windows:

O procedimento para desinstalar o Instant Client ODBC no Windows é:

  1. Remova o DSN associado ao Oracle ODBC Driver no console do ODBC Data Source Administrator (odbcad32).
  2. Executar odbc_uninstall.exe no diretório ODBC do Instant Client.
  3. Exclua todos os arquivos e diretórios no diretório Instant Client ODBC.

Versões recomendadas do unixODBC Driver Manager para Linux/UNIX

Para o Instant Client 18 e 19:

Plataforma Versão do Gerenciador de Driver unixODBC
Linux de 32 bits, 64 bits 2.3.4
Solaris SPARC64 32 bits, 64 bits 2.3.4
Solaris 32 bits, 64 bits 2.3.4
AIX 5L 32 bits, 64 bits 2.3.4
HP IA64 de 32 bits, 64 bits 2.3.4
Z/Linux 31 bits, 64 bits 2.3.4

Para o Instant Client 12.1 e 12.2:

Plataforma Versão do Gerenciador de Driver unixODBC
Linux de 32 bits, 64 bits 2.3.1
Solaris SPARC64 32 bits, 64 bits 2.3.1
Solaris 32 bits, 64 bits 2.3.1
AIX 5L 32 bits, 64 bits 2.3.1
HP IA64 de 32 bits, 64 bits 2.3.1
Z/Linux 31 bits, 64 bits 2.3.1

Para o Instant Client 11g:

Plataforma Versão do Gerenciador de Driver unixODBC
Linux de 32 bits, 64 bits 2.2.11, 2.2.14
Solaris SPARC64 32 bits, 64 bits 2.2.11
Solaris 32 bits, 64 bits 2.2.11
AIX 5L 32 bits, 64 bits 2.2.11
HP IA64 de 32 bits, 64 bits 2.2.11
Z/Linux 31 bits, 64 bits 2.2.11

Recursos do Oracle ODBC Driver

Tecnologias Relacionadas