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

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

Pré-requisitos

As seções a seguir fornecem informações sobre as tarefas que você precisa executar antes de conectar seus aplicativos Java ao Oracle Autonomous 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 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 Unid.
mTLS

Provisionar uma Instância do Oracle Autonomous Database

Você precisa de acesso a um Oracle Autonomous Database. Consulte Antes de Começar a Usar o Autonomous Database na Infraestrutura Dedicada do Exadata se você ainda não tiver um provisionado.

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 Database:
- DB_USER: Você pode usar ADMIN, o usuário criado por padrão quando o Oracle Autonomous Database é criado (se você criar outro usuário do OracleAutonomous Database, poderá usar esse usuário).
- DB_PASSWORD: Use a senha do usuário do banco de dados. Se estiver se conectando como o usuário ADMIN, defina-o com a senha escolhida durante a etapa Criar Autonomous Database ao provisionar o Oracle Autonomous 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 Database seguindo as instruções em Exibir Strings de Conexão de um Autonomous 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.

Provisionar uma Instância do Oracle Autonomous Database

Você precisa de acesso a um Oracle Autonomous Database. Consulte Antes de Começar a Usar o Autonomous Database na Infraestrutura Dedicada do Exadata se você ainda não tiver um provisionado.

Obter Credenciais do Cliente

Faça download de um arquivo de wallet na instância do Autonomous 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 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 a Oracle Wallet junto ao administrador da instância do Autonomous 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 Database:
- DB_USER: Você pode usar ADMIN, o usuário criado por padrão quando o Oracle Autonomous Database é criado (se você criar outro usuário do OracleAutonomous Database, poderá usar esse usuário).
- DB_PASSWORD: Use a senha do usuário do banco de dados. Se estiver se conectando como o usuário ADMIN, defina-o com a senha escolhida durante a etapa Criar Autonomous Database ao provisionar o Oracle Autonomous 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 de TNS) DBName_medium, em que DBName é o Nome do Oracle Autonomous Database informado durante a etapa Criar Autonomous Database ao provisionar o Oracle Autonomous 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 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 necessá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 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ê estabelecer conexão com o Oracle Autonomous Database por trás de um firewall, provavelmente encontrará um erro de timeout de conexão. Certifique-se de estar fora do firewall durante a execução dessa 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.