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

Você pode usar programas em diferentes linguagens, incluindo Node.js, PHP, Ruby, R, Go e Perl para estabelecer conexão com o Autonomous AI 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 AI Database on Dedicated Exadata Infrastructure na sua linguagem de script, primeiro instale o driver de idioma e as bibliotecas de clientes da seguinte forma:

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-os 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 do Ambiente (por exemplo, adicionar 'C:\instantclient_12_2'). No Windows 8, acesse a área PATH de definição da variável navegando até Painel de Controle>Sistema>Definições Avançadas do Sistema>Variáveis do 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 para download do Linux Instant Client estão disponíveis em arquivos .zip ou .rpm. Você pode usar qualquer uma das versões.
Instale o driver de linguagem relevante para o Oracle Database:
- Node.js : Para instalar node-oracledb para Node.js, use as instruções na seguinte página: Instalando node-oracledb.
- ROracle: Para instalar ROracle for R, use as instruções na seguinte página: ROracle
- PHP: Para instalar o OCI8 PHP para PHP, use as instruções na seguinte página: Configurando PHP com a 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 PHP PDO_OCI para PHP, use as instruções na 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 ruby-oci8 para Ruby, use as instruções na seguinte página: Install for Oracle Instant Client
- DBD for Perl: Para instalar o DBD::Oracle for Perl, defina ORACLE_HOME e seu caminho de pesquisa de biblioteca, como LD_LIBRARY_PATH ou PATH, para o diretório do Instant Client e use a seguinte página: DBD::Oracle.

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

Obtenha as credenciais do cliente para estabelecer conexão com uma instância do Autonomous AI Database. Você obtém um arquivo zip contendo credenciais e configurações de rede de segurança de cliente necessárias para acessar seu Autonomous AI 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:
- Usuário ADMIN: Clique em Conexão do BD. Consulte Fazer Download das Credenciais do Cliente.
- Outro usuário (não administrador): Obtenha o Oracle Wallet do administrador do seu Autonomous AI Database.
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 do subdiretório 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, são necessários apenas estes arquivos: tnsnames.ora, sqlnet.ora, cwallet.sso e ewallet.p12.

Executar Seu Aplicativo

Atualize seu aplicativo para estabelecer conexão usando seu nome do usuário do banco de dados, sua senha e o nome da conexão do Oracle Net fornecido no arquivo tnsnames.ora descompactado. Por exemplo, usuário, atpc_user, senha e atpc_low como a string de conexão.
Como alternativa, altere a string de ligação em tnsnames.ora para corresponder à string usada pelo seu aplicativo.
Execute o aplicativo.

Conteúdo Relacionado

Sobre a Conexão com um Autonomous AI Database Dedicado