Estabelecer Conexão com o Oracle Autonomous AI Database Usando o JDBC sem uma Ferramenta de Criação

Você pode estabelecer uma conexão com o Oracle Autonomous AI Database manualmente sem qualquer ferramenta de criação.

Pré-requisitos

As seções a seguir fornecem informações sobre as tarefas que você precisa executar antes de conectar suas aplicações Java ao Oracle Autonomous AI Database usando o driver JDBC da Oracle e o Universal Connection Pool. Consulte os pré-requisitos apropriados, dependendo do tipo de autenticação selecionado durante o provisionamento do Cluster de VMs do Autonomous Exadata (AVMC). Por padrão, conexões TLS unidirecionais são ativadas quando você provisiona um AVMC. Consulte Criar um Cluster de VMs do Autonomous Exadata para obter mais informações.

Você pode encontrar o tipo de autenticação na página Detalhes do seu AVMC. Consulte Exibir Detalhes de um Cluster de VMs Autonomous Exadata para obter instruções.

TLS unidirecional
mTLS

Provisione uma instância do Oracle Autonomous AI Database

Você precisa acessar um Oracle Autonomous AI Database. Consulte Antes de Começar a Usar o Autonomous AI Database on Dedicated Exadata Infrastructure se você ainda não tiver provisionado um.

Lembre-se da senha que você usou para o usuário ADMIN. Para fins de demonstração, usaremos o usuário ADMIN, mas nossa recomendação é criar outros usuários de banco de dados usando o Oracle SQL Developer ou o Database Actions.

Instalar o JDK 8

Faça download do JDK 8 mais recente ou de versões JDK mais altas.

Observação:

Certifique-se de usar JDK8u162 ou uma versão posterior. Use java -version para verificar a versão do JDK que você instalou. Para verificar a versão do driver JDBC, digite java -jar ojdbc8.jar.

Baixe um programa de amostra do Github

Faça download do arquivo ADBQuickStart.java do Github. Este aplicativo de amostra usa o esquema de amostra do Histórico de Vendas (SH) e exibe 20 registros da tabela SH.CUSTOMERS.
Modifique o arquivo ADBQuickStart.java para incluir suas informações de conexão do Oracle Autonomous AI Database:
- DB_USER: Você pode usar ADMIN, o usuário criado por padrão quando o Oracle Autonomous AI Database é criado (se você criar outro usuário do OracleAutonomous AI Database, poderá usar esse usuário).
- DB_PASSWORD: Use a senha do usuário do banco de dados. Se você estiver se conectando como o usuário ADMIN, defina essa senha com a senha escolhida durante a etapa Criar Autonomous AI Database ao provisionar o Oracle Autonomous AI Database. Por motivos de segurança, você precisa informar a senha por meio do console ao executar a amostra.
- DB_URL: Obtenha a string de conexão do seu Autonomous AI Database seguindo as instruções em Exibir Strings de Conexão para um Autonomous AI Database. Se você estiver usando diretamente no programa Java, precisará fazer escape de " na string de conexão com \"
Um exemplo de arquivo Java de início rápido tem esta aparência:
```
DB_URL = "jdbc:oracle:thin:@jdbc:oracle:thin:@(description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-sanjose-1.oraclecloud.com))(connect_data=(service_name=g13ec47eade81f7_demodb_low.adb.oraclecloud.com))(security=(ssl_server_cert_dn=\"CN=adb.us-sanjose-1.oraclecloud.com,
      OU=Oracle ADB SANJOSE, O=Oracle Corporation, L=Redwood City, ST=California,
      C=US\")))"
DB_USER="ADMIN" and DB_PASSWORD="your_password"
```
Salve as alterações no arquivo ADBQuickStart.java.

Solução de Problemas e Depuração: Se você encontrar algum erro, consulte a página Dicas de Solução de Problemas para obter algumas dicas úteis.

Provisione uma instância do Oracle Autonomous AI Database

Você precisa acessar um Oracle Autonomous AI Database. Consulte Antes de Começar a Usar o Autonomous AI Database on Dedicated Exadata Infrastructure se você ainda não tiver provisionado um.

Obter Credenciais do Cliente

Faça download de um arquivo da wallet da instância do Autonomous AI Database para obter um arquivo zip que contenha as credenciais de segurança do cliente e as definições de configuração de rede necessárias para acessar uma instância do Autonomous AI Database.

Obtenha as credenciais de segurança do cliente (arquivo wallet.zip):
- Usuário ADMIN: Na Console do Oracle Cloud Infrastructure, clique em Conexão do banco de dados. Consulte Fazer Download das Credenciais do Cliente.
- Outro usuário (não administrador): Obtenha o Oracle Wallet do administrador da sua instância do Autonomous AI Database.
Observação:
Proteja o arquivo wallet.zip e seu conteúdo para impedir o acesso não autorizado ao banco de dados.
Descompacte o arquivo de credenciais do cliente (wallet.zip).

Instalar o JDK 8

Faça download do JDK 8 mais recente ou de versões JDK mais altas.

Observação:

Baixe um programa de amostra do Github

Faça download do arquivo ADBQuickStart.java do Github. Este aplicativo de amostra usa o esquema de amostra do Histórico de Vendas (SH) e exibe 20 registros da tabela SH.CUSTOMERS.
Modifique o arquivo ADBQuickStart.java para incluir suas informações de conexão do Oracle Autonomous AI Database:
- DB_USER: Você pode usar ADMIN, o usuário criado por padrão quando o Oracle Autonomous AI Database é criado (se você criar outro usuário do OracleAutonomous AI Database, poderá usar esse usuário).
- DB_PASSWORD: Use a senha do usuário do banco de dados. Se você estiver se conectando como o usuário ADMIN, defina essa senha com a senha escolhida durante a etapa Criar Autonomous AI Database ao provisionar o Oracle Autonomous AI Database. Por motivos de segurança, você precisa informar a senha por meio do console ao executar a amostra.
- DB_URL: Informe o nome do serviço de rede (Alias TNS) DBName_medium, em que DBName é o Nome do Oracle Autonomous AI Database informado durante a etapa Criar Autonomous AI Database ao provisionar o Oracle Autonomous AI Database. Os nomes de serviço de rede disponíveis podem ser vistos no arquivo tnsnames.ora, que faz parte do arquivo zip de credenciais do cliente.
  TNS_ADMIN deve apontar para o local em que você descompactou as credenciais do cliente do Oracle Autonomous AI Database.
Um exemplo de arquivo Java de início rápido tem esta aparência:
```
DB_URL = "jdbc:oracle:thin:@DBName_medium?TNS_ADMIN=/Users/test/wallet_DBName" DB_USER="ADMIN" and DB_PASSWORD="enter_it_from_console"
```
Salve as alterações no arquivo ADBQuickStart.java.

Procedimento

Faça download da versão the19c de ojdbc8-full.tar.gz no OTN e descompacte o conteúdo no classpath.

Observação:
ojdbc8-full.tar.gz contém o driver JDBC mais recente ojdbc8.jar, ucp.jar (JAR obrigatório para usar o UCP como um pool de conexões do cliente), oraclepki.jar, osdt_core.jar, osdt_cert.jar. Esses JARs são necessários para usar o Oracle Wallets ao estabelecer conexão com o Oracle Autonomous AI Database.

Compile o programa Java. Certifique-se de fornecer o caminho correto para os JARs necessários no classpath:

javac -classpath ./lib/ojdbc8.jar:./lib/ucp.jar:/lib/oraclepki.jar:./lib/osdt_core.jar:./lib/osdt_cert.jar com/oracle/jdbctest/ADBQuickStart.java

Execute o programa Java de amostra. Certifique-se de fornecer o caminho correto para os JARs necessários no classpath:
```
java -classpath ./lib/ojdbc8.jar:./lib/ucp.jar:/lib/oraclepki.jar:./lib/osdt_core.jar:./lib/osdt_cert.jar:. com.oracle.jdbctest.ADBQuickStart
```
Amostra de saída:

As linhas consultadas juntamente com uma mensagem de êxito são exibidas, como é mostrado na seguinte tela:

Descrição da ilustração no_build_and_run.png

Observação:

Se você se conectar ao Oracle Autonomous AI Database por trás de um firewall, provavelmente encontrará um erro de timeout de conexão. Certifique-se de estar fora do firewall ao executar essa amostra ou atualize o arquivo tnsnames.ora para usar um proxy HTTPS.

Título e Informações de Copyright

Oracle e/ou suas empresas afiliadas.