Se connecter à Oracle Autonomous Database à l'aide de JDBC avec IntelliJ
Vous pouvez établir une connexion à Oracle Autonomous Database à l'aide de l'environnement IDE IntelliJ. Les sections suivantes fournissent des informations sur la première façon de se connecter à Oracle Autonomous Database à l'aide d'un projet Maven ou d'un projet Gradle. Assurez-vous d'avoir terminé les étapes décrites dans les préalables avant de vous connecter à Oracle Autonomous Database.
Conditions requises
Les sections suivantes fournissent des informations sur les tâches que vous devez effectuer avant de connecter vos applications Java à Oracle Autonomous Database à l'aide du pilote JDBC Oracle et de la réserve de connexions universelle. Reportez-vous aux préalables appropriés selon le type d'authentification sélectionné lors du provisionnement de votre grappe de machines virtuelles Exadata autonome. Par défaut, les connexions TLS unidirectionnelles sont activées lorsque vous provisionnez une grappe de machines virtuelles autonome. Pour plus d'informations, voir Créer une grappe de machines virtuelles Exadata autonome.
Vous pouvez trouver le type d'authentification dans la page Détails de votre serveur AVMC. Pour obtenir des instructions, voir Voir les détails d'une grappe de machines virtuelles Exadata autonome.
Provisionner une instance d'Oracle Autonomous Database
Vous avez besoin d'accéder à une base de données Oracle Autonomous Database. Reportez-vous à Avant de commencer à utiliser Autonomous Database sur une infrastructure Exadata dédiée si vous n'en avez pas déjà provisionné un.
N'oubliez pas le mot de passe que vous avez utilisé pour l'utilisateur ADMIN
. Aux fins de démonstration, nous utiliserons l'utilisateur ADMIN
, mais nous vous recommandons de créer d'autres utilisateurs de base de données à l'aide d'Oracle SQL Developer ou de Database Actions.
Installer JDK 8
Téléchargez la dernière version de JDK 8 ou une version JDK supérieure.
Note :
Assurez-vous d'utiliserJDK8u162
ou une version ultérieure. Utilisez java -version
pour vérifier la version de JDK que vous avez installée. Pour vérifier la version du pilote JDBC, entrez java -jar ojdbc8.jar
.
Télécharger un exemple de programme à partir de Github
- Téléchargez le fichier ADBQuickStart.java à partir de Github. Cet exemple d'application utilise l'exemple de schéma Historique des ventes (SH) et affiche 20 enregistrements de la table
SH.CUSTOMERS
. - Modifiez le fichier ADBQuickStart.java pour inclure les informations de connexion à Oracle Autonomous Database :
- DB_USER : Vous pouvez utiliser
ADMIN
, l'utilisateur créé par défaut lors de la création d'Oracle Autonomous Database (si vous créez un autre utilisateur OracleAutonomous Database, vous pouvez l'utiliser à la place). - DB_PASSWORD : Utilisez le mot de passe de l'utilisateur de base de données. Si vous êtes connecté en tant qu'utilisateur
ADMIN
, réglez ce mot de passe au cours de l'étape Créer une base de données Autonomous Database lors du provisionnement d'Oracle Autonomous Database. Pour des raisons de sécurité, vous devez entrer le mot de passe au moyen de la console lorsque vous exécutez l'exemple. - DB_URL : Obtenez la chaîne de connexion pour Autonomous Database en suivant les instructions sous Voir les chaînes de connexion pour une base de données Autonomous Database. Si vous utilisez directement dans le programme Java, vous devez échapper " dans la chaîne de connexion avec \"
Voici un exemple de fichier Java à démarrage rapide :
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 : Vous pouvez utiliser
- Enregistrez les modifications dans le fichier
ADBQuickStart.java
.
Dépannage et débogage : Si vous rencontrez une erreur, consultez la page Conseils de dépannage pour obtenir des conseils utiles.
Provisionner une instance d'Oracle Autonomous Database
Vous avez besoin d'accéder à une base de données Oracle Autonomous Database. Reportez-vous à Avant de commencer à utiliser Autonomous Database sur une infrastructure Exadata dédiée si vous n'en avez pas déjà provisionné un.
N'oubliez pas le mot de passe que vous avez utilisé pour l'utilisateur ADMIN
. Aux fins de démonstration, nous utiliserons l'utilisateur ADMIN
, mais nous vous recommandons de créer d'autres utilisateurs de base de données à l'aide d'Oracle SQL Developer ou de Database Actions.
Obtenir les données d'identification du client
-
Téléchargez un fichier de portefeuille à partir de l'instance Autonomous Database pour obtenir un fichier zip contenant les données d'identification de sécurité du client et les paramètres de configuration de réseau requis pour accéder à une instance Autonomous Database.
Obtenez les données d'identification de sécurité du client (fichier
wallet.zip
) :- Utilisateur ADMIN : Dans la console Oracle Cloud Infrastructure, cliquez sur Connexion à la base de données. Voir Télécharger les données d'identification du client.
- Autre utilisateur (non administrateur) : Obtenez le portefeuille Oracle Wallet pour l'instance de base de données autonome auprès de l'administrateur.
Note :
Protégez le fichierwallet.zip
et son contenu pour empêcher l'accès non autorisé à la base de données. - décompressez le fichier de données d'identification du client (
wallet.zip
).
Installer JDK 8
Téléchargez la dernière version de JDK 8 ou une version JDK supérieure.
Note :
Assurez-vous d'utiliserJDK8u162
ou une version ultérieure. Utilisez java -version
pour vérifier la version de JDK que vous avez installée. Pour vérifier la version du pilote JDBC, entrez java -jar ojdbc8.jar
.
Télécharger un exemple de programme à partir de Github
- Téléchargez le fichier ADBQuickStart.java à partir de Github. Cet exemple d'application utilise l'exemple de schéma Historique des ventes (SH) et affiche 20 enregistrements de la table
SH.CUSTOMERS
. - Modifiez le fichier ADBQuickStart.java pour inclure les informations de connexion à Oracle Autonomous Database :
- DB_USER : Vous pouvez utiliser
ADMIN
, l'utilisateur créé par défaut lors de la création d'Oracle Autonomous Database (si vous créez un autre utilisateur OracleAutonomous Database, vous pouvez l'utiliser à la place). - DB_PASSWORD : Utilisez le mot de passe de l'utilisateur de base de données. Si vous êtes connecté en tant qu'utilisateur
ADMIN
, réglez ce mot de passe au cours de l'étape Créer une base de données Autonomous Database lors du provisionnement d'Oracle Autonomous Database. Pour des raisons de sécurité, vous devez entrer le mot de passe au moyen de la console lorsque vous exécutez l'exemple. - DB_URL : Entrez le nom du service réseau (alias TNS) DBName_medium où DBName est le nom Oracle Autonomous Database entré lors de l'étape Créer une base de données Autonomous Database lors du provisionnement d'Oracle Autonomous Database. Les noms de service réseau disponibles sont visibles dans le fichier
tnsnames.ora
, qui fait partie du fichier zip des données d'identification du client.TNS_ADMIN
doit pointer vers l'emplacement où vous avez décompressé les données d'identification de client d'Oracle Autonomous Database.
Voici un exemple de fichier Java à démarrage rapide :
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 : Vous pouvez utiliser
- Enregistrez les modifications dans le fichier
ADBQuickStart.java
.
Procédure
Vous pouvez vous connecter à Autonomous Database à l'aide de IntelliJ et de Maven ou Gradle.
- Créez un projet Maven.
- Cliquez dans le menu Fichier, sélectionnez Nouveau, puis sélectionnez Projet.
- Sélectionnez Maven sur le côté gauche et sélectionnez la dernière version de JDK comme trousse SDK de projet.
- Cliquez sur Suivant.
- Indiquez Nom comme ADBQuickstart.
- Créez le fichier
ADBQuickStart.java
.- Cliquez avec le bouton droit de la souris sur
src/main/java
. - Sélectionnez Nouveau, puis Classe Java
- Entrez
com.oracle.jdbctest.ADBQuickStart.java
. Cela créera également la structure de package requise. Assurez-vous de copier le contenu du fichier ADBQuickstart.java dans ce nouveau fichier.
- Cliquez avec le bouton droit de la souris sur
- Modifiez le fichier
pom.xml
avec les modifications suivantes : Ajoutez le pilote JDBC Oracle en tant que dépendance.ojdbc8-production
télécharge le pilote JDBC Oracle (ojdbc8.jar
) avecucp.jar
(obligatoire pour utiliser UCP en tant que réserve de connexions côté client),oraclepki.jar
,osdt_core.jar
,osdt_cert.jar
. Ces fichiers JAR sont requis pour utiliser les portefeuilles Oracle lors de la connexion à 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>
- Créez et exécutez une base de données autonome QuickStart. Compilez le code Java en cliquant avec le bouton droit de la souris sur ADBQuickStart.java, puis cliquez sur Créer un module ADBQuickStart. Assurez-vous de ne pas avoir d'erreur de compilation dans le code Java et que vous utilisez la dernière version de JDK.
- Exécutez l'exemple de programme Java. Cliquez avec le bouton droit sur ADBQuickStart.java, puis cliquez sur Exécuter ADBQuickStart.main(). Veillez à entrer le mot de passe de la base de données dans la console.
Exemple de sortie :
Les lignes interrogées et un message de réussite s'affichent, comme le montre l'écran suivant :
Note :
Note : Si vous êtes connecté à Oracle Autonomous Database derrière un pare-feu, vous rencontrerez probablement une erreur de temporisation de connexion. Assurez-vous d'être en dehors du pare-feu lors de l'exécution de cet exemple ou mettez à jour le fichiertnsnames.ora
pour utiliser un mandataire HTTPS.
- Suivez les instructions du guide d'analyse pour les instructions de téléchargement et de création de l'outil Gradle, et définissez la variable PATH avant d'utiliser les commandes Gradle. Dans un premier temps, créez un projet Gradle à l'aide de la commande suivante. Assurez-vous de choisir 2:application pour Sélectionner le type de projet à générer. De plus, pour Ensemble source (par défaut :temp) : utilisez
com.oracle.jdbctest
.gradle init
- Copiez le fichier ADBQuickStart.java dans le répertoire
src/main/java/com/oracle/jdbctest
. - Modifiez le fichier
build.gradle
avec les modifications suivantes :- Ajoutez
mavenCentral()
en tant que référentiel. - Ajoutez le pilote JDBC Oracle en tant que dépendance.
Note :
ojdbc8-production télécharge le pilote JDBC Oracle (ojdbc8.jar
) avecucp.jar
(obligatoire pour utiliser UCP en tant que réserve de connexions côté client),oraclepki.jar
,osdt_core.jar
,osdt_cert.jar
. Ces fichiers JAR sont requis pour utiliser les portefeuilles Oracle lors de la connexion à Oracle Autonomous Database.Pour plus d'informations, consultez le Guide sur Maven Central.
- Mettez à jour
mainClassName
à ADBQuickStart. - Ajoutez un bloc
run
pour lire le mot de passe à partir de la 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 }
- Ajoutez
- création d'une application de gradle; Assurez-vous d'être dans le répertoire où se trouve le fichier
build.gradle
. Compilez le code Java à l'aide de la commande suivante :./gradlew build
- Exécutez l'exemple de programme Java.
./gradlew run
Exemple de sortie : Les lignes interrogées et un message de réussite s'affichent, comme indiqué dans l'écran suivant :
Note :
Si vous vous connectez à Oracle Autonomous Database derrière un pare-feu, vous rencontrerez probablement une erreur de temporisation de connexion. Assurez-vous d'être en dehors du pare-feu lors de l'exécution de cet exemple ou mettez à jour le fichiertnsnames.ora
pour utiliser un mandataire HTTPS.