Instantclient 21 9 download: o cliente Oracle que permite conectar-se a bancos de dados remotos

walker-sebastian82
Aug 26, 2023
11 min read

O que é Instant Client e por que você precisa dele

Se você estiver desenvolvendo ou implantando aplicativos que se conectam ao Oracle Database, no local ou na nuvem, convém usar o Oracle Instant Client. O Oracle Instant Client é um conjunto de ferramentas, bibliotecas e SDKs gratuitos, leves e de fácil instalação que fornecem a conectividade de rede necessária e recursos avançados de dados para fazer uso total do Oracle Database.

instantclient 21 9 download

Download

O Oracle Instant Client é comumente usado pelas APIs Oracle de linguagens e ambientes populares, como Python, Node.js, Go, PHP e Ruby. Ele também fornece acesso para aplicativos Oracle Call Interface (OCI), Oracle C++ Call Interface (OCCI), JDBC OCI, ODBC e Pro*C. As ferramentas incluídas no Instant Client, como SQL*Plus, SQL*Loader e Oracle Data Pump, fornecem acesso rápido e conveniente aos dados.

O Oracle Instant Client simplifica a implantação de aplicativos eliminando a necessidade de um Oracle home nas máquinas clientes. A interoperabilidade de rede cliente-servidor padrão da Oracle permite conexões entre diferentes versões do Oracle Instant Client e do Oracle Database. Para configurações certificadas, consulte a nota 207303.1 do My Oracle Support. Ferramentas como o Data Pump podem ter outras restrições.

Benefícios do Instant Client

O Oracle Instant Client oferece vários benefícios para desenvolvedores e usuários de aplicativos Oracle Database. Aqui estão alguns deles:

Fácil instalação e implantação

Você pode instalar o Oracle Instant Client baixando arquivos zip ou pacotes RPM do na Oracle Technology Network (OTN). Você também pode instalar o Oracle Instant Client selecionando a opção Instant Client ao executar o Oracle Universal Installer (OUI) para o software Oracle Database Client.

Você pode implantar aplicativos usando o Instant Client na nuvem ou no local.Você também pode usar Dockerfiles ou imagens pré-criadas do GitHub Container Registry para executar o Instant Client em contêineres do Docker.

Requisito de espaço de armazenamento reduzido

Os aplicativos executados no modo Instant Client requerem significativamente menos espaço de armazenamento em comparação com o mesmo aplicativo executado em uma instalação completa do lado do cliente. Por exemplo, o pacote Básico para Windows x64 tem apenas cerca de 140 MB de tamanho. Isso facilita a distribuição e atualização de aplicativos usando o Instant Client.

Sem perda de funcionalidade ou desempenho

Os aplicativos implantados usando o Oracle Instant Client não apresentam perda de funcionalidade ou desempenho em comparação com o mesmo aplicativo executado em uma instalação completa do lado do cliente. As bibliotecas do Instant Client fornecem a mesma conectividade de rede e recursos avançados de dados que as bibliotecas Oracle Database ou Oracle Client completas. Você pode usar todos os recursos do Oracle Database, como criptografia, compactação, alta disponibilidade, escalabilidade, segurança e muito mais.

Aplicativos prontos para nuvem

Os aplicativos Instant Client estão prontos para a nuvem e podem se conectar a qualquer instância local ou remota do Oracle Database. Quer seus aplicativos estejam na nuvem ou no local, você pode instalar o Instant Client e conectar-se a bancos de dados na nuvem. Você também pode usar o Instant Client para se conectar ao Oracle Autonomous Database em Shared Exadata Infrastructure (ADB-S) com certificados TLS/SSL.

Como baixar e instalar o Instant Client

Nesta seção, mostraremos como baixar e instalar o Instant Client a partir de arquivos zip ou RPMs. Você também pode usar o OUI para instalar o Instant Client, mas não abordaremos essa opção aqui. Para mais detalhes, consulte o para sua plataforma.

Baixando pacotes do Instant Client

O primeiro passo é baixar os pacotes do Instant Client que você precisa do na OTN. Você pode escolher entre diferentes versões do Instant Client, como 21.9, 21.3, 19.12 e assim por diante.Você também pode escolher entre diferentes plataformas, como Windows, Linux, macOS e Solaris.

Os pacotes do Instant Client estão disponíveis em dois formatos: arquivos zip e pacotes RPM. Os arquivos zip são adequados para qualquer plataforma, enquanto os pacotes RPM são específicos para plataformas Linux. Você pode usar qualquer formato, dependendo de sua preferência e ambiente.

Existem diferentes tipos de pacotes Instant Client, cada um fornecendo um conjunto diferente de recursos e ferramentas. Você pode baixar um ou mais pacotes, dependendo dos requisitos de sua aplicação. Aqui está uma breve descrição de cada pacote:

Pacote básico

Este pacote contém as principais bibliotecas OCI e permite que os aplicativos se conectem ao banco de dados Oracle. Ele também inclui as ferramentas Data Pump, SQL*Loader e Workload Replay Client. Este pacote é necessário para todas as instalações do Instant Client.

Pacote básico de luz

Este pacote é semelhante ao pacote Básico, mas ocupa menos espaço e não inclui suporte para alguns conjuntos de caracteres e recursos do Oracle Net. Este pacote é adequado para aplicativos que não precisam desses recursos ou que possuem espaço em disco limitado.

pacote SDK

Este pacote contém os arquivos de cabeçalho e as bibliotecas necessárias para desenvolver aplicativos usando OCI, OCCI, Pro*C ou JDBC OCI. Ele também inclui programas de demonstração que ilustram como usar essas APIs.

Pacote SQL*Plus

Este pacote contém a ferramenta de linha de comando SQL*Plus que permite interagir com o Oracle Database usando instruções SQL e PL/SQL. Ele também inclui o manual SQL*Plus Instant Client Error Messages.

pacote de ferramentas

Este pacote contém ferramentas adicionais que podem ser usadas com o Instant Client, como expdp, impdp, exp, imp, sqlldr e wrc.

pacote ODBC

Este pacote contém o driver ODBC que permite que os aplicativos ODBC se conectem ao banco de dados Oracle. Ele também inclui a ferramenta Administrador ODBC que permite configurar e gerenciar fontes de dados ODBC.

Pacote de pré-compiladores

Este pacote contém os pré-compiladores Pro*C/C++, Pro*COBOL e Pro*FORTRAN que permitem incorporar instruções SQL em código-fonte C, COBOL ou FORTRAN. Ele também inclui a ferramenta Object Type Translator que gera código C ou C++ para tipos definidos pelo usuário.

Pacote de Suplemento JDBC-OCI

Este pacote contém arquivos adicionais necessários para aplicativos JDBC OCI. Não é um pacote independente e deve ser usado com o pacote Basic ou Basic Light.

Instalação do Instant Client a partir de arquivos zip ou RPMs

A próxima etapa é instalar o Instant Client a partir dos arquivos zip ou pacotes RPM que você baixou. O processo de instalação difere ligeiramente dependendo da sua plataforma e formato. Aqui estão as etapas gerais para plataformas Windows e Linux ou UNIX:

Para Windows

Crie um novo diretório para o Instant Client, como C:\instantclient_21_9.

Descompacte os arquivos zip no novo diretório.

Adicione o novo diretório à variável de ambiente PATH.

Se você planeja usar ODBC, crie uma nova variável de ambiente chamada TNS_ADMIN e defina seu valor para o diretório onde seu arquivo tnsnames.ora está localizado.

Se você planeja usar o ODBC, execute odbc_install.exe no novo diretório como administrador para instalar e configurar o driver ODBC.

Se você planeja usar JDBC OCI ou JDBC Thin com uma carteira, crie uma nova variável de ambiente chamada TNS_ADMIN e defina seu valor para o diretório onde sua carteira está localizada.

Se você planeja usar JDBC OCI com certificados TLS/SSL para conexões ADB-S, crie uma nova variável de ambiente chamada WALLET_LOCATION e defina seu valor para o diretório onde sua carteira está localizada.

Se você planeja usar aplicativos Pro*C/C++, Pro*COBOL ou Pro*FORTRAN, configure as opções do compilador de acordo com as instruções no para Windows[^2 ^]^.

Para Linux ou UNIX

Crie um novo diretório para o Instant Client, como /opt/oracle/instantclient_21_9.

Se você baixou arquivos zip, descompacte-os no novo diretório.

Se você baixou pacotes RPM, instale-os com o comando rpm ou o comando yum. Por exemplo, para instalar o pacote Basic, execute o seguinte comando como root: rpm -i oracle-instantclient-basic-21.9.0.0.0-1.x86_64.rpm

Adicione o novo diretório à variável de ambiente LD_LIBRARY_PATH.

Se você planeja usar ODBC, crie uma nova variável de ambiente chamada TNS_ADMIN e defina seu valor para o diretório onde seu arquivo tnsnames.ora está localizado.

Se você planeja usar ODBC, execute odbc_update_ini.sh a partir do novo diretório como raiz para atualizar os arquivos odbc.ini e odbcinst.ini.

Se você planeja usar JDBC OCI ou JDBC Thin com uma carteira, crie uma nova variável de ambiente chamada TNS_ADMIN e defina seu valor para o diretório onde sua carteira está localizada.

Se você planeja usar JDBC OCI com certificados TLS/SSL para conexões ADB-S, crie uma nova variável de ambiente chamada WALLET_LOCATION e defina seu valor para o diretório onde sua carteira está localizada.

Se você planeja usar aplicativos Pro*C/C++, Pro*COBOL ou Pro*FORTRAN, configure as opções do compilador de acordo com as instruções no para Linux ou UNIX.

Como usar o cliente instantâneo

Depois de instalar o Instant Client, você pode usá-lo para se conectar ao Oracle Database e executar seus aplicativos. Nesta seção, mostraremos como configurar as variáveis de ambiente do Instant Client e como se conectar ao Oracle Database com diferentes ferramentas e APIs.

Configurando variáveis de ambiente para Instant Client

Antes de usar o Instant Client, você precisa configurar algumas variáveis de ambiente que especificam a localização das bibliotecas e arquivos de configuração do Instant Client. As variáveis e valores exatos dependem de sua plataforma e requisitos de aplicativo. Aqui estão algumas variáveis comuns que você pode precisar definir:

CAMINHO: Esta variável deve incluir o diretório onde o Instant Client está instalado. Isso permite que você execute as ferramentas e aplicativos do Instant Client sem especificar o caminho completo.

LD_LIBRARY_PATH: Esta variável deve incluir o diretório onde o Instant Client está instalado. Isso permite que o vinculador dinâmico encontre as bibliotecas do Instant Client ao carregar seus aplicativos.

TNS_ADMIN: Esta variável deve apontar para o diretório onde seu arquivo tnsnames.ora está localizado. Este arquivo contém os nomes de serviço de rede que mapeiam para as instâncias do Oracle Database. Você pode usar esses nomes ao se conectar ao Oracle Database com Instant Client.

WALLET_LOCATION: Esta variável deve apontar para o diretório onde sua carteira está localizada. Uma carteira é um contêiner seguro que armazena credenciais de autenticação e assinatura, como certificados TLS/SSL. Você pode usar uma carteira ao se conectar ao Oracle Database com Instant Client por TLS/SSL.

NLS_LANG: esta variável especifica o idioma, o território e o conjunto de caracteres do ambiente do cliente. Isso afeta como o Instant Client exibe e processa os dados. Por exemplo, você pode definir essa variável como AMERICAN_AMERICA.AL32UTF8 se você quiser usar o inglês americano e a codificação UTF-8.

ORACLE_HOME: esta variável não é necessária para o Instant Client, mas pode ser usada por alguns aplicativos que esperam uma instalação completa do lado do cliente. Você pode definir essa variável para o diretório onde o Instant Client está instalado ou deixá-la indefinida.

Você pode definir essas variáveis em seu perfil de shell ou em um script executado antes de usar o Instant Client. Por exemplo, se estiver usando o bash no Linux, você pode adicionar as seguintes linhas ao seu arquivo .bash_profile:

export PATH=/opt/oracle/instantclient_21_9:$PATH export LD_LIBRARY_PATH=/opt/oracle/instantclient_21_9:$LD_LIBRARY_PATH export TNS_ADMIN=/opt/oracle/network/admin export WALLET_LOCATION=/opt/oracle/wallet export NLS_LANG=AMERICAN_AMERICA.AL32UTF8 export ORACLE _HOME=/opt/oracle/instantclient_21_9

Depois de definir essas variáveis, você precisa fornecer seu perfil ou executar seu script para torná-los efetivos em sua sessão de shell atual.Por exemplo, você pode executar o seguinte comando:

fonte /.bash_profile

Conectando-se ao banco de dados Oracle com Instant Client

Depois de instalar e configurar o Instant Client, você pode usá-lo para se conectar ao Oracle Database e executar seus aplicativos. O método de conexão e a sintaxe dependem da ferramenta ou API que você está usando. Aqui estão alguns exemplos de como se conectar ao Oracle Database com diferentes ferramentas e APIs:

Usando o SQL*Plus

O SQL*Plus é uma ferramenta de linha de comando que permite interagir com o Oracle Database usando instruções SQL e PL/SQL. Você pode usar o SQL*Plus com o Instant Client executando o executável sqlplus no diretório do Instant Client. Por exemplo, você pode executar o seguinte comando para iniciar o SQL*Plus:

/opt/oracle/instantclient_21_9/sqlplus

Você será solicitado a inserir seu nome de usuário, senha e identificador de conexão. O identificador de conexão pode ser um nome de serviço de rede de seu arquivo tnsnames.ora, uma string de conexão fácil ou um nome de serviço de rede de um método de nomenclatura configurado em seu arquivo sqlnet.ora. Por exemplo, você pode inserir as seguintes informações para se conectar a um banco de dados chamado ORCL em um host chamado dbhost:

Digite o nome de usuário: scott Digite a senha: tiger Digite o identificador de conexão SQL*Plus: ORCL

Como alternativa, você pode inserir o nome de usuário, a senha e o identificador de conexão em uma linha da seguinte maneira:

Digite o nome de usuário: scott/tiger@ORCL

Depois de se conectar ao banco de dados Oracle, você pode executar instruções SQL e PL/SQL no SQL*Plus. Por exemplo, você pode executar o seguinte comando para exibir a versão do Oracle Database ao qual está conectado:

SQL> selecione o banner de v$version; BANNER -------------------------------------------------------------------------------- Oracle Database 21c Enterprise Edition Release 21.0.0.0.0 - Produção

Para sair do SQL*Plus, você pode executar o seguinte comando:

SQL> sair

Usando SQL*Loader e Data Pump

SQL*Loader e Data Pump são ferramentas que permitem carregar e descarregar dados do Oracle Database.Você pode usar o SQL*Loader e o Data Pump com o Instant Client executando os executáveis sqlldr ou expdp/impdp a partir do diretório do Instant Client. Por exemplo, você pode executar o seguinte comando para carregar dados de um arquivo chamado emp.dat em uma tabela chamada EMP usando um arquivo de controle chamado emp.ctl:

/opt/oracle/instantclient_21_9/sqlldr scott/tiger@ORCL control=emp.ctl

Você pode executar o seguinte comando para exportar dados de um esquema chamado HR para um arquivo dump chamado hr.dmp usando o Data Pump:

/opt/oracle/instantclient_21_9/expdp hr/hr@ORCL directory=DATA_PUMP_DIR dumpfile=hr.dmp

Você pode executar o seguinte comando para importar dados de um arquivo dump chamado hr.dmp para um esquema chamado HR usando o Data Pump:

/opt/oracle/instantclient_21_9/impdp hr/hr@ORCL directory=DATA_PUMP_DIR dumpfile=hr.dmp

Usando drivers ODBC

Os drivers ODBC permitem que os aplicativos ODBC se conectem ao banco de dados Oracle. Você pode usar drivers ODBC com Instant Client configurando e gerenciando fontes de dados ODBC usando a ferramenta ODBC Administrator ou os arquivos odbc.ini e odbcinst.ini. Por exemplo, você pode executar o seguinte comando para iniciar a ferramenta ODBC Administrator no Windows:

C:\instantclient_21_9\odbcad32.exe

Você pode usar a ferramenta ODBC Administrator para criar, modificar ou excluir fontes de dados ODBC para Instant Client. Você também pode testar a conexão com o Oracle Database usando o botão Test Connection.

Você também pode editar os arquivos odbc.ini e odbcinst.ini manualmente em plataformas Linux ou UNIX. O arquivo odbc.ini contém as informações sobre as fontes de dados ODBC, como nome do driver, nome DSN, nome de usuário, senha e identificador de conexão. O arquivo odbcinst.ini contém as informações sobre os drivers ODBC, como nome do driver, descrição e caminho da biblioteca.

Depois de configurar as fontes de dados ODBC, você pode usá-las em seus aplicativos ODBC para se conectar ao Oracle Database.Por exemplo, você pode usar a seguinte string de conexão em um programa Python que usa o módulo pyodbc para se conectar a uma fonte de dados ODBC chamada ORCL:

import pyodbc conn = pyodbc.connect("DSN=ORCL") Usando aplicativos OCI, OCCI, JDBC OCI ou Pro*C

OCI, OCCI, JDBC OCI e Pro*C são APIs que permitem desenvolver aplicativos que se conectam ao banco de dados Oracle usando C, C++, Java ou SQL incorporado em C, COBOL ou FORTRAN. Você pode usar essas APIs com o Instant Client vinculando seus aplicativos às bibliotecas do Instant Client e definindo as variáveis de ambiente apropriadas. Por exemplo, você pode usar o seguinte comando para compilar e vincular um aplicativo Pro*C no Linux:

proc iname=sample.pc gcc -o sample sample.c -I/opt/oracle/instantclient_21_9/sdk/include -L/opt/oracle/instantclient_21_9 -lclntsh

Você pode usar o seguinte comando para executar o aplicativo:

./amostra

Conclusão

Neste artigo, explicamos o que é o Instant Client e por que você precisa dele. Também mostramos como baixar e instalar o Instant Client a partir de arquivos zip ou RPMs e como usar o Instant Client para se conectar ao Oracle Database com diferentes ferramentas e APIs. Esperamos que este artigo tenha ajudado você a entender e usar o Instant Client para seus aplicativos Oracle Database.

perguntas frequentes

Aqui estão algumas perguntas frequentes sobre o Instant Client:

P: Como faço para atualizar o Instant Client?

R: Você pode atualizar o Instant Client baixando a versão mais recente dos pacotes do Instant Client no na OTN. Você pode então instalar os novos pacotes sobre os existentes ou em um diretório diferente. Pode ser necessário atualizar suas variáveis de ambiente de acordo.

P: Como faço para desinstalar o Instant Client?

R: Você pode desinstalar o Instant Client excluindo o diretório onde o Instant Client está instalado. Você também pode precisar remover quaisquer referências ao Instant Client de suas variáveis de ambiente ou arquivos de configuração.

P: Como soluciono problemas do Instant Client?

R: Você pode solucionar problemas do Instant Client verificando as mensagens de erro e os arquivos de log gerados pelo Instant Client ou por seus aplicativos. Você também pode usar ferramentas como tnsping, lsnrctl, sqlplus, ou trcasst para testar a conectividade e rastrear a atividade da rede. Para mais detalhes, consulte o .

P: Como obtenho suporte para o Instant Client?

R: Você pode obter suporte para Instant Client entrando em contato com o Suporte da Oracle ou postando suas perguntas no na OTN.

P: Onde posso encontrar mais informações sobre o Instant Client?

R: Você pode encontrar mais informações sobre o Instant Client nas seguintes fontes:

em OTN

para sua plataforma

0517a86e26