Verbindung zu Oracle Autonomous AI Database über JDBC mit IntelliJ herstellen

Mit der IntelliJ-IDE können Sie eine Verbindung zu Oracle Autonomous AI Database herstellen. In den folgenden Abschnitten wird beschrieben, wie Sie zuerst eine Verbindung zu Oracle Autonomous AI Database über ein Maven-Projekt oder ein Gradle-Projekt herstellen. Stellen Sie sicher, dass Sie die unter "Voraussetzungen" beschriebenen Schritte ausgeführt haben, bevor Sie eine Verbindung zu Oracle Autonomous AI Database herstellen.

Voraussetzungen

Die folgenden Abschnitte enthalten Informationen zu den Aufgaben, die Sie ausführen müssen, bevor Sie Ihre Java-Anwendungen mit dem Oracle JDBC-Treiber und dem Universal Connection Pool mit Oracle Autonomous AI Database verbinden. Je nach Authentifizierungstyp, der beim Provisioning des autonomen Exadata-VM-Clusters (AVMC) ausgewählt wurde, finden Sie die entsprechenden Voraussetzungen. Standardmäßig werden unidirektionale TLS-Verbindungen aktiviert, wenn Sie einen AVMC bereitstellen. Weitere Informationen finden Sie unter Autonomes Exadata-VM-Cluster erstellen.

Den Authentifizierungstyp finden Sie auf der Detailseite Ihres AVMC. Anweisungen finden Sie unter Details eines autonomen Exadata-VM-Clusters anzeigen.

Oracle Autonomous AI Database-Instanz bereitstellen

Sie benötigen Zugriff auf eine Oracle Autonomous AI Database. Informationen hierzu finden Sie unter Bevor Sie mit der autonomen KI-Datenbank auf einer dedizierten Exadata-Infrastruktur beginnen, wenn Sie noch keine bereitgestellt haben.

Merken Sie sich das Kennwort, das Sie für den Benutzer ADMIN verwendet haben. Zu Demonstrationszwecken wird der Benutzer ADMIN verwendet. Es wird jedoch empfohlen, andere Datenbankbenutzer mit Oracle SQL Developer oder Database Actions zu erstellen.

JDK 8 installieren

Laden Sie das neueste JDK 8 oder höhere JDK-Versionen herunter.

Hinweis: Stellen Sie sicher, dass Sie JDK8u162 oder eine neuere Version verwenden. Verwenden Sie java -version, um die installierte JDK-Version zu prüfen. Um die JDBC-Treiberversion zu prüfen, geben Sie java -jar ojdbc8.jar ein.

Laden Sie ein Beispielprogramm von Github herunter

Laden Sie die Datei ADBQuickStart.java von Github herunter. Diese Beispielanwendung verwendet das Beispielschema "Sales History (SH)" und zeigt 20 Datensätze aus der Tabelle SH.CUSTOMERS an.
Ändern Sie die Datei ADBQuickStart.java so, dass Ihre Oracle Autonomous AI Database-Verbindungsinformationen enthalten sind:
- DB_USER: Sie können ADMIN verwenden, den Benutzer, der standardmäßig erstellt wird, wenn die Oracle Autonomous AI Database erstellt wird (wenn Sie einen anderen OracleAutonomous AI Database-Benutzer erstellen, können Sie diesen Benutzer stattdessen verwenden).
- DB_PASSWORD: Verwenden Sie das Kennwort des Datenbankbenutzers. Wenn Sie eine Verbindung als Benutzer ADMIN herstellen, setzen Sie dies auf das Kennwort, das Sie beim Provisioning von Oracle Autonomous AI Database im Schritt Autonome KI-Datenbank erstellen ausgewählt haben. Aus Sicherheitsgründen müssen Sie das Kennwort über die Konsole eingeben, wenn Sie das Beispiel ausführen.
- DB_URL: Rufen Sie die Verbindungszeichenfolge für die autonome KI-Datenbank ab, indem Sie die Anweisungen unter Verbindungszeichenfolgen für eine autonome KI-Datenbank anzeigen befolgen. Wenn Sie direkt im Java-Programm verwenden, müssen Sie in der Verbindungszeichenfolge mit \
Eine Beispiel-Schnellstart-Java-Datei sieht folgendermaßen aus:
```
 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"
```
Speichern Sie die Änderungen an der Datei ADBQuickStart.java.

Fehlerbehebung und Debugging: Wenn Fehler auftreten, finden Sie auf der Seite Tipps zur Fehlerbehebung hilfreiche Hinweise.

Oracle Autonomous AI Database-Instanz bereitstellen

Clientzugangsdaten abrufen

Laden Sie eine Wallet-Datei aus der Instanz der autonomen KI-Datenbank herunter, um eine ZIP-Datei mit den Clientsicherheitszugangsdaten und den Netzwerkkonfigurationseinstellungen abzurufen, die für den Zugriff auf eine autonome KI-Datenbankinstanz erforderlich sind.

Rufen Sie die Clientsicherheitszugangsdaten (Datei wallet.zip) ab:
- ADMIN-Benutzer: Klicken Sie in der Oracle Cloud Infrastructure-Konsole auf Datenbankverbindung. Siehe Clientzugangsdaten herunterladen.
- Anderer Benutzer (ohne Administrator): Rufen Sie das Oracle Wallet vom Administrator für Ihre Autonomous AI Database-Instanz ab.
Hinweis: Schützen Sie die Datei wallet.zip und ihren Inhalt, um einen nicht autorisierten Datenbankzugriff zu verhindern.
Dekomprimieren Sie die Clientzugangsdaten-Datei (wallet.zip).

JDK 8 installieren

Laden Sie das neueste JDK 8 oder höhere JDK-Versionen herunter.

Laden Sie ein Beispielprogramm von Github herunter

Laden Sie die Datei ADBQuickStart.java von Github herunter. Diese Beispielanwendung verwendet das Beispielschema "Sales History" (SH) und zeigt 20 Datensätze aus der Tabelle SH.CUSTOMERS an.
Ändern Sie die Datei ADBQuickStart.java so, dass Ihre Oracle Autonomous AI Database-Verbindungsinformationen enthalten sind:
- DB_USER: Sie können ADMIN verwenden, den Benutzer, der standardmäßig erstellt wird, wenn die Oracle Autonomous AI Database erstellt wird (wenn Sie einen anderen OracleAutonomous AI Database-Benutzer erstellen, können Sie diesen Benutzer stattdessen verwenden).
- DB_PASSWORD: Verwenden Sie das Kennwort des Datenbankbenutzers. Wenn Sie eine Verbindung als Benutzer ADMIN herstellen, setzen Sie dies auf das Kennwort, das Sie beim Provisioning von Oracle Autonomous AI Database im Schritt Autonome KI-Datenbank erstellen ausgewählt haben. Aus Sicherheitsgründen müssen Sie das Kennwort über die Konsole eingeben, wenn Sie das Beispiel ausführen.
- DB_URL: Geben Sie den Net Service-Namen (TNS-Alias) DBName_medium ein, wobei DBName der Oracle Autonomous AI Database-Name ist, der beim Provisioning von Oracle Autonomous AI Database im Schritt Autonome KI-Datenbank erstellen eingegeben wurde. Die verfügbaren Net Service-Namen werden in der Datei tnsnames.ora angezeigt, die Teil der ZIP-Datei mit den Clientzugangsdaten ist.
  
  TNS_ADMIN muss auf den Speicherort verweisen, an dem Sie die Clientzugangsdaten von Oracle Autonomous AI Database entpackt haben.
Eine Beispiel-Schnellstart-Java-Datei sieht folgendermaßen aus:
```
 DB_URL = "jdbc:oracle:thin:@DBName_medium?TNS_ADMIN=/Users/test/wallet_DBName" DB_USER="ADMIN" and DB_PASSWORD="enter_it_from_console"
```
Speichern Sie die Änderungen an der Datei ADBQuickStart.java.

Vorgehensweise

Mit IntelliJ und Maven oder Gradle können Sie eine Verbindung zur autonomen KI-Datenbank herstellen.

Maven-Projekt erstellen
1. Klicken Sie im Menü Datei auf Neu, und wählen Sie Projekt aus.
2. Wählen Sie links Maven aus, und wählen Sie die neueste Version von JDK als Projekt-SDK aus.
3. Klicken Sie anschließend auf Weiter.
4. Name als ADBQuickstart angeben.
Erstellen Sie die Datei ADBQuickStart.java.
1. Klicken Sie mit der rechten Maustaste auf src/main/java.
2. Wählen Sie Neu, Java-Klasse aus
3. Geben Sie com.oracle.jdbctest.ADBQuickStart.java ein. Dadurch wird auch die erforderliche Paketstruktur erstellt. Kopieren Sie den Inhalt der Datei ADBQuickstart.java in diese neue Datei.
Ändern Sie die Datei pom.xml mit den folgenden Änderungen: Fügen Sie Oracle JDBC-Treiber als Abhängigkeit hinzu.

ojdbc8-production lädt den Oracle JDBC-Treiber (ojdbc8.jar) zusammen mit ucp.jar (erforderlich für die Verwendung von UCP als clientseitigen Verbindungspool), oraclepki.jar, osdt_core.jar, osdt_cert.jar herunter. Diese JARs sind für die Verwendung von Oracle Wallets bei der Verbindung zu Oracle Autonomous AI Database erforderlich.
```
 <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>
```
Erstellen Sie einen ADB QuickStart, und führen Sie ihn aus. Kompilieren Sie den Java-Code, indem Sie mit der rechten Maustaste auf ADBQuickStart.java klicken und dann auf Modul-DBQuickStart erstellen klicken. Stellen Sie sicher, dass im Java-Code kein Kompilierungsfehler vorhanden ist und Sie die neueste JDK-Version verwenden.
Führen Sie das Java-Beispielprogramm aus. Klicken Sie mit der rechten Maustaste auf ADBQuickStart.java, und klicken Sie auf ADBQuickStart.main() ausführen. Geben Sie das Datenbankkennwort in der Konsole ein.

Beispielausgabe:

Die abgefragten Zeilen werden zusammen mit einer Erfolgsmeldung angezeigt, wie im folgenden Fenster dargestellt:

Beschreibung der Abbildung intellij_build_and_run.png

Hinweis: Wenn Sie hinter einer Firewall eine Verbindung zu Oracle Autonomous AI Database herstellen, tritt wahrscheinlich ein Timeoutfehler bei der Verbindung auf. Stellen Sie sicher, dass Sie sich außerhalb der Firewall befinden, während Sie dieses Beispiel ausführen, oder aktualisieren Sie die Datei tnsnames.ora, um einen HTTPS-Proxy zu verwenden.

Befolgen Sie die Anweisungen aus dem Handbuch für Gradle-Download- und -Build-Anweisungen, und legen Sie die PATH-Variable fest, bevor Sie Gradle-Befehle verwenden. Erstellen Sie zunächst ein Gradle-Projekt mit dem folgenden Befehl. Wählen Sie 2:application als Typ des zu generierenden Projekts auswählen aus. Außerdem verwenden Sie für Quellpackage (default:temp): com.oracle.jdbctest.
```
 gradle init
```
Kopieren Sie die Datei ADBQuickStart.java in das Verzeichnis src/main/java/com/oracle/jdbctest.
Ändern Sie die Datei build.gradle mit den folgenden Änderungen:
- Fügen Sie mavenCentral() als Repository hinzu.
- Fügen Sie den Oracle JDBC-Treiber als Abhängigkeit hinzu.
Hinweis: ojdbc8-production lädt den Oracle JDBC-Treiber (ojdbc8.jar) zusammen mit ucp.jar (erforderlich für die Verwendung von UCP als clientseitigen Verbindungspool), oraclepki.jar, osdt_core.jar, osdt_cert.jar herunter. Diese JARs sind für die Verwendung von Oracle Wallets bei der Verbindung zu Oracle Autonomous AI Database erforderlich.

Weitere Informationen finden Sie im Maven Central Guide.
- Aktualisieren Sie mainClassName auf ADBQuickStart.
- Fügen Sie einen run-Block hinzu, um das Kennwort von der Konsole zu lesen.
```
 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
 }
```
Gradle-Anwendung erstellen Stellen Sie sicher, dass Sie sich in dem Verzeichnis befinden, in dem die Datei build.gradle vorhanden ist. Kompilieren Sie den Java-Code mit dem folgenden Befehl:
```
 ./gradlew build
```
Führen Sie das Java-Beispielprogramm aus.
```
 ./gradlew run
```
Beispielausgabe: Die abgefragten Zeilen werden zusammen mit einer Erfolgsmeldung angezeigt, wie auf dem folgenden Bildschirm gezeigt:

Beschreibung der Abbildung gradle_build_and_run.png

Hinweis: Wenn Sie hinter einer Firewall eine Verbindung zu Oracle Autonomous AI Database herstellen, tritt wahrscheinlich ein Timeoutfehler bei der Verbindung auf. Stellen Sie sicher, dass Sie sich außerhalb der Firewall befinden, während Sie dieses Beispiel ausführen, oder aktualisieren Sie die Datei tnsnames.ora, um einen HTTPS-Proxy zu verwenden.