Estabelecer Conexão com o Autonomous Database com Node.js e Outras Idiomas de Script

Você pode usar programas em diferentes idiomas, incluindo Node.js, PHP, Ruby, R, Go e Perl para estabelecer conexão com o Autonomous Database on Dedicated Exadata Infrastructure. A segurança é aplicada usando credenciais de cliente.

Essas linguagens de script têm APIs ou drivers de acesso ao banco de dados que usam as bibliotecas do Oracle Call Interface. As bibliotecas do Oracle Call Interface podem ser do Oracle Client completo ou do Oracle Instant Client.

Instalar o Driver da Linguagem e as Bibliotecas Clientes

Para estabelecer conexão com o Autonomous Database on Dedicated Exadata Infrastructure de sua linguagem de script, primeiro instale o driver da linguagem e as bibliotecas clientes da seguinte forma:

  1. Instale o Instant Client ou o Client completo. A versão mínima suportada para o Client Completo é a Versão 11.2.0.4; para o Oracle Instant Client, use a versão 12.1.0.2 ou mais recente:

    O Instant Client funciona bem para a maioria dos aplicativos. Para instalar o Instant Client, faça o seguinte:

    1. Selecione sua arquitetura desejada na página Downloads do Instant Client e faça download de um Pacote Basic (disponível na página de download): Oracle Instant Client

      Como alternativa, faça download do Pacote Basic Light da página de download da arquitetura desejada se as limitações de globalização do Basic Light se adequarem ao seu uso.

    2. Se você estiver criando uma API ou um driver de linguagem com base no código de origem, talvez também precise fazer download do Instant Client SDK: Oracle Instant Client

    3. Descompacte o pacote base selecionado. Por exemplo, descompacte em C:\instantclient_12_2 ou /home/myuser/instantclient_18_5. Se você também fizer download do SDK, descompacte-o no mesmo diretório.

    4. No Windows, adicione o caminho à variável PATH na seção "Variáveis do sistema" do painel Variáveis de Ambiente (por exemplo, adicione C:\instantclient_12_2). No Windows 8, acesse a área de definição de variável PATH navegando até Painel de Controle>Sistema>Configurações Avançadas do Sistema>Variáveis de Ambiente. Se você tiver várias versões das bibliotecas Oracle instaladas, certifique-se de que o novo diretório apareça primeiro no caminho.

    5. Em plataformas não Windows, crie um link simbólico, caso ele não exista. Por exemplo:

      cd /home/myuser/instantclient_18_5
ln -s libclntsh.so.18.1 libclntsh.so

      Se não houver outro software Oracle no sistema que será afetado, adicione o Instant Client ao caminho do link de runtime. Por exemplo:

      sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
sudo ldconfig

      Como alternativa, defina o caminho da biblioteca em cada shell que executa o seu aplicativo. Por exemplo:

      export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH

      Observação:

      Os arquivos de download do Linux Instant Client estão disponíveis como arquivos .zip ou .rpm. Você pode usar qualquer uma das versões.

  2. Instale o driver de linguagem relevante para o Oracle Database:

    • Node.js : Para instalar o node-oracledb para Node.js, use as instruções da seguinte página: Installing node-oracledb.

    • ROracle: Para instalar o ROracle para R, use as instruções da seguinte página: ROracle

    • PHP: Para instalar o PHP OCI8 para PHP, use as instruções da seguinte página: Configurando o PHP com o OCI8.

      As DLLs do Windows estão disponíveis em http://php.net/downloads.php e também estão disponíveis em PECL oci8.

    • PHP PDO_OCI: Para instalar o PHP PDO_OCI para PHP, use as instruções da seguinte página: Oracle Functions (PDO_OCI).

      As DLLs do Windows estão disponíveis em http://php.net/downloads.php incluído no PHP.

    • Ruby: Para instalar o ruby-oci8 para Ruby, use as instruções da seguinte página: Install for Oracle Instant Client

    • DBD for Perl: Para instalar o DBD::Oracle for Perl, defina ORACLE_HOME e o caminho de pesquisa da biblioteca, como LD_LIBRARY_PATH ou PATH, para o diretório Instant Client e use as instruções da seguinte página: DBD::Oracle.

Ativar Conectividade de Rede da Oracle e Obter as Credenciais de Segurança (Oracle Wallet)

  1. Obtenha credenciais de segurança do cliente para estabelecer conexão com uma instância do Autonomous Database. Você obtém um arquivo zip contendo as credenciais de segurança do cliente e as definições de configuração de rede necessárias para acessar o seu Autonomous Database. Você deve proteger esse arquivo e seu conteúdo para impedir o acesso não autorizado ao banco de dados. Obtenha o arquivo de credenciais de segurança do cliente da seguinte forma:

  2. Extraia os arquivos de credenciais do cliente (wallet):

    1. Descompacte o arquivo zip de credenciais do cliente.

    2. Se você estiver usando o Instant Client, faça uma hierarquia de subdiretórios network/admin no diretório Instant Client, se necessário. Em seguida, mova os arquivos para esse subdiretório. Por exemplo, dependendo da arquitetura ou do sistema cliente e onde você instalou o Instant Client, os arquivos deverão estar no diretório: 

      C:\instantclient_12_2\network\admin

      ou

      /home/myuser/instantclient_18_5/network/admin

      ou

      /usr/lib/oracle/18.5/client64/lib/network/admin

      • Se você estiver usando um Oracle Client completo, mova o arquivo para $ORACLE_HOME/network/admin.

    3. Como alternativa, coloque os arquivos de wallet descompactados em um diretório seguro e defina a variável de ambiente TNS_ADMIN com esse nome de diretório.

    Observação:

    No arquivo zip, somente estes arquivos são obrigatórios: tnsnames.ora, sqlnet.ora, cwallet.sso e ewallet.p12.

Executar Seu Aplicativo

  1. Atualize seu aplicativo para estabelecer conexão usando seu nome de usuário do banco de dados, sua senha e o nome de conexão do Oracle Net fornecido no arquivo tnsnames.ora descompactado. Por exemplo, usuário, atpc_user, senha e atpc_low como string de conexão.

  2. Como alternativa, altere a string de conexão em tnsnames.ora para corresponder à string usada pelo seu aplicativo.

  3. Execute o aplicativo.

Tópicos Relacionados