AI für Java auswählen

Select AI for Java ist ein Java-SDK, das eine Java-native API für die Konfiguration und Verwendung von Select AI mit Oracle Autonomous AI Database bereitstellt. Das SDK bietet ausgewählte KI-Funktionen, einschließlich KI-Profilen, Zugangsdaten, Unterhaltungen, Vektorindizes, natürlicher SQL-Sprache, Zusammenfassung, Übersetzung, Feedback und Generierung synthetischer Daten über Java-Klassen, -Schnittstellen und -Methoden.

Das SDK stellt auch Java-APIs für ausgewählte DBMS_CLOUD_AI_AGENT-Vorgänge bereit. Diese APIs stellen datenbankdefinierte Agents, Aufgaben, Tools und Teams als typisierte Java-Ressourcen dar. Die Datenbank validiert und autorisiert Agent-Ressourcen und führt Agent- und Teamworkflows aus.

Weitere Informationen zu Agents, Aufgaben, Tools und Teams finden Sie unter AI Agent Framework für Java auswählen. Java-API-Details finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Das SDK verwendet JDBC für die Kommunikation mit der Datenbank und verwendet die zugrunde liegenden Datenbank-APIs, die für Select AI-Vorgänge erforderlich sind. Es unterstützt sowohl SDK-verwaltete JDBC-Verbindungen als auch anwendungsverwaltete DataSource-Verbindungen.

Diese Dokumentation enthält aufgabenorientierte Anleitungen zur Installation, Konfiguration und Verwendung des SDK. Vollständige Details zu Klasse, Methode, Parameter und Ausnahme finden Sie in der Select AI for Java API Reference.

Konstruktoren, Methoden, Anforderungs- und Antwortklassen, unterstützte Attribute, Parameter, Beispiele und Ausnahmen finden Sie unter AI für Java-API-Referenz (Javadoc) auswählen.

Unterstützte Umgebungen

Select AI für Java wurde validiert für:

  • Oracle Autonomous AI Database 26ai
  • Oracle Autonomous AI Database 19c

Das SDK verwendet den Oracle JDBC Thin-Treiber für die Datenbankkonnektivität. Sie können das SDK mit unterstützten Oracle-Datenbank-Deployments verwenden, die die erforderlichen Select AI-Datenbankpackages und -Berechtigungen bereitstellen. Bestätigen Sie die AI-Providerkonfiguration der unterstützten Datenbank- und JDBC-Treiberversionen und die erforderlichen Berechtigungen, bevor Sie eine Anwendung bereitstellen. Informationen zu den unterstützten Funktionen und den Datenbankversionen finden Sie unter Oracle AI Database Select AI Capability Matrix.

SDK herunterladen

Select AI for Java-Version 1.1.0 wird in Maven Central veröffentlicht.

Deklarieren Sie für Maven- und Gradle-Anwendungen das SDK als Abhängigkeit. Maven oder Gradle löst das SDK und seine Laufzeitabhängigkeiten von Maven Central auf.

Auf der Seite "Maven Central-Artefakt" können Sie Folgendes herunterladen: AI für Java 1.1.0 in Maven Central auswählen

Die SDK-Quelle ist auch im Oracle Select AI for Java GitHub-Repository verfügbar. Erstellen Sie nur aus der Quelle, wenn Sie zum SDK beitragen, quellbasierte Beispiele ausführen oder eine lokale Änderung prüfen müssen. API-Beschreibungen, -Klassen, -Methoden, -Parameter und -Nutzungsinformationen finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Ausgewählte KI für Java zu Ihrer Anwendung hinzufügen

Select AI for Java ist als Standard-Java-JAR verpackt. Die SDK-JAR enthält keine Laufzeitabhängigkeiten von Drittanbietern. Maven oder Gradle löst diese Abhängigkeiten aus dem veröffentlichten POM auf.

Für die Auswahl von AI für Java-Version 1.1.0 ist JDK 17 oder höher erforderlich.

Verwenden Sie die veröffentlichte Maven-Abhängigkeit für die Anwendungsentwicklung. Weitere Informationen finden Sie unter SDK herunterladen.

SDK zu einer Maven-Anwendung hinzufügen

Fügen Sie die folgende Abhängigkeit zur pom.xml Ihrer Anwendung hinzu:

<dependency>
    <groupId>com.oracle.database.selectai</groupId>
    <artifactId>select-ai</artifactId>
    <version>1.1.0</version>
</dependency>

Maven löst das SDK und seine transitiven Laufzeitabhängigkeiten aus dem veröffentlichten POM auf.

SDK zu einer Gradle-Anwendung hinzufügen

Für Gradle-Anwendungen, die Groovy DSL verwenden, fügen Sie der Datei build.gradle die folgende Konfiguration hinzu: Beispiel:

repositories {
    mavenLocal()
}

dependencies {
    implementation 'com.oracle.database.selectai:select-ai:1.1.0'
}

Hinweis

Hinweis: Die Gradle-Konfiguration verwendet das Maven Central-Artefakt. Es gibt keine separate Gradle-Verteilung.

Von Quelle erstellen und installieren

Erstellen Sie nur aus der Quelle, wenn Sie zum SDK beitragen, quellbasierte Beispiele ausführen oder eine lokale Änderung prüfen müssen. Die SDK-Quelle ist im Oracle Select AI for Java GitHub-Repository verfügbar. Für das Erstellen des SDK aus der Quelle wird Maven 3.8 oder höher empfohlen.

Erstellen und installieren Sie das SDK aus dem Repository-Root:

mvn clean install

Der Build installiert das folgende Artefakt in Ihrem lokalen Maven-Repository:

com.oracle.database.selectai:select-ai:1.1.0

Die lokal erstellte JAR ist verfügbar unter:

target/select-ai-1.1.0.jar

Wenn Sie das lokal erstellte Artefakt mit Gradle testen, verwenden Sie das lokale Maven-Repository:

repositories {
    mavenLocal()
    mavenCentral()
}

dependencies {
    implementation 'com.oracle.database.selectai:select-ai:1.1.0'
}

Laufzeitabhängigkeiten

Die SDK-JAR bündelt keine Drittanbieterabhängigkeiten. Wenn Sie das SDK als Maven- oder Gradle-Abhängigkeit verwenden, löst das Abhängigkeitsmanagementtool die erforderlichen direkten und transitiven Abhängigkeiten aus dem veröffentlichten POM auf.

Das SDK verwendet die folgenden primären Laufzeitabhängigkeiten:

Abhängigkeit Version Zweck
com.oracle.database.jdbc:ojdbc11 23.26.1.0.0 Oracle JDBC-Thin-Treiber
com.oracle.database.security:oraclepki 23.26.1.0.0 Unterstützung für Oracle Wallet und Sicherheit
org.slf4j:slf4j-api 2 Vom SDK verwendete Logging-API
com.fasterxml.jackson.core:jackson-databind 2,22 JSON-Serialisierung und Deserialisierung
Abhängigkeiten, die von Maven oder Gradle transitiv aufgelöst werden Nicht anwendbar Zusätzliche Bibliotheken, die von den direkten Abhängigkeiten benötigt werden, einschließlich Jackson-Kern und Annotationen sowie Abhängigkeiten von der Oracle-Sicherheitsunterstützung

Das SDK ist von der SLF4J-API abhängig, enthält jedoch keinen SLF4J-Loggingprovider. Konfigurieren Sie einen für Ihre Anwendung geeigneten SLF4J 2.x-Loggingprovider. Die Standalone-SDK-Beispiele verwenden slf4j-simple.

Wenn Sie die SDK-JAR direkt anstelle eines Abhängigkeitsmanagementsystems verwenden, müssen Sie die zugehörigen Laufzeitabhängigkeiten auch im Anwendungs-Classpath verfügbar machen. Verwenden Sie die aus dem SDK pom.xml aufgelösten Abhängigkeiten, um sicherzustellen, dass Sie die erforderlichen direkten und transitiven Abhängigkeiten einbeziehen.

So kopieren Sie Laufzeitabhängigkeiten für die direkte JAR-Verwendung:

mvn clean install
mvn -DincludeScope=runtime \
    -DoutputDirectory=target/dependency \
    dependency:copy-dependencies

Verwenden Sie die SDK-JAR und die kopierten Abhängigkeiten im Anwendungs-Classpath:

java -cp "target/select-ai-1.1.0.jar:target/dependency/*" \
    com.example.Application

Verwenden Sie unter Windows PowerShell ein Semikolon (;) anstelle eines Doppelpunkts (:) im Classpath:

java -cp "target/select-ai-1.1.0.jar;target/dependency/*" `
    com.example.Application

Verbindung zu Autonomous AI Database

Select AI for Java verwendet JDBC-Verbindungen für die Kommunikation mit der autonomen KI-Datenbank. Sie können Verbindungsinformationen direkt angeben oder eine JDBC-DataSource angeben.

Informationen zu Agent-spezifischem Verbindungslebenszyklus, Threading, Transaktion und Timeoutverhalten finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

JDBC-Verbindungen verwalten

Wählen Sie einen Ansatz zur Verbindungsverwaltung, bevor Sie Select AI-Objekte erstellen. Verwenden Sie einen konsistenten Ansatz in einer Anwendung, oder dokumentieren Sie die Eigentümerschaft eindeutig, wenn mehrere Komponenten dieselben Datenbankressourcen gemeinsam verwenden.

Das SDK unterstützt die folgenden Verbindungsmodi:

  • DbConnectionConfig: Eine Verbindungskonfiguration, die das SDK zum Abrufen und Verwalten von JDBC-Verbindungen verwendet.
  • DataSource: Eine DataSource, die von der Anwendung bereitgestellt wird.

DbConnection ist eine separate Standalone-API für Verbindungseigentümer.

Wenn die Anwendung eine Verbindung bereitstellt, stellen Sie sicher, dass die Verbindung geöffnet und für den beabsichtigten Datenbankbenutzer konfiguriert ist. Wenn das SDK Verbindungen aus einer Konfiguration oder DataSource bezieht, befolgen Sie die Lebenszyklusregeln, die in Select AI for Java API Reference (Javadoc) dokumentiert sind.

Wählen Sie den Modus aus, der dem Verbindungsverwaltungsmodell entspricht, das Ihre Anwendung verwendet. Anwendungen, die bereits einen Connection Pool verwenden, können den zugehörigen DataSource angeben. Anwendungen, die Verbindungseigenschaften direkt verwalten, können die SDK-Verbindungskonfiguration verwenden.

DBConnectionConfig

Mit DbConnectionConfig können Sie Datenbankverbindungseigenschaften und verbindungsbezogene Optionen definieren. Im DbConnectionConfig-Modus erstellt und ist das SDK Eigentümer einer einzelnen JDBC-Verbindung für den SelectAI-Client. Das SDK verwendet diese Verbindung für Vorgänge, die von diesem Client ausgeführt werden. Das SDK schließt die JDBC-Verbindung, wenn Sie SelectAI.close() aufrufen. Da der Client eine beibehaltene JDBC-Verbindung verwendet, behandeln Sie einen DbConnectionConfig-basierten SelectAI-Client als Single-Thread, es sei denn, Ihre Anwendung synchronisiert den Zugriff extern.

Verwenden Sie DbConnectionConfig für einfache Anwendungen, Befehlszeilenprogramme, Beispiele und Anwendungen, die eine Datenbankverbindung für einen SelectAI-Client verwenden. Die Konfiguration kann die Datenbank-URL, Authentifizierungsinformationen, Wallet- oder Sicherheitseinstellungen und optionale Laufzeiteinstellungen umfassen.

Behalten Sie Verbindungsinformationen und Secrets außerhalb des Anwendungsquellcodes bei. Verwenden Sie die für Ihr Deployment empfohlenen Funktionen für Zugangsdaten und Secret-Management.

Eine vollständige Liste der unterstützten Eigenschaften, Konstruktoren, Validierungsregeln und Authentifizierungsoptionen finden Sie unter AI for Java API Reference (Javadoc) auswählen.

DataSource

Verwenden Sie eine DataSource, wenn die Anwendung oder der Anwendungsserver Eigentümer von Verbindungserstellung und -pooling ist. Im Modus DataSource ist die Anwendung Eigentümer von DataSource. Das SDK ruft für jeden Vorgang eine JDBC-Verbindung aus DataSource ab und schließt die ausgeliehene Verbindung, nachdem der Vorgang abgeschlossen ist. Wenn DataSource einen Verbindungspool verwendet, gibt das Schließen der geliehenen Verbindung diesen an den Pool zurück. Wenn Sie SelectAI.close() aufrufen, wird die anwendungseigene DataSource nicht geschlossen.

Verwenden Sie den DataSource-Modus für Anwendungsserver, Spring- oder Jakarta-Anwendungen, Multithread-Services und Anwendungen, die JDBC-Verbindungspools verwalten. Eine DataSource kann Select AI für Java in vorhandene JDBC-Infrastruktur- und Unternehmensverbindungspools integrieren.

Die Anwendung ist weiterhin für die Konfiguration von DataSource, Poolkapazität, Validierung und Sicherheit verantwortlich. Das SDK verwendet das von der Anwendung bereitgestellte DataSource für Datenbankvorgänge.

Verbindungslebenszyklus

Schließen Sie Verbindungen und andere JDBC-Ressourcen gemäß dem von der Anwendung verwendeten Eigentümermodell. Geben Sie Ressourcen frei, wenn ein Vorgang abgeschlossen ist, und behalten Sie kurzlebige Verbindungen nicht länger als erforderlich bei.

Wenn eine Anwendung einen Connection Pool verwendet, geben Sie Verbindungen zum Pool zurück, anstatt die vom Pool verwaltete Ressource direkt zu schließen.

Das SDK verwaltet den JDBC-Verbindungslebenszyklus gemäß dem ausgewählten Verbindungsmodus:

Verbindungsmodus Verbindungseigentümerschaft Verbindungslebenszyklus
DbConnectionConfig SDK Das SDK erstellt eine Verbindung, verwendet sie für Clientvorgänge und schließt sie, wenn SelectAI.close() aufgerufen wird.
DataSource Anwendung Das SDK lehnt eine Verbindung für jeden Vorgang ab und schließt sie, nachdem der Vorgang abgeschlossen ist. Die Anwendung ist weiterhin Eigentümer der DataSource.

Ressourcenobjekte wie Profile, Conversation und VectorIndex verwenden den Verbindungslebenszyklus des zugehörigen SelectAI-Clients. Sie erstellen oder besitzen keine separate JDBC-Verbindung.

Threadingverhalten

Select AI for Java unterstützt unterschiedliches Threading-Verhalten basierend auf dem Verbindungsmodus und der Verwendung von SDK-Ressourcenobjekten durch Anwendungen. Das SDK garantiert keine globale Threadsicherheit für alle öffentlichen Objekte.

Im DataSource-Modus können Sie einen SelectAI-Client für unabhängige Vorgänge über Threads hinweg freigeben, da jeder Vorgang seine eigene JDBC-Verbindung erhält.

Behandeln Sie den SelectAI-Client im DbConnectionConfig-Modus als Single-Thread, es sei denn, Ihre Anwendung synchronisiert den Zugriff auf die beibehaltene JDBC-Verbindung.

Achtung: Mehrere Threads können separate Ressourceninstanzen für unabhängige Vorgänge verwenden. Wenn mehrere Threads dieselbe Ressourceninstanz verwenden, dürfen Sie diese Ressource nur dann gleichzeitig ändern, wenn Ihre Anwendung den Zugriff synchronisiert. Beispiel: Verwenden Sie nicht mehrere Threads gleichzeitig, um dieselben Ressourcen wie die Instanz Profile, Credential, Conversation oder VectorIndex zu ändern. Erstellen, aktualisieren, aktivieren, deaktivieren oder löschen Sie nicht gleichzeitig dieselbe Ressource. Wenn Ihre Anwendung nebenläufigen Zugriff auf dieselbe Ressourceninstanz benötigt, synchronisieren Sie den Zugriff in der Anwendung.

Transaktionsverhalten

Select AI for Java verwendet das JDBC-Transaktionsverhalten. Das Transaktionsverhalten hängt von der Verbindungskonfiguration und den vom SDK verwendeten Oracle AI Database-APIs ab. Konfigurieren Sie Auto-Commit- und Transaktionsgrenzen entsprechend den Anforderungen der Anwendung und des Datenbankvorgangs. Select AI for Java schreibt keine Transaktionen explizit fest oder setzt sie zurück. Die Einstellung autoCommit der JDBC-Verbindung wird nicht geändert.

Im DbConnectionConfig-Modus verwendet das SDK seine JDBC-Verbindung über alle Vorgänge hinweg wieder. Wenn autoCommit deaktiviert ist, nehmen SDK-Vorgänge und benutzerdefinierte JDBC-Anweisungen, die dieselbe Verbindung verwenden, gemäß der JDBC- und Oracle AI Database-Transaktionssemantik an der Verbindungstransaktion teil.

Im DataSource-Modus ruft das SDK eine JDBC-Verbindung für jeden Vorgang ab und schließt die Verbindung, nachdem der Vorgang abgeschlossen ist. Das SDK ändert nicht explizit die Einstellung autoCommit der Verbindung, schreibt die Transaktion fest oder setzt sie zurück, bevor die Verbindung zurückgegeben wird. Der DataSource- oder Verbindungspool steuert, wie der Verbindungsstatus und ausstehende Transaktionen behandelt werden, wenn eine geliehene Verbindung an den Pool zurückgegeben wird.

Hinweis

Hinweis: Im Modus DataSource ruft jeder SDK-Vorgang eine Verbindung aus DataSource ab. Verlassen Sie sich daher nicht darauf, dass nicht festgeschriebene Änderungen von einem SDK-Vorgang für einen anderen Vorgang verfügbar sind.

SDK-Vorgänge, die Profil-, Zugangsdaten-, Unterhaltungs- und Vektorindexvorgänge erstellen oder ändern, verwenden das Transaktionsverhalten der JDBC-Verbindung und der zugrunde liegenden Oracle AI Database-API. Einige zugrunde liegende Datenbank-APIs können ein implizites Commit oder Rollback ausführen. Das SDK ändert oder setzt dieses Datenbankverhalten nicht außer Kraft.

Hinweis

Hinweis: Im DbConnectionConfig-Modus gibt SelectAI.getConnection() die JDBC-Verbindung zurück, die das SDK für seine Vorgänge verwendet. Sie können diese Verbindung für benutzerdefinierte JDBC-Arbeiten in derselben Datenbanksession verwenden. Ob SDK-Vorgänge und benutzerdefinierte JDBC-Anweisungen eine einzelne atomare Transaktion bilden können, hängt vom Transaktionsverhalten der zugrunde liegenden Oracle AI Database-APIs ab.

Abfragetimeout

Mit der Option "Abfrage-Timeout" wird das JDBC-Anweisungstimeout konfiguriert. Verwenden Sie SelectAIOptions.queryTimeoutSeconds(), um den Abfrage-Timeout für JDBC-Anweisungen für SDK-Vorgänge zu konfigurieren. Standardmäßig konfiguriert das SDK keinen JDBC-Abfrage-Timeout. Ein nicht festgelegter oder Nullwert bedeutet, dass das SDK Statement.setQueryTimeout() nicht aufruft. Der Wert 0 verwendet das JDBC-No-Timeout-Verhalten. Das SDK lehnt negative Werte ab.

Der konfigurierte Timeout gilt für JDBC-Anweisungen, die für SDK-Vorgänge erstellt wurden. Es steuert den Timeout für JDBC- oder Datenbankanweisungen. Es wird nicht konfiguriert:

  • Timeout bei AI-Provideranforderungen
  • HTTP-Verbindungs- oder Lese-Timeouts
  • Stornierung einer Remote-Modellanforderung
  • ein separater Timeout für einen DBMS_CLOUD_AI-Vorgang mit langer Ausführungszeit

Wenn ein Datenbankvorgang bereits eine Anforderung an einen AI-Provider gesendet hat, garantiert ein JDBC-Anweisungstimeout nicht die Stornierung der Provideranforderung. Ob und wann der JDBC-Treiber den Datenbankaufruf unterbricht, hängt von Oracle JDBC und dem Datenbankverhalten ab.

Einzelheiten zu SelectAIOptions, Verbindungsmanagement und Ressourcenvorgängen finden Sie unter AI für Java-API-Referenz (Javadoc) auswählen.

Bevor Sie beginnen

Vor der Verwendung von Select AI für Java:

  1. Bestätigen Sie, dass das Datenbankrelease unterstützt wird.
  2. Rufen Sie die Datenbankverbindungsinformationen und die für die Anwendung erforderliche Authentifizierung ab.
  3. Konfigurieren Sie den erforderlichen AI-Provider und die Datenbankzugangsdaten.
  4. Erstellen oder identifizieren Sie ein KI-Profil für den beabsichtigten Workflow.
  5. Vergewissern Sie sich, dass der Datenbankbenutzer über die Berechtigungen und den Netzwerkzugriff verfügt, die für die ausgewählten Features erforderlich sind.
  6. Informationen zu den Setupanforderungen finden Sie unter Voraussetzungen für ausgewählte KI ausführen.

Datenbankberechtigungen und Netzwerkzugriff verwalten

Select AI for Java stellt die Schnittstelle DatabaseAdmin für privilegierte Datenbanksetupvorgänge bereit. Verwenden Sie die Schnittstelle SelectAI für normale Anwendungsvorgänge.

Verwenden Sie DatabaseAdmin nur in einem separat kontrollierten Provisioning- oder Administrationsworkflow. Setzen Sie DatabaseAdmin nicht normalen Anwendungsbenutzern zur Verfügung, oder nehmen Sie es nicht in den allgemeinen Laufzeitpfad der Anwendung auf.

Die Schnittstelle DatabaseAdmin bietet administrative Methoden für:

  • Erteilen oder widerrufen Sie Select AI-Package-Berechtigungen für Datenbankbenutzer.
  • Erteilen oder widerrufen Sie HTTP-Zugriff auf externe Hosts.
  • Erteilen oder widerrufen Sie den Netzwerkzugriff für angegebene Hosts, Berechtigungen und optionale Portbereiche.
  • Aktivieren oder deaktivieren Sie den Select AI-Datenzugriff.

Für diese Vorgänge ist ein entsprechend privilegierter administrativer Datenbankbenutzer erforderlich. Der Datenbankbenutzer, der die Anwendung ausführt, benötigt keine DatabaseAdmin-Berechtigungen, es sei denn, dieser Benutzer führt auch ein administratives Setup durch.

Packageberechtigungen

Verwenden Sie die Packageberechtigungsmethoden DatabaseAdmin, um die Datenbankpackageberechtigungen zu erteilen oder zu entziehen, die Select AI-Benutzer benötigen.

Um Select AI zu verwenden, erteilt ein Datenbankadministrator dem Datenbankbenutzer EXECUTE auf DBMS_CLOUD_AI. Die Auswahl von AI-Funktionen kann zusätzliche Packageberechtigungen erfordern. Beispiel: Retrieval-Augmented Generation (RAG) benötigt Zugriff auf DBMS_CLOUD_PIPELINE.

Zugangsdatenvorgänge verwenden DBMS_CLOUD und erfordern, dass der Datenbankbenutzer, der Zugangsdaten verwaltet, Zugriff auf die entsprechenden DBMS_CLOUD-APIs hat.

Package erteilt den in der administrativen Anforderung angegebenen Datenbankbenutzern Änderungsberechtigungen. Führen Sie diese Berechtigungen während des Datenbank- oder Anwendungs-Provisionings und nicht während des normalen Anwendungsstarts aus.

Die erforderlichen Berechtigungen finden Sie unter Voraussetzungen für KI auswählen.

Netzwerkzugriff

Verwenden Sie die Netzwerkzugriffsmethoden DatabaseAdmin nur, wenn ein Datenbankadministrator den ausgehenden Zugriff für Select AI-Benutzer konfigurieren muss.

Die API bietet:

  • HTTP-Zugriffsmethoden zum Erteilen oder Entziehen von HTTP-Zugriff auf einen angegebenen Host.
  • Allgemeine Methoden für den Netzwerkzugriff zum Erteilen oder Entziehen bestimmter Netzwerkberechtigungen für einen Host und optional für einen TCP-Portbereich.

Die Netzwerk-ACL-Konfiguration ist nicht für jeden Select AI-Provider oder jedes Datenbank-Deployment erforderlich. Konfigurieren Sie den Netzwerkzugriff nur, wenn der ausgewählte Provider und das ausgewählte Deployment dies erfordern. Beispiel: "Select AI" erfordert keine Netzwerk-ACL für OCI Generative AI.

Netzwerk-ACL-Änderungen ändern die ACL-Konfiguration des Datenbanknetzwerks. Die ACL-Konfiguration befindet sich in der Datenbank und nicht in der Java-Anwendung oder im Schema des Zielbenutzers. Ein Zugriffskontrolleintrag identifiziert den Datenbankbenutzer oder die Datenbankrolle, der bzw. die Zugriff erhält. Daher gewährt die Konfiguration einer ACL nicht automatisch jedem Datenbankbenutzer Netzwerkzugriff.

Geben Sie nur die Hosts an, die für die Anwendung erforderlich sind. Ein Host kann einen Hostnamen, eine IP-Adresse, eine Domain oder einen unterstützten Platzhalter identifizieren. Verwenden Sie gegebenenfalls die Parameter für den unteren und oberen Port, um den Zugriff auf den erforderlichen TCP-Portbereich einzuschränken. Wenn Sie keinen Portbereich angeben, bestimmen die zugrunde liegenden Netzwerk-ACL-Regeln den Zugriff ohne Portbeschränkung.

Änderungen an der Netzwerk-ACL bleiben Teil der Datenbankkonfiguration, bis ein Administrator sie ändert oder entfernt. Sie sind keine temporären Einstellungen, die mit dem Java-SDK-Prozess oder der JDBC-Session verknüpft sind.

Achtung: Änderungen an der Netzwerk-ACL wirken sich auf die Datenbanksicherheitskonfiguration aus. Konfigurieren Sie den Netzwerkzugriff als Teil eines kontrollierten Provisioning- oder Administrationsworkflows. Erteilen Sie der normalen Anwendungslaufzeit keine DatabaseAdmin-Netzwerkverwaltungsberechtigungen.

Informationen zu Providerendpunkten und Netzwerkanforderungen finden Sie unter Voraussetzungen für ausgewählte KI ausführen.

AI-Datenzugriff auswählen

Mit DatabaseAdmin.enableDataAccess() und DatabaseAdmin.disableDataAccess() können Sie steuern, ob anwendbare Select AI-Features Datenbankdaten oder Dokumentinhalte für die Vektorsuche an ein großes Sprachmodell senden können.

Diese Einstellung gilt für Select AI-Funktionen, die Datenzugriff erfordern, einschließlich der Aktion "Erzählen", "Retrieval-Augmented Generation" (RAG) und "Synthetische Datengenerierung".

Nur ein Administrator kann die Einstellung "AI-Datenzugriff auswählen" ändern. Die zugrunde liegenden Prozeduren DBMS_CLOUD_AI.ENABLE_DATA_ACCESS und DBMS_CLOUD_AI.DISABLE_DATA_ACCESS akzeptieren keinen Datenbankbenutzer oder Schemaparameter.

Änderungen an "AI-Datenzugriff auswählen" als administrative Datenbankkonfiguration behandeln. Konfigurieren Sie die erforderliche Einstellung beim Provisioning oder durch eine explizit autorisierte administrative Änderung, anstatt während des normalen Anwendungsstarts.

Achtung: Wenn Sie "KI-Datenzugriff auswählen" deaktivieren, können ausgewählte KI-Funktionen eingeschränkt werden, die Datenbankdaten oder abgerufenen Dokumentinhalt an den KI-Provider senden müssen. Prüfen Sie die betroffenen Select AI-Funktionen, bevor Sie diese Einstellung ändern.

Administrative und Laufzeitvorgänge

Oracle empfiehlt, das administrative Setup von der normalen Anwendungsverarbeitung zu trennen.

Arbeitsvorgang Empfohlene Verwendung
Select AI-Package-Berechtigungen erteilen oder entziehen Einmaliges Provisioning oder autorisierte administrative Änderung
HTTP-Zugriff erteilen oder entziehen Einmaliges Provisioning oder Änderung einer autorisierten Netzwerkkonfiguration
Erteilen oder Entziehen des allgemeinen Netzwerkzugriffs Einmaliges Provisioning oder Änderung einer autorisierten Netzwerkkonfiguration
Aktivieren oder Deaktivieren des Select AI-Datenzugriffs Kontrollierte administrative Konfiguration
Erstellen und Verwenden von Profilen, Unterhaltungen und Vektorindizes Normaler Anwendungsworkflow, nachdem erforderliche Berechtigungen und Konfiguration vorhanden sind
Prompts und andere Select AI-Anforderungen verarbeiten Normale Anwendungslaufzeit

Verwenden Sie einen Datenbankbenutzer mit den geringsten Berechtigungen für die normale Anwendungslaufzeit. Erteilen Sie einem Anwendungsbenutzer keine administrativen Berechtigungen, damit die Anwendung beim Start ihre eigenen Voraussetzungen konfigurieren kann.

Informationen zu den erforderlichen Select AI-Berechtigungen, Zugangsdaten, Providerkonfiguration und Netzwerkanforderungen finden Sie unter Voraussetzungen für Select AI ausführen.

Informationen zu DatabaseAdmin-Methoden, -Parametern und -Ausnahmen finden Sie unter AI for Java API Reference (Javadoc) auswählen

Aufgaben, die sie ausführen können

Das Select AI for Java SDK stellt eine Java-API für die Arbeit mit Select AI-Ressourcen bereit.

In der folgenden Tabelle werden die primären Select AI for Java-Funktionen zusammengefasst:

Fähigkeit Beschreibung
Natural Language-to-SQL Generieren Sie SQL aus Eingabeaufforderungen in natürlicher Sprache mit der GenerateAction.
Generierte SQL ausführen Generieren Sie SQL aus einer Eingabeaufforderung in natürlicher Sprache, und führen Sie die generierte SQL mit Profile.runsql() aus.
Generierte SQL anzeigen Geben Sie die aus einer Eingabeaufforderung in natürlicher Sprache generierte SQL zurück, ohne die SQL mit Profile.showsql() auszuführen.
Generierte SQL erläutern Generieren Sie SQL, und geben Sie mit Profile.explainsql() eine Erklärung der SQL in natürlicher Sprache zurück.
Abfrageergebnisse angeben Generieren und führen Sie SQL aus, und geben Sie die Abfrageergebnisse in natürlicher Sprache mit Profile.narrate() zurück.
Chat Senden Sie eine allgemeine Eingabeaufforderung in natürlicher Sprache an den im KI-Profil konfigurierten KI-Provider mit Profile.chat().
Erweiterte Eingabeaufforderung anzeigen Geben Sie den erweiterten Prompt zurück, den Select AI für den AI-Provider vorbereitet, indem Sie Profile.showprompt() verwenden.
KI-Profile Erstellen und verwalten Sie KI-Profile, die KI-Provider, Zugangsdaten, Modelleinstellungen, Datenbankobjekte und Vektorindizes definieren.
Zugangsdaten Erstellen und löschen Sie Datenbankzugangsdaten, die für den Zugriff auf AI-Provider oder Objektspeicher verwendet werden.
Unterhaltungen Erstellen und verwalten Sie Unterhaltungen, die Kontext über zugehörige Prompts hinweg verwalten.
Retrieval-Augmented Generation Erstellen und verwalten Sie Vektorindizes, mit denen Select AI relevante Inhalte für RAG abrufen kann. Konfigurieren Sie ein KI-Profil, um einen Vektorindex zu verwenden, und verwenden Sie das RAG-fähige Profil, um relevanten Inhalt aus dem Vektorspeicher abzurufen und den an den KI-Provider gesendeten Prompt zu erweitern. Weitere Informationen finden Sie unter AI mit Retrieval Augmented Generation (RAG) auswählen.
Synthetische Daten Generieren Sie synthetische Daten für ein Datenbankobjekt oder eine Gruppe zugehöriger Objekte. Weitere Informationen finden Sie unter Synthetische Datengenerierung.
Zusammenfassung Fassen Sie Inlinetext oder Inhalt zusammen, der durch einen externen Speicherort identifiziert wird, indem Sie Profile.summarize() verwenden. Weitere Informationen finden Sie unter Zusammenfassung mit ausgewählter KI generieren.
Übersetzung Übersetzen Sie Text in den unterstützten Sprachen, indem Sie den Provider verwenden, der in einem AI-Profil mit Profile.translate() konfiguriert ist. Select AI Translate unterstützt OCI, Google, AWS und Azure. Jeder Provider hat seine eigenen Authentifizierungs-, Autorisierungs- und Serviceanforderungen. Die für die Übersetzung verfügbaren Sprachen hängen vom ausgewählten Anbieter und dessen Übersetzungsservice ab. Provider-spezifische Anforderungen und unterstützte Übersetzungsfunktionen finden Sie unter Übersetzen.
Feedback Geben Sie mit Profile.feedback() positives oder negatives Feedback für die NL2SQL-Generierung ab. Positives Feedback bestätigt generiertes SQL für zukünftige Referenzzwecke. Mit negativem Feedback können Sie Probleme mit der generierten SQL identifizieren und die erwartete SQL oder zusätzliche Anleitung bereitstellen. Select AI verknüpft Feedback mit dem AI-Profil und der angegebenen SQL-ID oder dem angegebenen SQL-Text und speichert das Feedback in einem profilspezifischen Feedbackvektorindex. Select AI kann gespeichertes Feedback als Hinweise für ähnliche Prompts bei der nachfolgenden SQL-Generierung verwenden. Weitere Informationen finden Sie unter Feedback.
Netzwerkkonfiguration Verwalten Sie Packageberechtigungen, Datenzugriff, HTTP-Zugriff und Netzwerk-ACL-Zugriff über die DatabaseAdmin-Methoden in der Schnittstelle DatabaseAdmin.
JDBC-Verbindungsverwaltung Verwenden Sie eine SDK-eigene JDBC-Verbindung oder eine anwendungsverwaltete DataSource.

Java-API-Details finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Unterstützte Klassen

Select AI for Java stellt öffentliche Schnittstellen und Modellklassen für Anwendungsvorgänge, administrative Konfiguration, Verbindungsmanagement und Select AI-Ressourcenkonfiguration bereit.

Anwendungscode muss die öffentlichen Schnittstellen in com.oracle.database.selectai und die zugehörigen Modelltypen in com.oracle.database.selectai.model verwenden. Klassen in com.oracle.database.selectai.impl sind interne Implementierungsklassen und nicht für die direkte Anwendungsverwendung vorgesehen.

Primäre Anwendungsklassen

Verwenden Sie diese Klassen für allgemeine Select AI-Anwendungsworkflows.

Klasse oder Schnittstellen Zweck
SelectAI Stellt den wichtigsten Anwendungseinstiegspunkt für Select AI bereit. Damit können Sie mit Profilen, Zugangsdaten, Unterhaltungen und Vektorindizes arbeiten und Vorgänge auf Collection-Ebene ausführen.
Profile Erstellt und verwaltet KI-Profile und bietet eine schnelle Zusammenfassung, Übersetzung, Feedback und synthetische Datenvorgänge.
Credential Erstellt und löscht Datenbankzugangsdaten.
Conversation Erstellt und verwaltet Select AI-Unterhaltungen und deren Prompt-Metadaten.
VectorIndex Erstellt und verwaltet Vektorindizes, die von Retrieval-Augmented Generation (RAG) verwendet werden.

Administrative Klassen

Verwenden Sie die Schnittstelle DatabaseAdmin getrennt von der normalen Anwendungsverarbeitung.

Klasse oder Schnittstellen Zweck
DatabaseAdmin Verwaltet ausgewählte AI-Packageberechtigungen, Datenzugriff, HTTP-Zugriff und Netzwerk-ACL-Konfiguration.

Verwenden Sie DatabaseAdmin nur in einem separat kontrollierten Provisioning- oder Administrationsworkflow. Weitere Informationen finden Sie unter Datenbankberechtigungen und Netzwerkzugriff verwalten.

Konfigurations- und Anforderungsmodelle

Verwenden Sie die folgenden Modellklassen, um SDK-Ressourcen und -Vorgänge zu konfigurieren.

Class Zweck
DbConnectionConfig Definiert die JDBC-Verbindungskonfiguration für eine SDK-eigene Verbindung.
SelectAIOptions Definiert optionale SDK-Einstellungen, einschließlich des Abfrage-Timeouts der JDBC-Anweisung.
ProfileAttributes Definiert AI-Profilattribute.
CredentialConfig Definiert die Konfiguration der Datenbankzugangsdaten.
ConversationAttributes Definiert Unterhaltungsmetadaten.
VectorIndexConfig Definiert die Konfiguration der Vektorindexerstellung.
VectorIndexAttributes Definiert Vektorindexattribute.
Feedback Definiert Feedback für die NL2SQL-Generierung.
SummaryParams Definiert optionale Zusammenfassungsparameter.
SyntheticDataSingleRequest Definiert eine Anforderung synthetischer Daten für ein Datenbankobjekt.
SyntheticDataBatchRequest Definiert eine Anforderung synthetischer Daten für mehrere Datenbankobjekte.
SelectAIException Meldet JDBC-, Datenbank-, DBMS_CLOUD- und DBMS_CLOUD_AI-Fehler über das SDK.

Verbindungs-APIs und Erweiterungspunkte

Das SDK bietet öffentliche Verbindungsschnittstellen und Erweiterungspunkte für Anwendungen, die direkten JDBC-Verbindungszugriff oder benutzerdefinierte Verbindungsverarbeitung erfordern.

Klasse oder Schnittstellen Zweck
DbConnection Stellt eine Standalone-SDK-eigene JDBC-Verbindung bereit. Die Anwendung schließt DbConnection, wenn sie die Verbindung nicht mehr benötigt.
ConnectionProvider Definiert die öffentliche Abstraktion, die JDBC-Verbindungen für SDK-Vorgänge bereitstellt.
ConnectionCallback<T> Definiert Arbeit, die eine JDBC-Verbindung verwendet, die über eine ConnectionProvider bereitgestellt wird.

Für die meisten Anwendungen verwenden Sie DbConnectionConfig oder ein anwendungsverwaltetes DataSource mit SelectAI. Verwenden Sie die Verbindungserweiterungspunkte nur, wenn Ihre Anwendung eine benutzerdefinierte JDBC-Verbindungsverarbeitung erfordert.

Informationen zu Verbindungseigentümerschaft, Lebenszyklus, Transaktion und Threading-Verhalten finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

Bereitstellerklassen

Select AI for Java stellt AI-Provider über die Enumeration Provider und anbieterspezifische Konfigurationsklassen für unterstützte AI-Provider dar. Verwenden Sie die entsprechende Providerkonfiguration, wenn Sie ein AI-Profil konfigurieren.

Select AI for Java umfasst die folgenden Providerkonfigurationsklassen:

  • OpenAIProviderProfile
  • CohereProviderProfile
  • AzureProviderProfile
  • OCIGenAIProviderProfile
  • GoogleProviderProfile
  • HuggingFaceProviderProfile
  • AWSProviderProfile

Verwenden Sie die Providerkonfiguration für den Provider, den Sie in ProfileAttributes konfigurieren. Providervoraussetzungen und Konfigurationsanforderungen finden Sie unter Voraussetzungen für ausgewählte KI ausführen.

Interne Implementierungsklassen

Klassen im Package com.oracle.database.selectai.impl implementieren die öffentlichen SDK-Schnittstellen und verwalten interne JDBC- und Datenbankinteraktionen.

Hinweis

Hinweis: Klassen im Package com.oracle.database.selectai.impl stellen die internen Implementierungen der öffentlichen SDK-Schnittstellen bereit. Diese Klassen werden nicht als anwendungsorientierte APIs unterstützt und können sich unabhängig von der öffentlichen API ändern. Verwenden Sie stattdessen die öffentlichen Schnittstellen und Factory-Methoden in com.oracle.database.selectai.

Vollständige Informationen zu öffentlichen Klassen, Schnittstellen, Modelltypen, Methoden und Erweiterungspunkten finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Mit Zugangsdaten arbeiten

Eine Datenbankzugangsdaten speichert Authentifizierungsinformationen, mit denen Autonomous AI Database auf einen AI-Provider oder einen externen Service wie Object Storage zugreift.

Erstellen Sie die erforderlichen Zugangsdaten, bevor Sie ein AI-Profil oder einen Vektorindex erstellen, der sie referenziert. Der Datenbankbenutzer, der die Zugangsdaten erstellt, ist Eigentümer dieser Zugangsdaten, und der Zugangsdatenname identifiziert sie im Schema dieses Benutzers.

Zugangsdaten erstellen und verwalten

Verwenden Sie SelectAI.credential(CredentialConfig), um ein Credential-Objekt aus der Zugangsdatenkonfiguration zu erstellen. Diese Methode erstellt nur ein Java Credential-Objekt. Die Zugangsdaten werden nicht in der Datenbank erstellt. Rufen Sie Credential.create() für das zurückgegebene Credential-Objekt auf, um die Datenbankzugangsdaten zu erstellen.

Verwenden Sie die folgenden Credential-Methoden:

  • create(): Erstellt die Datenbankzugangsdaten.
  • drop(): Entfernt die Datenbankzugangsdaten.
  • drop(boolean force): Entfernt die Datenbankzugangsdaten, und wenn force den Wert true hat, werden bereits fehlende Zugangsdaten als erfolgreiches Ergebnis behandelt.

Die Klasse CredentialConfig definiert die Details zur Zugangsdatenerstellung, einschließlich des Zugangsdatennamens und der unterstützten Authentifizierungsinformationen.

Berechtigung für Zugangsdaten

Der Datenbankbenutzer, der die Zugangsdaten erstellt, ist Eigentümer der Zugangsdaten. Der Zugangsdatenname identifiziert die Zugangsdaten im Schema dieses Benutzers.

Das SDK bietet keine Methode zum Abrufen der gespeicherten Secret-Werte von Zugangsdaten. Schützen Sie Passwörter, Private Keys, Fingerprints, OCIDs und vollständige Zugangsdatenkonfigurationen. Schließen Sie keine Secrets in Quellcode, Logs, Fehlerberichte oder Prompts ein.

AI-Providerzugangsdaten

Die Zugangsdaten des AI-Providers speichern die Authentifizierungsinformationen, die für den Zugriff auf den konfigurierten AI-Provider erforderlich sind.

Konfigurieren Sie Zugangsdaten eines AI-Providers, wenn das AI-Profil Datenbankzugangsdaten für die Providerauthentifizierung erfordert. Das Profil referenziert die Zugangsdaten über seine Profilkonfiguration nach Namen.

Bei der OCI-Authentifizierung unterstützt CredentialConfig die Zugangsdatenkonfiguration, die den Zugangsdatennamen, die Benutzer-OCID, die Mandanten-OCID, den Private Key und den Fingerprint enthält.

Object Storage-Zugangsdaten

Verwenden Sie Datenbankzugangsdaten, um den Zugriff auf Object Storage zu authentifizieren, wenn ein Vektorindex dort gespeicherte Inhalte verwendet.

Das Select AI for Java SDK definiert keinen separaten Java-Typ für Object Storage-Zugangsdaten. Erstellen Sie die Datenbankzugangsdaten mit Methoden in der Schnittstelle Credential. Geben Sie die Zugangsdaten für den Object Storage-Zugriff in der Vektorindexkonfiguration an.

VectorIndexAttributes definiert das Object Storage-Zugangsdatenattribut zusammen mit anderen Vektorindexattributen, wie dem Quellspeicherort.

Dieselben Datenbankzugangsdaten können von mehreren Select AI-Ressourcen referenziert werden, wenn sie dieselben Authentifizierungsinformationen benötigen.

Zugangsdaten löschen

Verwenden Sie Credential.drop() oder Credential.drop(boolean force), um Zugangsdaten zu entfernen.

Wenn Sie Zugangsdaten löschen, werden AI-Profile oder Vektorindizes, die sie referenzieren, nicht automatisch aktualisiert. Wenn eine Ressource weiterhin die gelöschten Zugangsdaten referenziert, kann ein Vorgang, für den die Zugangsdaten erforderlich sind, fehlschlagen.

Achtung: Bevor Sie Zugangsdaten löschen, identifizieren Sie die KI-Profile, Vektorindizes und andere Ressourcen, die sie referenzieren. Aktualisieren oder entfernen Sie diese Abhängigkeiten nach Bedarf.

OCI-Ressourcen-Principals und Instanz-Principals

Einige OCI-Authentifizierungskonfigurationen können Resource Principals oder Instanz-Principals anstelle von gespeicherten Benutzerzugangsdaten verwenden. Wenn der ausgewählte Provider und die ausgewählte Datenbankumgebung diese Authentifizierungsmethoden unterstützen, können Sie die unterstützte OCI-Authentifizierungskonfiguration verwenden, ohne Benutzer-Signaturinformationen in Datenbankzugangsdaten zu speichern.

Providerspezifische Authentifizierungsanforderungen finden Sie unter Voraussetzungen für ausgewählte KI ausführen.

Informationen zur Zugangsdatenkonfiguration, unterstützten Authentifizierungseigenschaften, Lebenszyklusvorgängen und Ausnahmen finden Sie unter AI für Java-API-Referenz (Javadoc) auswählen.

Mit KI-Profilen arbeiten

Ein AI-Profil definiert, wie Select AI mit einem AI-Provider kommuniziert und welche Datenbankobjekte und Vektorindizes Select AI verwenden kann. Ein Profil kann Provider-, Modell-, Berechtigungsnachweis-, Objektlisten-, Konversations-, Übersetzungs- und Vektorindexeinstellungen enthalten.

Verwenden Sie die Schnittstelle Profile, um KI-Profile zu erstellen und zu verwalten und AI-Vorgänge auszuwählen. Alle Methoden in der Schnittstelle Profile sind synchron. Der aufrufende Thread wartet, bis jeder Vorgang abgeschlossen ist oder einen Fehler zurückgibt.

AI-Profil konfigurieren

Verwenden Sie die Klasse ProfileAttributes, um ein AI-Profil zu konfigurieren. Die Profilkonfiguration hängt vom Provider und der von Ihnen verwendeten Select AI-Funktion ab.

Geben Sie den Provider und andere Attribute an, die für diesen Provider erforderlich sind. Provider-spezifische Attribute können das Modell, die Zugangsdaten, den Endpunkt, die Region, das Compartment und andere Providereinstellungen umfassen.

Konfigurieren Sie Datenbankzugangsdaten, bei denen der ausgewählte Provider und die Authentifizierungsmethode eine benötigen. Für einige unterstützte Authentifizierungsmethoden sind keine gespeicherten Datenbankzugangsdaten erforderlich.

Verwenden Sie die providerspezifischen Konfigurationsklassen in ProviderProfile, um Providereinstellungen zu definieren. Die erforderlichen und optionalen Attribute für jeden Provider finden Sie unter Voraussetzungen für KI auswählen.

AI-Profil erstellen

Verwenden Sie SelectAI.profile(String profileName, ProfileAttributes profileAttributes, String description, ProfileStatus status), um ein Java Profile-Objekt zu erstellen, das mit der Profilkonfiguration initialisiert wurde.

Mit dieser Methode wird das AI-Profil nicht in der Datenbank erstellt. Rufen Sie Profile.create() für das zurückgegebene Objekt auf, um das Datenbankprofil zu erstellen.

Zum Beispiel:

ProfileAttributes attributes =
    ProfileAttributes.builder()
        .provider(Provider.OCI)
        // Add provider-specific attributes.
        .build();

Profile profile =
    selectAI.profile(
        "MY_PROFILE",
        attributes,
        "Select AI profile",
        ProfileStatus.ENABLED);

profile.create();

Die erforderlichen ProfileAttributes-Werte hängen vom ausgewählten Provider, der Authentifizierungsmethode und der Profilfunktionalität ab. Konfigurieren Sie erforderliche Zugangsdaten, bevor Sie ein Profil erstellen, das sie referenziert.

Ein vollständiges Beispiel für die Profilerstellung für Ihren Provider finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Vorhandenes KI-Profil verwenden

Verwenden Sie SelectAI.profile(String profileName), um ein vorhandenes AI-Profil im aktuellen Schema zu öffnen. Die Methode gibt ein Profile-Objekt zurück, das Sie für Profilvorgänge verwenden können.

Zum Beispiel:

Profile profile = selectAI.profile("MY_PROFILE");

String sql = profile.showsql("Show the total sales by region");

Verwenden Sie die Schnittstelle Profile, um:

  • Generieren und führen Sie SQL mit runsql() aus.
  • Generieren Sie SQL, ohne es mit showsql() auszuführen.
  • Generierte SQL mit explainsql() erläutern
  • Geben Sie Abfrageergebnisse mit narrate() an.
  • Chatten Sie mit dem konfigurierten KI-Provider mit chat().
  • Geben Sie den erweiterten Prompt mit showprompt() zurück.
  • Verwenden Sie Retrieval-Augmented Generation (RAG) mit Vektorindizes, die im AI-Profil über ProfileAttributes konfiguriert sind.
  • Fassen Sie den Inhalt mit summarize() zusammen.
  • Übersetzen Sie Inhalte mit translate().
  • Feedback für generiertes SQL senden mit feedback().
  • Generieren Sie synthetische Daten mit generateSyntheticData().

Datenbankobjekte für NL2SQL konfigurieren

Mit der Konfiguration der Profilobjektliste können Sie steuern, welche Datenbankobjekte Select AI beim Generieren von SQL berücksichtigt.

Die Klasse ProfileAttributes unterstützt die Objektlistenkonfiguration und die ObjectListMode-Werte AUTOMATED und ALL. Die Einstellungen der Objektliste des Profils bestimmen die Datenbankmetadaten, die Select AI für die SQL-Generierung in natürlicher Sprache zur Verfügung stellt.

Die Objektliste erteilt keine Datenbankberechtigungen. Der Datenbankbenutzer muss über die erforderlichen Berechtigungen für die Objekte verfügen, die das Profil verwendet.

Informationen zur Konfiguration der Objektliste und zum Verhalten der Objektauswahl finden Sie unter KI-Profile verwalten.

Vektorindizes für RAG konfigurieren

Verknüpfen Sie Vektorindizes mit einem AI-Profil, um Retrieval-Augmented Generation (RAG) zu verwenden. Die Klasse ProfileAttributes stellt die Vektorindexeinstellungen bereit, die das Profil verwendet.

Wenn Sie ein RAG-fähiges Profil verwenden, ruft Select AI relevanten Inhalt aus dem konfigurierten Vektorindex ab und fügt diesen Inhalt dem erweiterten Prompt hinzu, der an den AI-Provider gesendet wird.

Erstellen und konfigurieren Sie den erforderlichen Vektorindex, bevor Sie ihn mit dem Profil verwenden. Weitere Informationen finden Sie unter AI mit Retrieval Augmented Generation (RAG) auswählen.

Profile über ausgewählte KI-Schnittstellen verwenden

Die Methode Profile.create() erstellt das AI-Profil als Datenbankressource. Das Java-Objekt Profile stellt eine Java-Darstellung dieses Datenbankprofils bereit.

Da sich das Profil nicht im Java-Prozess, sondern in der Datenbank befindet, können andere Select AI-Schnittstellen, die auf dasselbe Datenbankprofil zugreifen können, es entsprechend ihren Datenbankberechtigungen und der unterstützten Profilfunktionalität verwenden. Dazu gehören SQL- und PL/SQL-Schnittstellen sowie andere unterstützte Select AI-SDKs oder APIs.

Inhalt zusammenfassen und übersetzen

Mit der Methode Profile.summarize() können Sie Inline-Inhalte oder -Inhalte an einem externen Speicherort zusammenfassen. Geben Sie für jede Zusammenfassungsanforderung entweder Inline-Inhalt oder einen Speicherort-URI an, nicht jedoch beides.

Verwenden Sie die Methode Profile.translate(), um Text mit einem unterstützten Übersetzungsprovider zu übersetzen, der im Profil konfiguriert ist. Es gelten anbieterspezifische Authentifizierungs-, Sprachsupport- und Serviceanforderungen.

Weitere Informationen finden Sie unter Zusammenfassung mit ausgewählter KI generieren und Übersetzen.

SQL-Feedback geben

Verwenden Sie die Methode Profile.feedback(), um positives oder negatives Feedback für die NL2SQL-Generierung weiterzuleiten.

Positives Feedback bestätigt generiertes SQL für zukünftige Referenzzwecke. Negative Rückmeldungen können Probleme mit generiertem SQL identifizieren und erwartete SQL-Anweisungen oder zusätzliche Anleitungen bereitstellen. Select AI kann relevantes gespeichertes Feedback als Hinweise für ähnliche Prompts bei der nachfolgenden SQL-Generierung verwenden.

Weitere Informationen finden Sie unter Feedback.

Vollständige Informationen zur Profile-Schnittstelle, zur ProfileAttributes-Klasse, zur providerspezifischen Konfiguration, zu Profillebenszyklusmethoden, Generierungsmethoden und Beispielen finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Mit Unterhaltungen verwalten

Ein Conversation-Objekt stellt eine Select AI-Unterhaltung dar, die in der Datenbank gespeichert ist. Verwenden Sie eine Unterhaltung, um den Kontext und die Prompt-Historie über die zugehörigen Select AI-Interaktionen hinweg beizubehalten.

Eine Konversation ist eine Datenbankressource, die durch eine Konversations-ID identifiziert wird. Es ist nicht dauerhaft mit einem AI-Profil verknüpft. Anwendungen können die Unterhaltungs-ID mit Select AI-Vorgängen verwenden, die den Konversationskontext unterstützen, abhängig von der Profilkonfiguration und den Datenbankberechtigungen der Anwendung.

Unterhaltung erstellen

Verwenden Sie SelectAI.conversation(ConversationAttributes), um ein Java Conversation-Objekt zu erstellen, das mit Unterhaltungsattributen initialisiert wurde.

Mit dieser Methode wird die Unterhaltung in der Datenbank nicht erstellt. Rufen Sie Conversation.create() für das zurückgegebene Objekt auf, um die Datenbankunterhaltung zu erstellen. Die Methode create() gibt die generierte Unterhaltungs-ID zurück.

Unterhaltungsattribute

Verwenden Sie ConversationAttributes, um Unterhaltungsmetadaten zu konfigurieren, einschließlich:

  • title
  • Beschreibung
  • Aufbewahrungszeit (Tage)
  • Gesprächslänge

Das Attribut retentionDays gibt an, wie lange Select AI die Unterhaltung beibehält. Das Attribut conversationLength gibt den Unterhaltungskontext an, den die ausgewählte KI für zugehörige Interaktionen behält.

Verwenden Sie Conversation.getConversationAttributes(), um die aktuellen Attribute einer vorhandenen Unterhaltung abzurufen. Verwenden Sie Conversation.setAttributes(), um unterstützte Unterhaltungsattribute zu aktualisieren.

Select AI speichert die Unterhaltungs-Prompt-Historie in der Datenbank. Verwenden Sie Conversation.listPrompts(), um Prompts abzurufen, die für die Konversation aufgezeichnet wurden, sortiert nach Erstellungszeit. Verwenden Sie Conversation.deletePrompt(), um eine einzelne Eingabeaufforderung zu entfernen. Wenn Sie eine einzelne Eingabeaufforderung mit deletePrompt() entfernen, wird die Unterhaltung nicht entfernt. Verwenden Sie Conversation.drop(), um die Unterhaltung aus der Datenbank zu entfernen.

Behalten Sie die Konversationskennung bei, wenn nachfolgende Anwendungsvorgänge auf dieselbe Konversation zugreifen müssen.

Vorhandene Unterhaltung verwenden

Verwenden Sie SelectAI.conversation(String conversationId), um eine vorhandene Unterhaltung nach ihrer Unterhaltungs-ID zu öffnen.

Nachdem Sie eine Unterhaltung geöffnet oder erstellt haben, verwenden Sie die Schnittstelle Conversation, um:

  • Rufen Sie die Unterhaltungs-ID mit getConversationId() ab.
  • Rufen Sie Unterhaltungsattribute mit getConversationAttributes() ab.
  • Aktualisieren Sie die Unterhaltungsattribute mit setAttributes().
  • Listen Sie Prompts auf, die für die Unterhaltung mit listPrompts() gespeichert sind.
  • Löschen Sie einen einzelnen Prompt mit deletePrompt().
  • Entfernen Sie die Unterhaltung mit drop().

Konversationslebenszyklus

Ein Java Conversation-Objekt entfernt die entsprechende Datenbankunterhaltung nicht automatisch, wenn das Java-Objekt außerhalb des Geltungsbereichs liegt oder der SelectAI-Client geschlossen wird.

Lebenszyklus der Datenbankkonversation explizit verwalten. Rufen Sie Conversation.drop() auf, wenn die Anwendung die Unterhaltung nicht mehr benötigt.

Hinweis

Hinweis: Das aktuelle Select AI für das Java-SDK definiert keinen separaten öffentlichen Sessionlebenszyklus, der eine Unterhaltung automatisch löscht, wenn die Session geschlossen wird. Unterhaltungen über die Schnittstelle Conversation und die Unterhaltungs-ID verwalten.

Threadverhalten für Unterhaltungen

Das SDK bietet keine globale Threadsicherheitsgarantie für Conversation-Objekte.

Mehrere Threads können separate Conversation-Instanzen für unabhängige Vorgänge verwenden. Verwenden Sie nicht mehrere Threads gleichzeitig, um Prompts zu aktualisieren, zu löschen oder dieselbe Conversation-Instanz zu löschen, es sei denn, Ihre Anwendung synchronisiert den Zugriff.

Allgemeine Überlegungen zu SDK-Threading-Verhalten und Verbindungsmodus finden Sie unter Threading-Verhalten.

Richtlinien für Unterhaltungen

Konversations-IDs und Konversationsinhalt als Anwendungsdaten behandeln. Eine Unterhaltung kann Prompts und Metadaten enthalten, die aus Datenbankinteraktionen oder sensiblen Geschäftsinformationen abgeleitet werden.

Nehmen Sie keine Konversations-IDs, Prompts oder Unterhaltungsinhalte in Logs, Fehlerberichten oder anderen Ausgaben auf, es sei denn, die Sicherheits- und Logging-Policys Ihrer Anwendung erlauben dies. Schränken Sie den Datenbankzugriff auf Unterhaltungen entsprechend den Zugriffssteuerungsanforderungen der Anwendung ein.

Vollständige Informationen über die Schnittstelle Conversation, die Klasse ConversationAttributes, Methoden des Unterhaltungslebenszyklus, Prompt-Metadaten und Beispiele finden Sie unter Select AI for Java API Reference (Javadoc).

Mit Vektorindizes arbeiten

Vektorindizes unterstützen RAG-Workflows (Retrieval-Augmented Generation). Ein Vektorindex speichert durchsuchbare Darstellungen von Quellinhalten, sodass Select AI relevante Informationen für eine KI-Antwort abrufen kann.

Mit der Schnittstelle VectorIndex können Sie Vektorindizes erstellen, abrufen, aktualisieren, aktivieren, deaktivieren und entfernen. Konfigurieren Sie den Vektorindex mit dem Quellspeicherort, den Zugangsdaten, Einbettungseinstellungen und anderen Attributen, die für den beabsichtigten RAG-Workflow erforderlich sind.

Vektorindizes mit RAG verwenden

Nachdem Sie einen Vektorindex erstellt haben, konfigurieren Sie ein AI-Profil, um den Index für RAG zu verwenden.

Der Vektorindex liefert den abgerufenen Quellinhalt. Das RAG-aktivierte Profil stellt den AI-Provider und die Modellkonfiguration bereit, die zur Verarbeitung der Benutzereingabeaufforderung und des abgerufenen Inhalts verwendet werden.

Sie können denselben Vektorindex mit mehreren Profilen verwenden, wenn diese Profile die erforderliche RAG-Konfiguration unterstützen.

Vektorindex erstellen

Verwenden Sie SelectAI.vectorIndex(VectorIndexConfig), um ein Java VectorIndex-Objekt aus einer Vektorindexkonfiguration zu erstellen. Mit dieser Methode wird das Java-Objekt erstellt. Der Vektorindex wird nicht in der Datenbank erstellt.

Rufen Sie VectorIndex.create() auf, um den Vektorindex in der Datenbank zu erstellen.

Wenn das SDK einen Vektorindex erstellt, führt die Datenbank Folgendes aus:

  1. Liest den Inhalt aus dem konfigurierten Quellspeicherort.
  2. Verwendet das für den Vektorindex konfigurierte Profil und den Provider zum Generieren von Einbettungen.
  3. Speichert die generierten Vektoren für den Abruf während RAG-Vorgängen.

Die Klasse VectorIndexConfig stellt die Erstellungszeitkonfiguration bereit, einschließlich Vektorindexname, Profilname, Status, Beschreibung, Wait-for-Completion-Einstellung und Vektorindex-Attribute.

Einbett- und RAG-Profile

Das in der Vektorindexkonfiguration angegebene Profil stellt den Provider und die Einbettungskonfiguration bereit, die von der Datenbank zum Erstellen von Einbettungen für den Quellinhalt verwendet werden.

Das Profil zum Erstellen von Einbettungen bestimmt nicht automatisch, welches Profil eine Anwendung für RAG-Anforderungen verwendet. Konfigurieren Sie ein Profil für RAG separat, indem Sie den Vektorindex in seiner ProfileAttributes-Konfiguration angeben.

Der RAG-Workflow verwendet KI-Profile in verschiedenen Rollen. In der folgenden Tabelle wird jede Ressource im Workflow der entsprechenden Select AI für Java-Ressource oder -Konfiguration zugeordnet.

Ressource Java-Ressource oder -Konfiguration Zweck
Einbettungsprofil Profile und ProfileAttributes Stellt den Provider und die Einbettungskonfiguration bereit, mit denen Einbettungen für den Quellinhalt erstellt werden. Geben Sie den Profilnamen in VectorIndexConfig an, wenn Sie den Vektorindex konfigurieren.
Vektorindex VectorIndex, VectorIndexConfig und VectorIndexAttributes Konfiguriert und verwaltet den Vektorindex, der generierte Vektoren speichert und Inhalte für den Abruf bereitstellt.
RAG-Profil Profile und ProfileAttributes Verweist auf den Vektorindex in der Profilkonfiguration und stellt die Provider- und Modellkonfiguration zur Verarbeitung von RAG-Anforderungen bereit.

Wenn das RAG-fähige Profil eine Anforderung verarbeitet, ruft Select AI relevanten Inhalt aus dem Vektorindex ab und fügt diesen Inhalt dem erweiterten Prompt hinzu, der an den AI-Provider gesendet wird.

Weitere Informationen finden Sie unter AI mit Retrieval Augmented Generation (RAG) auswählen.

Vektorindexerstellung überwachen

Die Erstellung des Vektorindex kann basierend auf der Einstellung waitForCompletion in VectorIndexConfig synchron oder asynchron ausgeführt werden.

waitForCompletion Verhalten
true VectorIndex.create() wartet, bis die Erstellung des Vektorindex abgeschlossen ist, bevor er zurückgegeben wird.
false VectorIndex.create() gibt zurück, ohne darauf zu warten, dass die Erstellung des Vektorindex abgeschlossen ist.

Verwenden Sie VectorIndex.getStatus(), um den aktuellen Status eines datenbankgestützten Vektorindex abzurufen. Verwenden Sie VectorIndex.getVectorIndexAttributes(), um die aktuellen Attribute abzurufen.

Wenn die Erstellung des Vektorindex nicht erfolgreich verläuft, meldet VectorIndex.create() den Datenbank- oder JDBC-Fehler über SelectAIException.

Das SDK stellt keine separate Fortschrittsschnittstelle oder kein asynchrones Jobobjekt für die Vektorindexerstellung bereit.

Vektorindizes aktualisieren

Ein Vektorindex kann eine konfigurierte Aktualisierungsrate verwenden, um zu steuern, wie der Index Quellinhalt ändert.

Wenn sich die Quelldokumente ändern, aktualisiert die Datenbank den Vektorindex entsprechend dem konfigurierten Aktualisierungsverhalten. Konfigurieren Sie die Aktualisierungsrate in VectorIndexAttributes.

Die Anwendung muss den Vektorindex nicht nur neu erstellen, weil sich der Quellinhalt ändert, wenn das konfigurierte Aktualisierungsverhalten die erforderlichen Aktualisierungen unterstützt.

Der erforderliche Quellspeicherort und die erforderlichen Zugangsdaten müssen verfügbar bleiben, während der Vektorindex seinen Inhalt verarbeitet oder aktualisiert.

Informationen zu unterstützten Aktualisierungsattributen und zur Konfiguration finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Vektorindex aktualisieren

Verwenden Sie die Methoden VectorIndex.update(VectorIndexAttributes) oder update() mit einem einzelnen Attribut, um unterstützte Vektorindexattribute zu aktualisieren.

Einige Attribute gelten nur, wenn Sie den Vektorindex erstellen und können später nicht mehr geändert werden. Die Datenbank bestimmt, ob ein Attribut aktualisiert werden kann.

Erstellen Sie die Aktualisierungsanforderung nur mit den Attributen, die von der Datenbank zur Änderung unterstützt werden. Beispiel: chunk_size ist ein Erstellungszeitattribut und kann nicht aktualisiert werden, nachdem der Vektorindex erstellt wurde.

Verwenden Sie VectorIndex.getVectorIndexAttributes(), um die aktuellen Attribute eines vorhandenen Vektorindex abzurufen, bevor Sie Änderungen vornehmen.

Vektorindex aktivieren oder deaktivieren

Mit den folgenden Methoden können Sie steuern, ob Select AI einen Vektorindex für den RAG-Abruf verwenden kann.

Methode Effekt
VectorIndex.enable() Aktiviert den Vektorindex für den RAG-Abruf.
VectorIndex.disable() Deaktiviert den Vektorindex. Select AI verwendet den Vektorindex erst dann zum Abrufen, wenn Sie ihn erneut aktivieren.

Wenn Sie einen Vektorindex aktivieren oder deaktivieren, werden die Vektordaten nicht entfernt.

Vektorindex ablegen

Verwenden Sie VectorIndex.drop(boolean force), um den Vektorindex zu entfernen.

In diesem Formular werden sowohl die Vektorindexmetadaten als auch die zugrunde liegenden Vektordaten entfernt.

Verwenden Sie VectorIndex.drop(boolean includeData, boolean force), wenn Sie steuern müssen, ob die Backingvektordaten entfernt werden.

includeData Verhalten
true Entfernt die zugrunde liegenden Vektordaten zusammen mit den Vektorindexmetadaten.
false Behält die zugrunde liegenden Vektordaten bei, wenn der zugrunde liegende Datenbankvorgang diese Option unterstützt.

Achtung: Bevor Sie einen Vektorindex löschen, identifizieren Sie alle RAG-fähigen Profile oder Anwendungen, die ihn verwenden. Prüfen Sie, ob die zugrunde liegenden Vektordaten beibehalten werden müssen, bevor Sie die Drop-Option auswählen.

Vollständige ausführbare Beispielquellen finden Sie unter vectorindex.

Informationen zur Datenbankkonfiguration und zu RAG-Konzepten finden Sie unter Voraussetzungen für Select AI ausführen und AI mit Retrieval Augmented Generation (RAG) auswählen.

Informationen zu unterstützten Attributen, Erstellungsoptionen, Statuswerten, Aktualisierungsmethoden und Löschmethoden finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Synthetische Daten generieren

Select AI for Java kann synthetische Daten für ein einzelnes Datenbankobjekt oder für mehrere zugehörige Datenbankobjekte generieren. Verwenden Sie synthetische Daten für Tests, Entwicklung, Prototyping und Analyse. Die synthetische Datengenerierung verwendet den im zugehörigen Profile-Objekt konfigurierten AI-Provider.

Mit Profile.generateSyntheticData(SyntheticDataSingleRequest) können Sie synthetische Daten für ein Datenbankobjekt generieren. Mit Profile.generateSyntheticData(SyntheticDataBatchRequest) können Sie synthetische Daten für mehrere Objekte generieren.

Eine Anforderung kann Folgendes angeben:

  • Datenbankobjektname.
  • Objekteigentümer.
  • Anzahl Zeilen, die generiert werden sollen.
  • Benutzerführung.
  • Unterstützte Generierungsparameter.

Die generierten Daten gelten als Ziele für die in der Anforderung angegebenen Datenbankobjekte. Die Java-Methoden geben ein boolesches Ergebnis zurück, das angibt, ob der Datenbankvorgang erfolgreich war. Sie geben die generierten Zeilen nicht an den Aufrufer zurück.

Synthetische Daten generieren - Voraussetzungen

Bevor Sie synthetische Daten generieren:

  • Stellen Sie sicher, dass die Zieldatenbankobjekte vorhanden sind.
  • Erteilen Sie dem Datenbankbenutzer die Berechtigungen, die für den Zugriff auf die Zielobjekte erforderlich sind, und ändern Sie sie.
  • Konfigurieren Sie ein AI-Profil für einen Provider, der die Generierung synthetischer Daten unterstützt.
  • Aktivieren Sie den Zugriff auf ausgewählte KI-Daten.
  • Füllen Sie die anbieterspezifischen Konfigurations- und Authentifizierungsanforderungen aus.

Die erforderlichen Select AI-Berechtigungen und das Datenbanksetup finden Sie unter Voraussetzungen für Select AI ausführen.

Daten für zugehörige Objekte generieren

Verwenden Sie SyntheticDataBatchRequest, wenn Sie Daten für mehrere zugehörige Datenbankobjekte generieren müssen.

Die Batchanforderung kann mehrere Objekte und deren Generierungseinstellungen enthalten. Verwenden Sie dieses Formular, wenn die generierten Daten die Beziehungen zwischen den angegebenen Objekten widerspiegeln müssen.

Die Anforderung unterstützt eine angegebene Anzahl von Zeilen für die Generierung synthetischer Daten. Der effektive Grenzwert kann von der zugrunde liegenden Datenbankfunktionalität, dem Provider und den Datenbankressourcen abhängen.

Wenn ein Vorgang zur Einzelobjekt- oder Batchgenerierung nicht erfolgreich verläuft, meldet das SDK den Datenbank- oder JDBC-Fehler über SelectAIException.

Achtung:

Synthetische Datengenerierung verwendet ein großes Sprachmodell, um die angeforderten Daten zu erzeugen. Prüfen Sie die generierten Daten, bevor Sie sie in nachgelagerten Systemen verwenden, insbesondere wenn die Zielobjekte Folgendes aufweisen:

  • Constraints für Primärschlüssel.
  • Fremdschlüssel-Constraints.
  • Eindeutige Constraints
  • Prüfen Sie Constraints.
  • Anwendungsspezifische Validierungsregeln

Verwenden Sie keine synthetische Datengenerierung, um echte personenbezogene Daten oder sensible Produktionsdaten zu reproduzieren.

Transaktionsverhalten für die Generierung synthetischer Daten

Die Generierung synthetischer Daten folgt dem Transaktionsverhalten der JDBC-Verbindung, die das Objekt Profile verwendet.

Das SDK schreibt die Transaktion nicht explizit fest oder setzt sie zurück. Im DbConnectionConfig-Modus verwendet der Vorgang die SDK-eigene JDBC-Verbindung. Im Modus DataSource verwendet der Vorgang eine Verbindung, die aus dem von der Anwendung verwalteten DataSource ausgeliehen wurde.

Weitere Informationen zum Transaktionsverhalten finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

Informationen zu unterstützten Parametern und Ausnahmen finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Vorhandene Objekte abrufen und aktualisieren

Select AI for Java stellt Profile, Unterhaltungen, Zugangsdaten und Vektorindizes als datenbankgestützte Java-Objekte dar.

Verwenden Sie die unterstützten Abrufmethoden, um aktuelle Informationen zu vorhandenen Objekten abzurufen. Je nach Objekt können zurückgegebene Informationen den Namen, die ID, die Beschreibung, den Status, die Attribute und die Metadaten enthalten.

Aktualisieren Sie nur Attribute, die von den zugrunde liegenden Select AI-Datenbank-APIs unterstützt werden. Eine Aktualisierung ersetzt nicht unbedingt das vollständige Objekt. Rufen Sie das Objekt ab, wenn die Anwendung den aktuellen Datenbankstatus benötigt, und bestätigen Sie, dass das Objekt vorhanden ist, bevor Sie einen objektspezifischen Vorgang ausführen.

Der Collection-Abruf gibt Objekte zurück, auf die der angemeldete Datenbankbenutzer zugreifen kann.

Informationen zu unterstützten Abrufmethoden, Aktualisierungsvorgängen, Anforderungsobjekten und Rückgabewerten finden Sie unter Select AI for Java API Reference (Javadoc).

Objekte löschen

Entfernen Sie Profile, Zugangsdaten, Unterhaltungen und Vektorindizes, die für die Anwendung nicht mehr erforderlich sind.

Bevor Sie ein Objekt löschen:

  • Vergewissern Sie sich, dass das Objekt nicht mehr benötigt wird.
  • Prüfen Sie abhängige Profile, Zugangsdaten, Unterhaltungen und Vektorindizes.
  • Vergewissern Sie sich, dass der angemeldete Datenbankbenutzer das Objekt entfernen kann.
  • Bewahren Sie alle erforderlichen Metadaten oder Konfigurationen außerhalb der Datenbank auf.

Einige Ressourcenmethoden bieten eine Option zum Erzwingen des Entfernens, die ein bereits fehlendes Objekt als erfolgreiches Ergebnis behandelt. Verwenden Sie diese Option nur, wenn die Anwendung ein abwesendes Objekt sicher als endgültigen Status akzeptieren kann.

Informationen zu objektspezifischen Entfernungsmethoden, Abhängigkeitsverhalten und Ausnahmen finden Sie unter AI für Java API Reference (Javadoc) auswählen.

Synchrone APIs verwenden

Select AI for Java stellt nur synchrone Java-APIs bereit. Das SDK bietet keine asynchronen APIs oder Streamingprofilvorgänge. Verwenden Sie die synchronen APIs, wenn die Anwendung warten kann, bis jeder Datenbankvorgang abgeschlossen ist, bevor Sie fortfahren.

Eine synchrone Methode wartet, bis der Datenbankvorgang abgeschlossen ist, oder gibt einen Fehler zurück, bevor das Steuerelement zur aufrufenden Anwendung zurückkehrt. Vorgänge, die mit einem AI-Provider kommunizieren oder eine Datenbankverarbeitung mit langer Ausführungszeit ausführen, können den aufrufenden Thread daher über einen längeren Zeitraum blockieren.

Verwenden Sie für Multi-Threaded-Anwendungen den Modus DataSource, und skalieren Sie den Verbindungspool für die erwartete Nebenläufigkeit und Workload. Informationen zu JDBC-Abfrage-Timeouts finden Sie unter Transaktionsverhalten.

Hinweis

Hinweis: Ein JDBC-Abfrage-Timeout konfiguriert keine Timeoutwerte für AI-Provideranforderungen oder garantiert die Stornierung einer Provideranforderung, die bereits in Bearbeitung ist.

Die in diesem Release verfügbaren synchronen Methoden finden Sie unter AI for Java API Reference (Javadoc) auswählen.

Fehler behandeln

Wählen Sie AI für Java-Berichte aus, um lokal erkannte Validierungsfehler über Java-Standardausnahmen zu ermitteln, und melden Sie Datenbank-, JDBC-, DBMS_CLOUD-, DBMS_CLOUD_AI- und Providerfehler über SelectAIException.

Das SDK validiert Anforderungsinformationen, die es vor der JDBC-Verarbeitung prüfen kann. Der Datenbank- und JDBC-Treiber validiert Datenbankberechtigungen, Ressourcenstatus, Packageanforderungen, Providerkonfiguration, Netzwerkzugriff und andere datenbankseitige Anforderungen.

SDK-Ausnahmen verarbeiten

Das SDK verwendet die folgenden Ausnahmen für allgemeine Fehlerbedingungen:

Ausnahme Wenn es passiert
IllegalArgumentException Die Anwendung stellt ein ungültiges Argument oder einen ungültigen Konfigurationswert bereit. Beispiele: Null- oder leere erforderliche Werte, ungültige Portbereiche, negative Timeoutwerte und ungültige Zugangsdatenkombinationen.
IllegalStateException Die Anwendung verwendet eine SDK-Ressource mit einem ungültigen Lebenszyklusstatus. Beispiel: Für einen Vorgang ist eine Ressource erforderlich, die bereits erstellt oder geöffnet wurde.
SelectAIException JDBC, DBMS_CLOUD, DBMS_CLOUD_AI oder der konfigurierte AI-Provider meldet einen Fehler über das SDK.

SelectAIException erbt von Exception, was es zu einer geprüften Ausnahme macht, die Aufrufer explizit verarbeiten oder deklarieren müssen. Öffentliche datenbankgestützte Methoden deklarieren SelectAIException, einschließlich Profilgenerierungs- und Lebenszyklusmethoden, Unterhaltungsvorgängen, Vektorindexvorgängen, Zugangsdatenvorgängen, DatabaseAdmin-Vorgängen und SDK-eigener Verbindungserstellung und -bereinigung.

Die Ausnahmedeklaration für eine einzelne Methode finden Sie unter AI für Java-API-Referenz (Javadoc) auswählen.

Clientseitige und datenbankseitige Validierung

Das SDK validiert unterstützte Eingaben vor der JDBC-Verarbeitung, wenn es die Gültigkeit aus der Java-Anforderung bestimmen kann.

Das SDK erkennt Bedingungen wie:

  • Keine oder leere Ressourcennamen.
  • Null oder leere Prompts und Aktionen, sofern erforderlich.
  • Ungültige Benutzer, Hosts oder Berechtigungen.
  • Ungültige Portbereiche.
  • Negative Werte für Abfrage-Timeout.
  • Ungültige Zugangsdatenkombinationen.
  • Vorgänge für Ressourcen, die noch nicht erstellt oder geöffnet wurden.

Diese Bedingungen führen normalerweise zu IllegalArgumentException oder IllegalStateException vor der JDBC-Verarbeitung.

Die Datenbank validiert Bedingungen, die von Datenbankkonfiguration, Ressourcen oder Remoteservices abhängen. Diese Bedingungen umfassen:

  • Datenbankberechtigungen.
  • Vorhandensein und Zustand der Ressource.
  • Anforderungen für DBMS_CLOUD und DBMS_CLOUD_AI.
  • Providerkonfiguration.
  • Gültigkeit der Zugangsdaten.
  • Netzwerk-ACL-Konfiguration.
  • Objektlistenregeln.
  • Vektorindex-Einschränkungen.
  • Remote-KI-Providerantworten.

Das SDK meldet diese datenbankseitigen Fehler über SelectAIException.

SelectAIException verarbeiten

Fangen Sie SelectAIException ab, um Fehler aus datenbankgesicherten Select AI-Vorgängen zu verarbeiten.

Zum Beispiel:

try (SelectAI selectAI = SelectAI.create(dataSource)) {
    Profile profile = selectAI.profile("MY_PROFILE");
    String response = profile.chat("Show the top five products");
} catch (SelectAIException exception) {
    System.err.println(exception.getMessage());
    System.err.println(exception.getErrorCode());
    System.err.println(exception.getSqlState());
}

Zeichnen Sie genügend Diagnoseinformationen auf, um den Fehler zu beheben, zeichnen Sie jedoch keine Passwörter, Private Keys, Token oder vollständigen Zugangsdatenkonfigurationen auf.

Die Ausnahmehierarchie, Fehlerdetails und das betriebsspezifische Verhalten finden Sie unter AI für Java-API-Referenz (Javadoc) auswählen.

Fehlerdetails prüfen

Verwenden Sie die folgenden SelectAIException-Methoden, um verfügbare Fehlerinformationen zu prüfen:

Methode Beschreibung
getErrorCode() Gibt den JDBC- oder Oracle-Fehlercode zurück, sofern verfügbar.
getSqlState() Gibt den SQLState zurück, wenn verfügbar.
getCause() Gibt die zugrunde liegende Ausnahme zurück, einschließlich der zugrunde liegenden JDBC-Ausnahme, sofern verfügbar.

Providerfehler verwenden keinen separaten Java-Providerausnahmetyp. DBMS_CLOUD oder DBMS_CLOUD_AI empfängt normalerweise einen Providerfehler, meldet ihn über die Datenbank- und JDBC-Layer, und das SDK wrappt den Fehler in SelectAIException.

Beispiel: Ein von einem AI-Provider zurückgegebener HTTP-Fehler kann als Oracle-Fehler wie ORA-20400 angezeigt werden. Prüfen Sie die SelectAIException-Fehlerdetails und die zugrunde liegende Ursache für die Diagnoseinformationen, die für den Vorgang verfügbar sind.

Die vollständigen SelectAIException-Methoden und Rückgabewerte finden Sie unter Select AI for Java API Reference (Javadoc).

Nicht erfolgreiche Vorgänge wiederholen

Die Option "AI für Java auswählen" wiederholt nicht erfolgreiche Vorgänge nicht automatisch.

Sie können einen schreibgeschützten Metadatenvorgang wiederholen, nachdem Sie bestätigt haben, dass ein Verbindungsfehler vorübergehend war.

Erstellen, aktualisieren, löschen, administrieren, generieren oder Chatvorgänge nicht automatisch wiederholen. Möglicherweise hat der Datenbank- oder AI-Provider die Verarbeitung der Anforderung gestartet, bevor die Anwendung den Fehler erhalten hat.

Bevor Sie einen Vorgang wiederholen, der den Datenbankstatus ändern oder eine Anforderung an einen AI-Provider senden kann, prüfen Sie den aktuellen Vorgang oder Ressourcenstatus, und bestätigen Sie, dass die Wiederholung der Anforderung sicher ist.

Zeitüberschreitung und serverseitige Arbeit

Die Einstellung queryTimeoutSeconds konfiguriert den JDBC-Anweisungstimeout. Es muss nicht unbedingt Folgendes konfigurieren:

  • Timeout bei einem AI-Providerendpunkt.
  • HTTP-Verbindung oder Lese-Timeout.
  • Stornierung einer Remote-Modellanforderung.
  • Stornierung eines DBMS_CLOUD_AI-Vorgangs mit langer Ausführungszeit.

Ein JDBC-Timeout kann verhindern, dass die Anwendung auf die JDBC-Anweisung wartet, während die datenbankseitige oder providerseitige Verarbeitung fortgesetzt wird.

Achtung: Gehen Sie nicht davon aus, dass ein Timeout-Vorgang die Verarbeitung gestoppt hat. Bevor Sie den Vorgang wiederholen, prüfen Sie den Status der betroffenen Datenbankressource oder des betroffenen Datenbankvorgangs, und prüfen Sie, ob der AI-Provider die ursprüngliche Anforderung möglicherweise noch verarbeitet.

Weitere Informationen finden Sie unter Transaktionsverhalten.

Fehlerbehebung

Wenn ein Vorgang fehlschlägt:

  1. Prüfen Sie die Meldung SelectAIException, den Oracle-Fehlercode, SQLState und die zugrunde liegende Ursache, wenn verfügbar.
  2. Vergewissern Sie sich, dass der Datenbankbenutzer über die erforderlichen Berechtigungen verfügt.
  3. Vergewissern Sie sich, dass das referenzierte Profil, die Zugangsdaten, die Unterhaltung oder der Vektorindex vorhanden sind und den erforderlichen Status aufweisen.
  4. Prüfen Sie bei Bedarf die Providerkonfiguration und die Zugangsdaten.
  5. Prüfen Sie den Netzwerkzugriff und die ACL-Konfiguration, wenn der Provider oder die Datenquelle dies erfordert.
  6. Bei Providerfehlern prüfen Sie den Oracle-Fehler und die zugrunde liegenden Diagnoseinformationen, die über DBMS_CLOUD oder DBMS_CLOUD_AI zurückgegeben werden.
  7. Bei einem Timeout oder Verbindungsfehler prüfen Sie den Vorgang oder den Ressourcenstatus, bevor Sie die Anforderung wiederholen.

Vollständige Informationen zu SelectAIException, methodenspezifischen Ausnahmen, Validierungsverhalten und Fehlerbehandlung finden Sie unter AI für Java-API-Referenz (Javadoc) auswählen.

AI für Java-Beispiele auswählen

Sehen Sie sich die Beispiele für Select AI for Java für Beispiel-Java-Code an, in denen gezeigt wird, wie Select AI for Java-Features konfiguriert und verwendet werden. Verwenden Sie diese Beispiele mit der Select AI for Java API Reference (Javadoc), um die Klassen, Methoden und Konfigurationen zu verstehen, die in jedem Workflow verwendet werden.