Connettersi a Oracle Autonomous Database utilizzando JDBC con IntelliJ
È possibile stabilire una connessione a Oracle Autonomous Database utilizzando l'IDE IntelliJ. Le sezioni seguenti forniscono informazioni su come connettersi per la prima volta a Oracle Autonomous Database utilizzando un progetto Maven o un progetto Gradle. Assicurarsi di aver completato i passi descritti nei prerequisiti prima di connettersi a Oracle Autonomous Database.
Prerequisiti
Le sezioni riportate di seguito forniscono informazioni sui task da eseguire prima di connettere le applicazioni Java a Oracle Autonomous Database utilizzando il driver JDBC Oracle e l'Universal Connection Pool. Fare riferimento ai prerequisiti appropriati in base al tipo di autenticazione selezionato durante il provisioning del cluster VM Autonomous Exadata (AVMC). Per impostazione predefinita, le connessioni TLS unidirezionali vengono abilitate quando si esegue il provisioning di un AVMC. Per ulteriori informazioni, vedere Creare un cluster VM Autonomous Exadata.
Puoi trovare il tipo di autenticazione nella pagina Dettagli del tuo AVMC. Per istruzioni, vedere Visualizzare i dettagli di un cluster VM Autonomous Exadata.
Eseguire il provisioning di un'istanza Oracle Autonomous Database
È necessario accedere a un Oracle Autonomous Database. Fare riferimento a Prima di iniziare con Autonomous Database sull'infrastruttura Exadata dedicata se non ne è già stato eseguito il provisioning.
Ricordare la password utilizzata per l'utente ADMIN
. A scopo dimostrativo, utilizzeremo l'utente ADMIN
, ma il nostro suggerimento è quello di creare altri utenti del database utilizzando Oracle SQL Developer o Database Actions.
Installa JDK 8
Scaricare l'ultima versione di JDK 8 o versioni JDK superiori.
Nota
Assicurarsi di utilizzareJDK8u162
o una versione successiva. Utilizzare java -version
per controllare la versione del JDK installata. Per controllare la versione del driver JDBC, digitare java -jar ojdbc8.jar
.
Scarica un programma di esempio da Github
- Scaricare il file ADBQuickStart.java da Github. Questa applicazione di esempio utilizza lo schema di esempio Cronologia vendite (SH) e visualizza 20 record dalla tabella
SH.CUSTOMERS
. - Modificare il file ADBQuickStart.java in modo che includa le informazioni di connessione di Oracle Autonomous Database:
- DB_USER: è possibile utilizzare
ADMIN
, l'utente creato per impostazione predefinita quando viene creato l'Oracle Autonomous Database (se si crea un altro utente OracleAutonomous Database, è possibile utilizzare tale utente). - DB_PASSWORD: utilizzare la password dell'utente del database. Se si esegue la connessione come utente
ADMIN
, impostarla sulla password scelta durante il passo Crea Autonomous Database durante il provisioning di Oracle Autonomous Database. Per motivi di sicurezza, è necessario immettere la password tramite la console quando si esegue l'esempio. - DB_URL: ottenere la stringa di connessione per Autonomous Database seguendo le istruzioni in Visualizza stringhe di connessione per un Autonomous Database. Se si utilizza direttamente nel programma Java, è necessario eseguire l'escape " nella stringa di connessione con \"
Un esempio di file Java di avvio rapido è simile al seguente:
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"
- DB_USER: è possibile utilizzare
- Salva le modifiche al file
ADBQuickStart.java
.
Risoluzione dei problemi e debug: se si verificano errori, consultare la pagina Suggerimenti per la risoluzione dei problemi per alcuni suggerimenti utili.
Eseguire il provisioning di un'istanza Oracle Autonomous Database
È necessario accedere a un Oracle Autonomous Database. Fare riferimento a Prima di iniziare con Autonomous Database sull'infrastruttura Exadata dedicata se non ne è già stato eseguito il provisioning.
Ricordare la password utilizzata per l'utente ADMIN
. A scopo dimostrativo, utilizzeremo l'utente ADMIN
, ma il nostro suggerimento è quello di creare altri utenti del database utilizzando Oracle SQL Developer o Database Actions.
Ottenere le credenziali client
-
Scaricare un file wallet dall'istanza di Autonomous Database per ottenere un file zip che contiene le credenziali di sicurezza del client e le impostazioni di configurazione di rete necessarie per accedere a un'istanza di Autonomous Database.
Ottenere le credenziali di sicurezza del client (file
wallet.zip
):- Utente ADMIN: nella console di Oracle Cloud Infrastructure fare clic su Connessione al database. Vedere Scarica credenziali client.
- Altro utente (non amministratore): ottenere Oracle Wallet dall'amministratore per l'istanza di Autonomous Database.
Nota
Proteggere il filewallet.zip
e il relativo contenuto per impedire l'accesso non autorizzato al database. - Estrarre il file delle credenziali client (
wallet.zip
).
Installa JDK 8
Scaricare l'ultima versione di JDK 8 o versioni JDK superiori.
Nota
Assicurarsi di utilizzareJDK8u162
o una versione successiva. Utilizzare java -version
per controllare la versione del JDK installata. Per controllare la versione del driver JDBC, digitare java -jar ojdbc8.jar
.
Scarica un programma di esempio da Github
- Scaricare il file ADBQuickStart.java da Github. Questa applicazione di esempio utilizza lo schema di esempio Cronologia vendite (SH) e visualizza 20 record dalla tabella
SH.CUSTOMERS
. - Modificare il file ADBQuickStart.java in modo che includa le informazioni di connessione di Oracle Autonomous Database:
- DB_USER: è possibile utilizzare
ADMIN
, l'utente creato per impostazione predefinita quando viene creato l'Oracle Autonomous Database (se si crea un altro utente OracleAutonomous Database, è possibile utilizzare tale utente). - DB_PASSWORD: utilizzare la password dell'utente del database. Se si esegue la connessione come utente
ADMIN
, impostarla sulla password scelta durante il passo Crea Autonomous Database durante il provisioning di Oracle Autonomous Database. Per motivi di sicurezza, è necessario immettere la password tramite la console quando si esegue l'esempio. - DB_URL: immettere il nome del servizio di rete (alias TNS) DBName_medium, dove DBName è il nome dell'Oracle Autonomous Database immesso durante il passo Crea Autonomous Database durante il provisioning di Oracle Autonomous Database. I nomi di servizio di rete disponibili sono visibili nel file
tnsnames.ora
, che fa parte del file zip delle credenziali client.TNS_ADMIN
deve puntare alla posizione in cui sono state decompresse le credenziali client di Oracle Autonomous Database.
Un esempio di file Java di avvio rapido è simile al seguente:
DB_URL = "jdbc:oracle:thin:@DBName_medium?TNS_ADMIN=/Users/test/wallet_DBName" DB_USER="ADMIN" and DB_PASSWORD="enter_it_from_console"
- DB_USER: è possibile utilizzare
- Salva le modifiche al file
ADBQuickStart.java
.
Procedura
Puoi connetterti ad Autonomous Database utilizzando IntelliJ e Maven o Gradle.
- Creare un progetto Maven.
- Click from File menu, select New, and then select Project.
- Selezionare Maven sul lato sinistro e selezionare la versione più recente di JDK come SDK progetto.
- Fare clic su Successivo.
- Assegnare Nome come ADBQuickstart.
- Creare il file
ADBQuickStart.java
.- Fare clic con il pulsante destro del mouse su
src/main/java
. - Selezionare Nuovo, quindi Classe Java.
- Immettere
com.oracle.jdbctest.ADBQuickStart.java
. Ciò creerà anche la struttura del pacchetto richiesta. Assicurarsi di copiare il contenuto del file ADBQuickstart.java in questo nuovo file.
- Fare clic con il pulsante destro del mouse su
- Modificare il file
pom.xml
con le seguenti modifiche: aggiungere il driver JDBC Oracle come dipendenza.ojdbc8-production
scaricherà il driver JDBC Oracle (ojdbc8.jar
) insieme aucp.jar
(obbligatorio per l'uso di UCP come connection pool lato client),oraclepki.jar
,osdt_core.jar
,osdt_cert.jar
. Questi JAR sono necessari per utilizzare i wallet Oracle durante la connessione a Oracle Autonomous Database.<properties> <maven.compiler.source>11</maven.compiler.source> <maven.compiler.target>11</maven.compiler.target> </properties> <dependencies> <dependency> <groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8-production</artifactId> <version>19.18.0.0</version> <type>pom</type> </dependency> </dependencies>
- Creare ed eseguire un ADB QuickStart. Compilare il codice Java facendo clic con il pulsante destro del mouse su ADBQuickStart.java, quindi fare clic su Crea modulo ADBQuickStart. Assicurarsi di non avere errori di compilazione nel codice Java e di utilizzare la versione JDK più recente.
- Eseguire il programma Java di esempio. Fare clic con il pulsante destro del mouse su ADBQuickStart.java, quindi su Esegui ADBQuickStart.main(). Assicurarsi di immettere la password del database nella console.
Output di esempio:
Vengono visualizzate le righe interrogate insieme a un messaggio di operazione riuscita, come mostrato nella schermata seguente:
Nota
Nota: se ci si connette a Oracle Autonomous Database da un firewall, è probabile che si verifichi un errore di timeout della connessione. Assicurarsi che l'ambiente sia esterno al firewall durante l'esecuzione di questo esempio oppure aggiornare il filetnsnames.ora
per utilizzare un proxy HTTPS.
- Seguire le istruzioni del manuale Gradle Guide per il download e la generazione di istruzioni Gradle e impostare la variabile PATH prima di utilizzare i comandi Gradle. Come primo passo, creare un progetto Gradle utilizzando il seguente comando. Assicurarsi di scegliere 2:applicazione per Selezionare il tipo di progetto da generare. Inoltre, per Source package (predefinito:temp): utilizzare
com.oracle.jdbctest
.gradle init
- Copiare il file ADBQuickStart.java nella directory
src/main/java/com/oracle/jdbctest
. - Modificare il file
build.gradle
con le seguenti modifiche:- Aggiungere
mavenCentral()
come repository. - Aggiungere il driver JDBC Oracle come dipendenza.
Nota
ojdbc8: la produzione scarica il driver Oracle JDBC (ojdbc8.jar
) insieme aucp.jar
(obbligatorio per l'utilizzo di UCP come connection pool lato client),oraclepki.jar
,osdt_core.jar
,osdt_cert.jar
. Questi JAR sono necessari per utilizzare i wallet Oracle durante la connessione a Oracle Autonomous Database.Per ulteriori informazioni, vedere Maven Central Guide.
- Aggiornare
mainClassName
in ADBQuickStart. - Aggiungere un blocco
run
per leggere la password dalla console.repositories { // Maven Central mavenCentral() } dependencies { // Get the 19.18.0.0 Oracle JDBC driver along with other companion jars implementation("com.oracle.database.jdbc:ojdbc8-production:19.18.0.0") } application { // Define the main class for the application mainClassName ='{your_project_directory}.ADBQuickStart' } // To pause to read the password from console run { standardInput = System.in }
- Aggiungere
- Crea un'applicazione Gradle. Assicurarsi di trovarsi nella directory in cui è presente il file
build.gradle
. Compilare il codice Java utilizzando il seguente comando:./gradlew build
- Eseguire il programma Java di esempio.
./gradlew run
Output di esempio: vengono visualizzate le righe sottoposte a query insieme a un messaggio di operazione riuscita, come mostrato nella schermata seguente:
Nota
Se ci si connette a Oracle Autonomous Database da un firewall, è probabile che si verifichi un errore di timeout della connessione. Assicurarsi che l'ambiente sia esterno al firewall durante l'esecuzione di questo esempio oppure aggiornare il filetnsnames.ora
per utilizzare un proxy HTTPS.