DBMS_CLOUD_AI-Package
Das Package DBMS_CLOUD_AI mit Select AI erleichtert und konfiguriert die Übersetzung von Eingabeaufforderungen in natürlicher Sprache, um SQL-Anweisungen zu generieren, auszuführen und zu erläutern. Ermöglicht außerdem Retrieval Augmented Generation und Interaktionen in natürlicher Sprache, einschließlich des Chats mit LLMs.
Voraussetzungen
- Sie können ein NAT-Gateway im virtuellen Cloud-Netzwerk (VCN) erstellen, in das sich Ihre autonomen KI-Datenbankressourcen befinden, indem Sie die Anweisungen in der Dokumentation zu Oracle Cloud Infrastructure unter NAT-Gateway erstellen befolgen.
- Fügen Sie nach dem Erstellen des NAT-Gateways eine Routingregel und eine Egress-Sicherheitsregel zu jedem Subnetz (im VCN) hinzu, in dem sich autonome KI-Datenbankressourcen befinden. Damit können diese Ressourcen über das Gateway einen öffentlichen Schlüssel von Ihrer Azure AD-Instanz abrufen:
- Gehen Sie zur Seite Subnetzdetails für das Subnetz.
- Klicken Sie auf der Registerkarte Informationen zum Subnetz auf den Namen der Routentabelle des Subnetzes, um die Seite Routentabellendetails anzuzeigen.
- Prüfen Sie in der Tabelle der vorhandenen Routingregeln, ob bereits eine Regel mit den folgenden Eigenschaften vorhanden ist:
- Zielort: 0.0.0.0/0
- Zieltyp: NAT-Gateway
- Ziel: Der Name des NAT-Gateway, das Sie gerade im VCN erstellt haben
Wenn keine solche Regel vorhanden ist, klicken Sie auf Routenregeln hinzufügen, und fügen Sie eine Routingregel mit diesen Eigenschaften hinzu.
- Zurück zur Seite Subnetzdetails für das Subnetz.
- Klicken Sie in der Tabelle Sicherheitslisten des Subnetzes auf den Namen der Sicherheitsliste des Subnetzes, um die Seite Sicherheitslistendetails anzuzeigen.
- Klicken Sie im Seitenmenü unter Ressourcen auf Egress-Regeln.
- Prüfen Sie in der Tabelle der vorhandenen Ausgangsregeln, ob bereits eine Regel mit den folgenden Eigenschaften vorhanden ist:
- Zieltyp: CIDR
- Zielort: 0.0.0.0/0
- IP-Protokoll: TCP
- Quellportbereich: 443
- Ziel-Portbereich: Alle
Wenn keine derartige Regel vorhanden ist, klicken Sie auf Egress-Regeln hinzufügen, und fügen Sie eine Egress-Regel mit diesen Eigenschaften hinzu.
Die HTTP-Proxyeinstellungen in Ihrer Umgebung müssen es der Datenbank ermöglichen, auf den Cloud-Serviceprovider zuzugreifen.
Hinweis:
Die Netzwerkkonfiguration einschließlich des HTTP-Proxys kann nur bearbeitet werden, bis sich die Exadata-Infrastruktur im Status Aktivierung erforderlich befindet. Sobald sie aktiviert ist, können Sie diese Einstellungen nicht mehr bearbeiten.Für die Einrichtung eines HTTP-Proxys für eine bereits bereitgestellte Exadata-Infrastruktur ist eine Serviceanfrage (SR) in My Oracle Support erforderlich. Weitere Informationen finden Sie unter Serviceanfrage in My Oracle Support erstellen.
Verwandte Themen
Zusammenfassung der DBMS_CLOUD_AI-Unterprogramme
In diesem Abschnitt werden die DBMS_CLOUD_AI-Unterprogramme behandelt, die mit Autonomous AI Database bereitgestellt werden.
| Unterprogramm | Beschreibung |
|---|---|
|
Diese Prozedur erstellt ein neues AI-Profil zum Übersetzen von Eingabeaufforderungen in natürlicher Sprache in SQL-Anweisungen. |
|
|
Stellt AI-Profilattribute bereit, die Sie konfigurieren können. |
|
|
Diese Prozedur löscht ein vorhandenes AI-Profil. |
|
|
Mit diesem Verfahren kann ein AI-Profil in der aktuellen Datenbank verwendet werden. |
|
|
Mit diesem Verfahren wird ein AI-Profil in der aktuellen Datenbank deaktiviert. |
|
|
Diese Prozedur legt AI-Profilattribute fest. |
|
|
Diese Prozedur legt das AI-Profil für die aktuelle Datenbank fest. |
|
| Diese Funktion generiert eine SQL-Anweisung, die AI zum Übersetzen verwendet. | |
|
Diese Funktion erzeugt synthetische Daten. |
|
| Prozedur ENABLE_DATA_ACCESS |
Verwenden Sie dieses Verfahren, um das Senden von Daten an Ihr LLM zu ermöglichen. |
| Prozedur DISABLE_DATA_ACCESS |
Verwenden Sie dieses Verfahren, um das Senden von Daten an Ihr LLM zu deaktivieren. |
|
Bei dieser Prozedur wird ein Vektorindex in der angegebenen Vektordatenbank erstellt und mit Daten aus einem Objektspeicher mit einem asynchronen Scheduler-Job aufgefüllt. |
|
|
Mit diesem Verfahren wird ein Vektorspeicherindex entfernt. Es entfernt normalerweise das Vektorspeicher-Indexobjekt und löscht die Vektordatenbank. |
|
|
Mit dieser Prozedur wird ein Vektorindexobjekt in der aktuellen Datenbank deaktiviert. Wenn diese Option deaktiviert ist, kann ein AI-Profil den Vektorindex nicht verwenden, und das System lädt keine Daten in den Vektorspeicher. |
|
|
Mit dieser Prozedur wird ein zuvor deaktiviertes Vektorindexobjekt aktiviert oder aktiviert. |
|
|
Diese Prozedur aktualisiert einen vorhandenen Vektorspeicherindex mit einem angegebenen Wert des Vektorindexattributs. |
|
|
Stellt Vektorindexprofilattribute bereit, die Sie konfigurieren können. |
|
| Prozedur CREATE_CONVERSATION |
Mit diesem Verfahren können Sie eine Konversation erstellen. |
| Funktion CREATE_CONVERSATION |
Mit dieser Funktion können Sie eine Konversation erstellen und die Konversationskennung in anderen Verfahren verwenden. |
| CREATE_CONVERSATION-Attribute |
Verwenden Sie die Unterhaltungsattribute, um Ihre Unterhaltungen anzupassen. |
| Prozedur UPDATE_CONVERSATION |
Diese Prozedur aktualisiert eine vorhandene Prozedur mit benutzerdefinierten Parametern. |
| Prozedur SET_CONVERSATION_ID |
Diese Prozedur legt die Konversationsunterstützung in der aktuellen Sitzung fest. |
| Funktion GET_CONVERSATION_ID |
Mit dieser Prozedur können Sie den Parameter |
| Prozedur CLEAR_CONVERSATION_ID |
Mit dieser Prozedur können Sie alle in der aktuellen Session festgelegten |
| Prozedur DELETE_CONVERSATION_PROMPT |
Diese Prozedur löscht eine bestimmte Eingabeaufforderung. |
| Prozedur DROP_CONVERSATION |
Bei diesem Verfahren werden eine gesamte Unterhaltung und ihre Metadaten gelöscht. |
| FEEDBACK-Verfahren |
Unter diesem Thema wird beschrieben, wie Sie die Genauigkeit der Abfragegenerierung verbessern können, indem Sie ein Feedback an Select AI geben. |
| Vektor-Index für FEEDBACK |
Dies ist ein Standardvektorindex, der erstellt wird, wenn Sie |
Prozedur CREATE_PROFILE
Die Prozedur erstellt ein neues AI-Profil zum Übersetzen von Eingabeaufforderungen in natürlicher Sprache in SQL-Anweisungen.
Syntax
DBMS_CLOUD_AI.CREATE_PROFILE
profile_name IN VARCHAR2,
attributes IN CLOB DEFAULT NULL,
status IN VARCHAR2 DEFAULT NULL,
description IN CLOB DEFAULT NULL
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Ein Name für das AI-Profil. Der Profilname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Profilname darf maximal 125 Zeichen lang sein. Dies ist ein obligatorischer Parameter. |
|
|
Profilattribute im JSON-Format. Weitere Informationen finden Sie unter Profilattribute von AI. Der Standardwert ist NULL. |
status |
Status des Profils. Der Standardwert ist Aktivieren. |
|
|
Beschreibung für das AI-Profil. Der Standardwert ist NULL. |
Beispiel
BEGIN
DBMS_CLOUD_AI.CREATE_PROFILE(
profile_name => 'OpenAI,
attributes => JSON_OBJECT('provider' value 'openai',
'credential_name' value 'openai_cred'),
description => 'AI profile to use OpenAI for SQL translation'
);
END;
/Profilattribute
Attribute
| Attributname | Beschreibung |
|---|---|
|
|
Name des bereitgestellten Azure-Servicemodells OpenAI. Der Name darf nur alphanumerische Zeichen, Unterstriche (_) und Bindestriche (-) enthalten. Der Name darf nicht mit einem Unterstrich (_) oder einem Bindestrich (-) enden. Informationen zum Abrufen der |
|
|
Name der Azure-Dienstressource OpenAI. Der Ressourcenname darf nur alphanumerische Zeichen und Bindestriche enthalten und darf nicht mit einem Bindestrich beginnen oder enden. Informationen zum Abrufen der |
|
|
Nehmen Sie Spaltenkommentare in die Metadaten auf, die zum Übersetzen von Eingabeaufforderungen in natürlicher Sprache mit AI verwendet werden. Hinweis: Boolesche Werte sind bei der Festlegung eines einzelnen Attributs in der ProzedurDBMS_CLOUD_AI.SET_ATTRIBUTE nicht anwendbar, da der Parameter attribute_value den Datentyp CLOB aufweist.
|
|
|
Ein |
|
|
Der Name der Zugangsdaten für den Zugriff auf die AI-Provider-APIs. Zugangsdaten mit Bearer-Token können erstellt werden, indem der Providername als Benutzername und das Bearer-Token als Kennwort verwendet werden. Dies ist ein obligatorisches Attribut. Siehe Prozedur CREATE_CREDENTIAL. |
|
|
Das im AI-Profil definierte Einbettungsmodell. Im Folgenden werden die unterstützten KI-Provider für die Einbettungsmodelle mit ihren Standardwerten aufgeführt:
Hinweis: Der Parameterembedding_model ist für Anthropic und Hugging Face nicht anwendbar.
|
|
|
Gibt die Anzahl der Token an, die pro Generation vorhergesagt werden sollen. Der Standardwert ist 1024. Weitere Informationen finden Sie unter Token und Tokenizer. |
|
|
Der Name des KI-Modells, mit dem Antworten generiert werden. Unterstützte Modelle für:
Hinweis: Dieser Parameter wird nicht für Azure verwendet, da das Modell beim Erstellen des Deployments im Azure OpenAI Service-Portal bestimmt wird. |
|
|
Array von JSON-Objekten, das den Eigentümer und die Objektnamen angibt, die für die Übersetzung natürlicher Sprache in SQL zulässig sind. Um alle Objekte eines bestimmten Benutzers einzuschließen, lassen Sie den "Namen" weg, und geben Sie nur den "Eigentümer"-Schlüssel im JSON-Objekt an. Um die natürliche Sprache in SQL zu übersetzen, werden der Objektname, der Objekteigentümer, die Objektspalten und Kommentare mit HTTPS-Anforderungen an den AI-Provider gesendet. Vermeiden Sie die Angabe von Objekten mit sensiblen Objektnamen, Spaltennamen oder Kommentaren in der Objektliste. AI-Provider können die Größe der in Übersetzungsanforderungen zulässigen Metadaten begrenzen. Begrenzen Sie die Liste der Objekte, die für die Eingabeaufforderungen in natürlicher Sprache durch die Anwendungsbenutzer geeignet sind. Format:
|
|
|
Gibt die OCID des Compartments an, auf das Sie beim Aufrufen des OCI Generative AI-Service zugreifen dürfen. Die Compartment-ID kann alphanumerische Zeichen, Bindestriche und Punkte enthalten. Der Standardwert ist die Compartment-ID der autonomen KI-Datenbank. |
|
|
Diese Attribute geben die Endpunkt-OCID des dedizierten Oracle AI-Hostingclusters an. Die Endpunkt-ID kann alphanumerische Zeichen, Bindestriche und Punkte enthalten. Informationen zum Suchen der Endpunkt-OCID finden Sie unter Details eines Endpunkts in generativer KI abrufen. Wenn Sie das dedizierte KI-Cluster von Oracle verwenden möchten, müssen Sie die Endpunkt-OCID des Hostingclusters angeben. Standardmäßig ist die Endpunkt-ID leer, und das Modell ist auf einer gemeinsam verwendeten Infrastruktur On-Demand. |
|
|
Dieses Attribut gibt den Laufzeittyp des angegebenen Modells an. Dieses Attribut ist erforderlich, wenn das Attribut Alle zulässigen Werte finden Sie in OCI Generative AI runtimeType. Siehe Referenz zu LlmInferenceRequest. Folgende Werte werden unterstützt:
|
|
|
KI-Provider für das KI-Profil. Unterstützte Provider:
Dies ist ein obligatorisches Attribut. |
|
|
Dieses Attribut gibt den Speicherort des generativen KI-Clusters an, das Sie verwenden möchten. Der Bereich kann alphanumerische Zeichen und Bindestriche enthalten.
Hinweis: Das Oracle Generative AI-Cluster ist in den Regionen Chicago, Frankfurt und London verfügbar. Siehe Vortrainierte Grundlagenmodelle in generativer KI.us-chicago-1.
Die Standardregion für AWS ist us-east-1. |
|
|
Der generierte Text wird am Anfang der frühesten Stoppsequenz beendet. Die Reihenfolge wird in den Text übernommen. Der Attributwert muss ein gültiges Array von Zeichenfolgenwerten im JSON-Format sein. |
|
|
Sampling aus Generate Text-Modellen enthält Zufälligkeit, so dass derselbe Prompt jedes Mal, wenn Sie auf "generieren" klicken, unterschiedliche Ausgaben erzielen kann. Temperatur ist eine nicht negative Gleitkommazahl, die verwendet wird, um den Grad der Zufälligkeit zu optimieren. Niedrigere Temperaturen bedeuten weniger zufällige Generationen. Weitere Informationen finden Sie unter Temperatur. Dieser Parameter gilt für alle unterstützten Service Provider. |
BEGIN
DBMS_CLOUD_AI.CREATE_PROFILE(
profile_name => 'COHERE',
attributes =>
'{"provider": "cohere",
"credential_name": "COHERE_CRED",
"object_list": [{"owner": "ADB_USER"}],
"max_tokens":512,
"stop_tokens": [";"],
"model": "command-nightly",
"temperature": 0.5,
"comments": true
}');
END;
/Das folgende Beispiel zeigt benutzerdefinierte Profilattribute mit OCI Generative AI:
BEGIN
DBMS_CLOUD_AI.CREATE_PROFILE(
profile_name => 'GENAI',
attributes => '{"provider": "oci",
"credential_name": "GENAI_CRED",
"object_list": [{"owner": "SH", "name": "customers"},
{"owner": "SH", "name": "countries"},
{"owner": "SH", "name": "supplementary_demographics"},
{"owner": "SH", "name": "profits"},
{"owner": "SH", "name": "promotions"},
{"owner": "SH", "name": "products"}],
"oci_compartment_id": "ocid1.compartment.oc1...",
"oci_endpoint_id": "ocid1.generativeaiendpoint.oc1.us-chicago-1....",
"region": "us-chicago-1",
"model": "cohere.command-light",
"oci_runtimetype": "COHERE"
}');
END;
/ Prozedur DROP_PROFILE
Die Prozedur löscht ein vorhandenes AI-Profil. Wenn das Profil nicht vorhanden ist, löst die Prozedur einen Fehler aus.
Syntax
DBMS_CLOUD_AI.DROP_PROFILE(
profile_name IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des AI-Profils |
|
|
Wenn Der Standardwert für diesen Parameter lautet |
Beispiel
BEGIN
DBMS_CLOUD_AI.DROP_PROFILE(profile_name => 'OPENAI');
END;
/Verwendungshinweise
Verwenden Sie force, um ein Profil zu löschen und Fehler zu ignorieren, wenn kein AI-Profil vorhanden ist.
Prozedur ENABLE_PROFILE
Diese Prozedur aktiviert das vom Benutzer angegebene AI-Profil. Die Prozedur ändert den Status des AI-Profils in ENABLED.
Syntax
DBMS_CLOUD_AI.ENABLE_PROFILE(
profile_name IN VARCHAR2
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des zu aktivierenden AI-Profils Dieser Parameter ist erforderlich. |
Beispiel für die Aktivierung eines KI-Profils
BEGIN
DBMS_CLOUD_AI.ENABLE_PROFILE(
profile_name => 'OPENAI'
);
END;
/Prozedur DISABLE_PROFILE
Mit diesem Verfahren wird das AI-Profil in der aktuellen Datenbank deaktiviert. Mit dieser Prozedur wird der Status des AI-Profils in DISABLED geändert.
Syntax
DBMS_CLOUD_AI.DISABLE_PROFILE(
profile_name IN VARCHAR2
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name für das AI-Profil. Dieser Parameter ist erforderlich. |
Beispiel
BEGIN
DBMS_CLOUD_AI.DISABLE_PROFILE(
profile_name => 'OPENAI'
);
END;
/Prozedur SET_ATTRIBUTE
Mit diesem Verfahren können Sie AI-Profilattribute festlegen.
Syntax
DBMS_CLOUD_AI.SET_ATTRIBUTE(
profile_name IN VARCHAR2,
attribute_name IN VARCHAR2,
attribute_value IN CLOB
);Parameter
Nur der Eigentümer kann die Attribute des AI-Profils festlegen oder ändern. Eine Liste der unterstützten Attribute finden Sie unter Profilattribute.
| Parameter | Beschreibung |
|---|---|
|
|
Name des AI-Profils, für das Sie die Attribute festlegen möchten. Dieser Parameter ist erforderlich. |
|
|
Name des AI-Profilattributs Dieser Parameter ist erforderlich. |
|
|
Wert des Profilattributs. Der Standardwert ist NULL. |
Beispiel
BEGIN
DBMS_CLOUD_AI.SET_ATTRIBUTE(
profile_name => 'OPENAI',
attribute_name => 'credential_name',
attribute_value => 'OPENAI_CRED_NEW'
);
END;
/Prozedur SET_PROFILE
Diese Prozedur legt das AI-Profil für die aktuelle Session fest.
Nachdem Sie ein AI-Profil für die Datenbanksession festgelegt haben, wird jede SQL-Anweisung mit dem Präfix SELECT AI als Eingabeaufforderung in natürlicher Sprache betrachtet. Je nach der mit dem Präfix AI angegebenen Aktion wird eine Antwort mit AI generiert. Informationen zur Verwendung des Präfixes AI finden Sie unter AI-Schlüsselwort zur Eingabe von Prompts verwenden. Optional können Sie die Profilattribute überschreiben oder Attribute ändern, indem Sie sie im JSON-Format angeben. Informationen zum Festlegen der Attribute finden Sie unter Prozedur SET_ATTRIBUTE.
Das AI-Profil kann nur für die aktuelle Session festgelegt werden, wenn der Eigentümer des AI-Profils der Sessionbenutzer ist.
Um ein AI-Profil für alle Sessions eines bestimmten Datenbankbenutzers oder für alle Benutzersessions in der Datenbank festzulegen, sollten Sie einen Datenbankereignistrigger für das Ereignis AFTER LOGON für den bestimmten Benutzer oder die gesamte Datenbank verwenden. Weitere Informationen finden Sie unter CREATE TRIGGER-Anweisung in Oracle Database 19c Database PL/SQL Language Reference oder Oracle Database 26ai Database PL/SQL Language Reference.
Syntax
DBMS_CLOUD_AI.SET_PROFILE(
profile_name IN VARCHAR2,
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Ein Name für das AI-Profil in der aktuellen Session. Dieser Parameter ist erforderlich. |
Beispiel
BEGIN
DBMS_CLOUD_AI.SET_PROFILE(
profile_name => 'OPENAI'
);
END;
/Generierungsfunktion
showsql, narrate oder chat auszuführen. Die Standardaktion ist showsql.
Mit dieser Funktion können auch einige oder alle Profilattribute überschrieben werden.
Syntax
DBMS_CLOUD_AI.GENERATE(
prompt IN CLOB,
profile_name IN VARCHAR2 DEFAULT NULL,
action IN VARCHAR2 DEFAULT NULL,
attributes IN CLOB DEFAULT NULL
) RETURN CLOB;Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Eingabeaufforderung in natürlicher Sprache zur Übersetzung mit KI. Die Eingabeaufforderung kann Dieser Parameter ist erforderlich. |
|
|
Name des AI-Profils. Dieser Parameter ist optional, wenn in der Session bereits ein AI-Profil mit Der Standardwert ist NULL. Folgende Bedingungen gelten:
Hinweis: Bei Database Actions können Sie entweder das Argumentprofile_name in DBMS_CLOUD_AI.GENERATE angeben oder zwei Schritte als PL/SQL-Skript ausführen: DBMS_CLOUD_AI.SET_PROFILE und DBMS_CLOUD_AI.GENERATE.
|
action |
Aktion zum Übersetzen natürlicher Eingabeaufforderungen mit KI. Die unterstützten Aktionen umfassen Hinweis: Diese Funktion unterstützt die Aktionrunsql nicht. Wenn Sie die Aktion runsql angeben, wird der folgende Fehler zurückgegeben: |
attributes |
Überschreiben Sie bestimmte AI-Profilattribute, indem Sie Attribute im JSON-Format angeben. Weitere Informationen finden Sie unter Profilattribute. |
Beispiele
Die folgenden Beispiele zeigen die Aktionen showsql, narrate und chat, die mit der Funktion DBMS_CLOUD_AI.GENERATE verwendet werden können.
Ein Beispiel für die Aktion showsql:
SELECT DBMS_CLOUD_AI.GENERATE(prompt => 'how many customers',
profile_name => 'OPENAI',
action => 'showsql')
FROM dual;
Ein Beispiel für die Aktion narrate:
SELECT DBMS_CLOUD_AI.GENERATE(prompt => 'how many customers',
profile_name => 'OPENAI',
action => 'narrate')
FROM dual;
Ein Beispiel für die Aktion chat:
SELECT DBMS_CLOUD_AI.GENERATE(prompt => 'what is oracle autonomous database',
profile_name => 'OPENAI',
action => 'chat')
FROM dual;Funktion GENERATE_SYNTHETIC_DATA
Im Folgenden wird die Syntax zum Generieren synthetischer Daten für eine einzelne Tabelle beschrieben.
Syntax
DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA(
profile_name IN VARCHAR2,
object_name IN DBMS_ID,
owner_name IN DBMS_ID,
record_count IN NUMBER,
user_prompt IN CLOB DEFAULT NULL,
params IN CLOB DEFAULT NULL
);Im Folgenden wird die Syntax zum Generieren synthetischer Daten für mehrere Tabellen beschrieben.
DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA(
profile_name IN VARCHAR2,
object_list IN CLOB,
params IN CLOB DEFAULT NULL
);
Wenn Sie nicht möchten, dass Tabellendaten oder Vektorsuchdokumente an ein LLM gesendet werden, kann ein Benutzer mit Administratorberechtigungen diesen Zugriff für alle Benutzer der angegebenen Datenbank deaktivieren. Dadurch wird die Aktion narrate deaktiviert.
Parameter
| Parameter | Obligatorisch | Beschreibung |
|---|---|---|
|
|
Ja |
Das AI-Profil mit den erforderlichen LLM-Serviceinformationen. Dies kann mit der Prozedur CREATE_PROFILE erstellt werden. |
|
|
Ja | Geben Sie einen Tabellennamen an, um synthetische Daten aufzufüllen.
|
owner_name |
Nr. |
Geben Sie den Datenbankbenutzer an, der Eigentümer des referenzierten Objekts ist. Wenn kein bestimmter Eigentümer angegeben ist, verwendet die Prozedur standardmäßig das Schema des Benutzers, der sie ausführt. |
record_count |
Nr. |
Die Anzahl der Datensätze, die synthetisch generiert werden sollen. |
|
|
Nr. | Zusätzliche Informationen, die ein Benutzer erwähnen kann, um synthetische Daten zu generieren. Beispiel: Um einen Datensatz für eine Tabelle namens MOVIE mit einer Spalte release_date zu generieren, kann user_prompt Folgendes sein:
Das Veröffentlichungsdatum für die Filme sollte 2019 sein |
|
|
Nr. |
Optionale Attribute, die im JSON-Objektzeichenfolgenformat angegeben werden, um das Verhalten einer API zu ändern. Siehe Optionale Parameter. |
|
|
Ja | Verwenden Sie diesen Parameter, um synthetische Daten in mehreren Tabellen zu generieren. Dieser Parameter nimmt Informationen zu Tabellenobjekten zusammen mit seinen Argumenten auf und enthält dieselben Argumente, die in der einzelnen Tabelle angegeben sind. Siehe object_list Parameter. |
Optionale Parameter
| Parameter | Wertdatentyp | Datum | Beschreibung |
|---|---|---|---|
|
|
Nummer |
|
Geben Sie die Anzahl der Zeilen aus der Tabelle an, die als Beispiel für das LLM bei der Datengenerierung verwendet werden sollen. Der Wert 0 bedeutet, dass keine Beispielzeilen verwendet werden. Der Standardwert ist |
|
|
Boolescher Wert |
|
Aktivieren oder deaktivieren Sie die Verwendung von Tabellenstatistikinformationen. Der Standardwert ist |
|
|
String (Zeichenfolgendatentyp) |
Gültige Werte:
|
Weisen Sie einen Prioritätswert zu, der die Anzahl der parallelen Anforderungen definiert, die zum Generieren synthetischer Daten an das LLM gesendet werden. Aufgaben mit höherer Priorität verbrauchen mehr Datenbankressourcen und werden schneller abgeschlossen. Der Standardwert ist
Die maximale Anzahl gleichzeitiger paralleler Prozesse für die Generierung synthetischer Daten ist auf 64 begrenzt. |
|
|
Boolescher Wert |
|
Aktivieren oder deaktivieren Sie das Senden von Kommentaren an das LLM, um die Datengenerierung zu steuern. Der Standardwert ist |
object_list-Parameter
| Parameter | Wertdatentyp | Obligatorisch | Beschreibung |
|---|---|---|---|
|
|
String (Zeichenfolgendatentyp) |
Ja |
Gibt den Datenbankbenutzer an, der Eigentümer des referenzierten Objekts ist. Wenn kein bestimmter Eigentümer angegeben ist, verwendet die Prozedur standardmäßig das Schema des Benutzers, der sie ausführt. |
|
|
String (Zeichenfolgendatentyp) |
Nr. |
Geben Sie einen Tabellennamen an, um synthetische Daten aufzufüllen. Die Berechtigung SELECT und INSERT für die Tabellenobjekte sind für den Benutzer erforderlich, der die Tabelle it.The verwendet, die entweder leer ist oder Datensätze enthält.
|
|
|
Nummer |
Nr. |
Die Anzahl der Datensätze, die synthetisch generiert werden sollen. Bitte geben Sie eine Zahl größer als 0 an. Geben Sie |
|
|
Nummer |
Nr. |
Der Prozentsatz der Anzahl der Datensätze, die synthetisch generiert werden sollen. Bitte geben Sie eine Zahl größer als 0 an. Bei einer Metadatenklondatenbank, in der die Tabellenmetadaten einschließlich Statistiken beibehalten werden, wird der Parameter Geben Sie Wenn Sie den Parameter
record_count_percentage verwenden, wird die endgültige Datensatzanzahl in der Tabelle wie folgt berechnet:
|
|
|
String (Zeichenfolgendatentyp) | Nr. | Entspricht: user_prompt in Parameters. Die user_prompt ist mit einem bestimmten Tabellenobjekt verknüpft.
|
Beispiele
Die folgenden Beispiele zeigen die Funktion DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA zum Generieren synthetischer Daten für eine einzelne Tabelle und mehrere Tabellen. Ein vollständiges Beispiel und weitere Beispiele finden Sie in der Dokumentation .
BEGIN
DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA(
profile_name => 'GENAI',
object_name => 'Director',
owner_name => 'ADB_USER',
record_count => 5
);
END;
/
PL/SQL procedure successfully completed.BEGIN
DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA(
profile_name => 'GENAI',
object_list => '[{"owner": "ADB_USER", "name": "Director","record_count":5},
{"owner": "ADB_USER", "name": "Movie_Actor","record_count":5},
{"owner": "ADB_USER", "name": "Actor","record_count":10},
{"owner": "ADB_USER", "name": "Movie","record_count":5,"user_prompt":"all movies are released in 2009"}]'
);
END;
/
PL/SQL procedure successfully completed.Prozedur ENABLE_DATA_ACCESS
Dieses Verfahren ermöglicht das Senden von Daten an LLM für anwendbare Select AI-Features. Dies ist das Standardverhalten. Diese Prozedur kann nur von einem Administrator ausgeführt werden.
Diese Prozedur kontrolliert den Datenzugriff für die folgenden Select AI-Funktionen:
- Aktion
narrate - Retrieval Augmented Generation (RAG)
- Synthetische Datengenerierung
Syntax
DBMS_CLOUD_AI.ENABLE_DATA_ACCESS();Parameter
Für dieses Verfahren sind keine Parameter erforderlich.
Beispiel für die Aktivierung des Datenzugriffs
BEGIN
DBMS_CLOUD_AI.ENABLE_DATA_ACCESS();
END;
/Prozedur DISABLE_DATA_ACCESS
Dieses Verfahren deaktiviert das Senden von Daten an LLM für anwendbare Select AI-Features. Diese Prozedur kann nur von einem Administrator ausgeführt werden.
Diese Prozedur begrenzt die folgenden Select AI-Funktionen:
- Aktion
narrate - Retrieval Augmented Generation (RAG)
- Synthetische Datengenerierung
Syntax
DBMS_CLOUD_AI.DISABLE_DATA_ACCESS();Parameter
Für dieses Verfahren sind keine Parameter erforderlich.
Beispiel zum Deaktivieren des Datenzugriffs
BEGIN
DBMS_CLOUD_AI.DISABLE_DATA_ACCESS();
END;
/Prozedur CREATE_VECTOR_INDEX
Bei dieser Prozedur wird ein Vektorindex in der angegebenen Vektordatenbank erstellt und mit Daten aus einem Objektspeicher mit einem asynchronen Scheduler-Job aufgefüllt.
Syntax
PROCEDURE CREATE_VECTOR_INDEX(
index_name IN VARCHAR2,
attributes IN CLOB DEFAULT NULL,
status IN VARCHAR2 DEFAULT NULL,
description IN CLOB DEFAULT NULL
); Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des Vektorindex. Der Vektorindexname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Name des Vektorspeichers darf maximal 125 Zeichen lang sein. Dies ist ein obligatorischer Parameter. |
|
|
Benutzerdefinierte Attribute für den Vektorindex in JSON. Eine Liste der konfigurierbaren Parameter finden Sie unter Vektorindexattribute. Der Standardwert ist NULL. |
status |
Status des Vektorindex. Mögliche Werte sind:
Der Standardwert ist Deaktiviert. |
|
|
Beschreibung für den Vektorindex. Der Standardwert ist NULL. |
Beispiel
Im folgenden Beispiel wird gezeigt, wie Sie einen Vektorindex erstellen und die Attribute als JSON-Parameter konfigurieren.
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX'
attributes => JSON_OBJECT(
'vector_db_provider' value 'oracle',
'vector_table_name' value 'oracle_mycollection',
'profile_name' value 'OCIGENAI',
'location' value
'https://objectstorage.us-phoenix-1.' ||
'oraclecloud.com/n/mynamespace/b/mybucket',
'object_store_credential_name' value 'OS_CRED',
'chunk_size' value 2048,
'chunk_overlap' value 256,
'refresh_rate' value 720)
);
END;
/Prozedur DROP_VECTOR_INDEX
Mit diesem Verfahren wird ein Vektorspeicherindex entfernt. Es entfernt normalerweise das Vektorspeicher-Indexobjekt und löscht den Vektorspeicher. Wenn dieser Wert auf FALSE gesetzt ist, stellt das Argument include_data sicher, dass die Prozedur das Vektorspeicherindexobjekt nur entfernt, während der Vektorspeicher beibehalten wird.
Syntax
PROCEDURE DROP_VECTOR_INDEX(
index_name IN VARCHAR2,
include_data IN BOOLEAN DEFAULT TRUE,
force IN BOOLEAN DEFAULT FALSE
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des Vektorindex. Der Vektorindexname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Name des Vektorspeichers darf maximal 125 Zeichen lang sein. Dies ist ein obligatorischer Parameter. |
|
|
Gibt an, ob sowohl der Vektorspeicher des Kunden als auch der Vektorindex zusammen mit dem Vektorindexobjekt gelöscht werden. Mögliche Werte:
Der Standardwert ist |
force |
Gibt an, ob Fehler ignoriert werden sollen, die auftreten, wenn der Vektorindex nicht vorhanden ist. Mögliche Werte:
Wenn dieser Parameter auf Der Standardwert ist |
Beispiel
BEGIN
DBMS_CLOUD_AI.DROP_VECTOR_INDEX(
index_name => 'MY_INDEX',
include_data => FALSE,
force => TRUE
);
END;
/Prozedur DISABLE_VECTOR_INDEX
Mit dieser Prozedur wird ein Vektorindexobjekt in der aktuellen Datenbank deaktiviert. Wenn diese Option deaktiviert ist, kann ein AI-Profil den Vektorindex nicht verwenden. Das System lädt keine Daten in den Vektorspeicher, da neue Daten zum Objektspeicher hinzugefügt werden, und führt keine Indexierung, Suche oder Abfrage basierend auf dem Index durch.
Syntax
DBMS_CLOUD_AI.DISABLE_VECTOR_INDEX(
index_name IN VARCHAR2
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des Vektorindex. Der Vektorindexname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Name des Vektorspeichers darf maximal 125 Zeichen lang sein. Dies ist ein obligatorischer Parameter. |
Beispiel
Sie können einen Vektorindex deaktivieren, indem Sie den Namen des Vektorindex angeben.
BEGIN
DBMS_CLOUD_AI.DISABLE_VECTOR_INDEX(index_name => 'MY_INDEX');
END;
/Prozedur ENABLE_VECTOR_INDEX
Mit dieser Prozedur wird ein zuvor deaktiviertes Vektorindexobjekt aktiviert oder aktiviert. Wenn Sie einen Vektorindex erstellen, ist er standardmäßig so aktiviert, dass das AI-Profil ihn für die Indexierung und Suche verwenden kann.
Wenn diese Option aktiviert ist, ermöglicht ein Vektorindex es einem AI-Profil, neue Daten aus einem Objektspeicher mit einer benutzerdefinierten Aktualisierungsrate in einen Vektorspeicher zu laden. Sie können den Parameter refresh_rate über die JSON-Objektliste angeben. Informationen zum Konfigurieren der JSON-Attribute finden Sie unter Vektorindexattribute.
Syntax
DBMS_CLOUD_AI.ENABLE_VECTOR_INDEX(
index_name IN VARCHAR2
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des Vektorindex. Der Vektorindexname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Name des Vektorspeichers darf maximal 125 Zeichen lang sein. Dies ist ein obligatorischer Parameter. |
Beispiel
Sie können einen Vektorindex aktivieren oder aktivieren, indem Sie den Vektorindexnamen wie folgt angeben:
BEGIN
DBMS_CLOUD_AI.ENABLE_VECTOR_INDEX(index_name => 'MY_INDEX');
END;
/Prozedur UPDATE_VECTOR_INDEX
- Attributwerte verschiedener Typen.
- Vektorindexattribute als JSON-Dokument und aktualisiert ein oder mehrere Attribute eines vorhandenen Vektorspeicherindexes mit dem angegebenen Attributnamen- und Wertpaar.
Syntax
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name IN VARCHAR2,
attributes IN CLOB
);
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name IN VARCHAR2,
attribute_name IN VARCHAR2,
attribute_value IN VARCHAR2
);
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name IN VARCHAR2,
attribute_name IN VARCHAR2,
attribute_value IN CLOB DEFAULT NULL
);
Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Name des Vektorindex. Der Vektorindexname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Name des Vektorspeichers darf maximal 125 Zeichen lang sein. Dies ist ein obligatorischer Parameter. |
|
|
Gibt Vektorindexattribute im JSON-Format an. Dies ist ein obligatorischer Parameter. |
|
|
Name der benutzerdefinierten Attribute, die in der Prozedur Sie können die folgenden Attribute nicht ändern:
Dies ist ein obligatorischer Parameter. |
attribute_value |
Vom Benutzer angegebener Wert für die benutzerdefinierte Der Standardwert ist NULL. |
Hinweis:
Verwenden Sie entweder den Parameterattributes, um attribute_name- und Wertpaare im JSON-Format oder die Parameter attribute_name und attribute_value gemeinsam anzugeben.
Beispiele
BEGIN
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attribute_name => 'object_storage_credential_name',
attribute_value => 'NEW_CRED'
);
END;
/Im folgenden Beispiel wird der Typ NUMBER als attribute_value akzeptiert.
BEGIN
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attribute_name => 'match_limit',
attribute_value => 10
);
END;
/Im folgenden Beispiel wird der Typ VARCHAR2 als attribute_value akzeptiert.
BEGIN
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attribute_name => 'profile_name',
attribute_value => 'AI_PROF2'
);
END;
/Im folgenden Beispiel wird attributes im JSON-Format akzeptiert.
BEGIN
DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX(
index_name => 'MY_VECTOR_INDEX',
attributes => '{"match_limit": 10,
"refresh_rate": 30}'
);
END;
/Vektorindexattribute
Attribute
| Attributname | Datum | Obligatorisch | Beschreibung |
|---|---|---|---|
chunk_size |
1024 (Standard)
|
Nr. |
Textgröße für das Blockieren der Eingabedaten. Bei Textdaten bedeutet dies die Anzahl der Zeichen. |
chunk_overlap |
128 (Standard)
|
Nr. |
Gibt die Anzahl sich überschneidender Zeichen zwischen angrenzenden Textblöcken an. Dieses Attribut ist nützlich, um kontextbezogene Kontinuität und Genauigkeit bei der Textverarbeitung sicherzustellen, indem Überschneidungen zwischen Segmenten zugelassen werden. Dadurch wird der Verlust kontextbezogener Informationen an Chunk-Grenzen verhindert. |
|
|
- | Ja |
Dieser Parameter gibt die URI der Quelldatei oder Verzeichnisse und Quelldateien an. Platzhaltermuster werden sowohl für Quelldatei-URIs als auch für Verzeichnisse unterstützt. URIs der Cloud-Quelldatei: Sie können eine Quelldatei-URI für Bucket oder Unterordner angeben. Sie können Platzhalter verwenden, um Unterordner oder Dateinamen anzugeben. Das Zeichen " Beispiel mit Platzhaltern: location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/*.csv Das Format der URIs ist vom benutzten Cloud-Objektspeichersystem abhängig. Weitere Einzelheiten finden Sie unter URI-Formate für Cloud Object Storage. Verzeichnis: Sie können ein Verzeichnis und einen Dateinamen angeben. Das Format für die Angabe eines Verzeichnisses lautet: Sie können nur Platzhalter verwenden, um Dateinamen in einem Verzeichnis anzugeben. Das Zeichen Verwenden Sie doppelte Anführungszeichen, um einen Verzeichnisnamen anzugeben, bei dem die Groß-/Kleinschreibung beachtet wird. Beispiel: Um ein Anführungszeichen einzuschließen, verwenden Sie zwei Anführungszeichen. Beispiel: Die Dateien an diesem Speicherort können Dokumente in Formaten wie PDF, DOC, JSON, XML oder HTML sein. Siehe Unterstützte Dokumentformate. |
|
|
5 (Standard)
|
Nr. |
Gibt die maximale Anzahl von Ergebnissen an, die in einer Vektorsuchabfrage zurückgegeben werden sollen. Dadurch wird die Ausgabegröße gesteuert und die Effizienz von Datenabrufvorgängen verbessert. |
|
|
- | Ja |
Gibt den Namen der Zugangsdaten für den Zugriff auf einen Objektspeicher an. |
|
|
<vector_index_name>$VECPIPELINE |
Nr. |
Gibt den Namen der Dataload-Pipeline für Vektorindizes an. Dieses Attribut wird automatisch für den Vektorindex festgelegt. Sie können es nicht angeben oder ändern. Mit dem Pipelinenamen können Sie das Dataload des Vektorindex mit Pipelines überwachen und Fehler beheben überwachen. |
|
|
- | Ja |
Name des KI-Profils, das zum Einbetten von Quelldaten und Benutzer-Prompts verwendet wird. |
|
|
1440 Minuten (Standard)
|
Nr. |
Intervall für die Aktualisierung von Daten im Vektorspeicher. Die Einheit ist Minuten. |
|
|
0 (Standard)
|
Nr. |
Definiert die minimale Ähnlichkeitsebene, die erforderlich ist, damit zwei Elemente als Übereinstimmung betrachtet werden. Das ist nützlich zum Filtern der Ergebnisse in Übereinstimmungsalgorithmen, um die Relevanz sicherzustellen. |
|
|
Eine Zeichenfolge, die einem der in der Beschreibung angegebenen Werte entspricht. |
Nr. |
Gibt den Typ der Entfernungsberechnung an, die zum Vergleichen von Vektoren in einer Datenbank verwendet wird, und bestimmt, wie die Ähnlichkeit zwischen Elementen quantifiziert wird. Gültige Werte für Oracle 23ai:
|
|
|
|
Ja |
Gibt den Providernamen an, der als Vektorspeicher verwaltet und dient. |
|
|
- | Nr. |
Gibt die Anzahl der Elemente in jedem Vektor innerhalb des Vektorspeichers an und definiert die Größe und Struktur der Datendarstellung. |
|
|
|
Nr. |
Gibt den Namen der Tabelle oder Sammlung an, in der Vektoreinbettungen und Blockdaten gespeichert werden. |
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attributes => '{"vector_db_provider": "oracle",
"location": "https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/my_namespace/my_bucket/my_data_folder",
"object_storage_credential_name": "OCI_CRED",
"profile_name": "OPENAI_ORACLE",
"vector_dimension": 1024,
"vector_distance_metric": "cosine",
"chunk_overlap":128,
"chunk_size":1024
}');
END;
/
/In diesem Beispiel wird ein Platzhaltermuster (*) in der Object Storage-URI als Parameter location angegeben. Es lädt alle CSV-Dateien aus der Object Storage-URI.
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attributes => JSON_OBJECT(
'vector_db_provider' value 'oracle',
'vector_table_name' value 'oracle_mycollection',
'profile_name' value 'OCIGENAI',
'location' value 'https://objectstorage.myregion.oraclecloud.com/n/my$namespace/b/bucketname/o/year=????/month=??/file*.csv)',
'object_storage_credential_name' value 'OS_CRED',
'chunk_size' value 2048,
'chunk_overlap' value 256,
'refresh_rate' value 720)
);
END;
/In diesem Beispiel werden Verzeichnisobjekte im Parameter location mit einem Platzhaltermuster angegeben. Es lädt alle CSV-Dateien im Verzeichnis MY_DIR.
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attributes => JSON_OBJECT(
'vector_db_provider' value 'oracle',
'vector_table_name' value 'oracle_mycollection',
'profile_name' value 'OCIGENAI',
'location' value 'MY_DIR:*.csv',
'object_storage_credential_name' value 'OS_CRED',
'chunk_size' value 2048,
'chunk_overlap' value 256,
'refresh_rate' value 720)
);
END;
/In diesem Beispiel werden Verzeichnisobjekte im Parameter location mit einem Platzhaltermuster angegeben, bei denen die Groß-/Kleinschreibung beachtet wird. Es lädt alle CSV-Dateien im Verzeichnis My_Dir.
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attributes => JSON_OBJECT(
'vector_db_provider' value 'oracle',
'vector_table_name' value 'oracle_mycollection',
'profile_name' value 'OCIGENAI',
'location' value '"My_Dir":*.csv',
'object_storage_credential_name' value 'OS_CRED',
'chunk_size' value 2048,
'chunk_overlap' value 256,
'refresh_rate' value 720)
);
END;
/In diesem Beispiel wird im Parameter location ein Verzeichnisobjekt angegeben, bei dem die Groß-/Kleinschreibung beachtet wird. Verwenden Sie dazu ein Platzhaltermuster (*). Es lädt alle Dateien im Verzeichnis My_Dir.
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attributes => JSON_OBJECT(
'vector_db_provider' value 'oracle',
'vector_table_name' value 'oracle_mycollection',
'profile_name' value 'OCIGENAI',
'location' value '"My_Dir":*',
'object_storage_credential_name' value 'OS_CRED',
'chunk_size' value 2048,
'chunk_overlap' value 256,
'refresh_rate' value 720)
);
END;
/In diesem Beispiel wird ein Verzeichnisobjekt angegeben, und im Parameter location wird ein Dateinamenpräfix wie test verwendet. Es lädt alle Dateien im Verzeichnis MY_DIR, deren Namen mit test beginnen.
BEGIN
DBMS_CLOUD_AI.CREATE_VECTOR_INDEX(
index_name => 'MY_INDEX',
attributes => JSON_OBJECT(
'vector_db_provider' value 'oracle',
'vector_table_name' value 'oracle_mycollection',
'profile_name' value 'OCIGENAI',
'location' value 'MY_DIR:test*',
'object_storage_credential_name' value 'OS_CRED',
'chunk_size' value 2048,
'chunk_overlap' value 256,
'refresh_rate' value 720)
);
END;
/Prozedur CREATE_CONVERSATION
Mit diesem Verfahren können Sie eine Unterhaltung erstellen und automatisch die conversation_id innerhalb der Prozedur festlegen.
Hinweis:
Wenn Sie die ProzedurDBMS_CLOUD_AI.CREATE_CONVERSATION verwenden, können Sie die Einstellung von conversation_id überspringen, da sie von der Prozedur automatisch festgelegt wird.
Syntax
DBMS_CLOUD_AI.CREATE_CONVERSATION(
attributes IN CLOB DEFAULT NULL
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Attribute für Unterhaltung im JSON-Format. Weitere Informationen finden Sie unter CREATE_CONVERSATION Attribute. Der Standardwert ist NULL. |
Beispiel
Das folgende Beispiel zeigt das Erstellen einer Unterhaltung ohne Anpassung.
EXEC DBMS_CLOUD_AI.CREATE_CONVERSATION;Ergebnis:
PL/SQL procedure successfully completed.Das folgende Beispiel zeigt das Erstellen einer Unterhaltung mit benutzerdefinierten Parametern, wie title, description, retention_days und conversation_length.
-- Create conversation with custom attributes
SELECT DBMS_CLOUD_AI.CREATE_CONVERSATION(
attributes => '{"title":"Conversation 1",
"description":"this is a description",
"retention_days":5,
"conversation_length":5}')
AS conversation_id FROM dual;Funktion CREATE_CONVERSATION
Diese Funktion erstellt eine Unterhaltung und gibt die zugehörige conversation_id zurück, die in anderen Prozeduren oder Funktionen wie DBMS_CLOUD_AI.SET_CONVERSATION_ID und DBMS_CLOUD_AI.GENERATE verwendet werden kann.
Oracle empfiehlt, conversation_id festzulegen, um die Unterhaltung zu aktivieren. Alternativ können Sie conversation_id in der Funktion DBMS_CLOUD_AI.GENERATE festlegen.
Hinweis:
Wenn Sie die ProzedurDBMS_CLOUD_AI.CREATE_CONVERSATION verwenden, können Sie die Einstellung von conversation_id überspringen, da sie von der Prozedur automatisch festgelegt wird.
Syntax
DBMS_CLOUD_AI.CREATE_CONVERSATION(
attributes IN CLOB DEFAULT NULL
) RETURN VARCHAR2;Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Attribute für Unterhaltung im JSON-Format. Weitere Informationen finden Sie unter CREATE_CONVERSATION Attribute. Der Standardwert ist NULL. |
Beispiel
Das folgende Beispiel zeigt, wie Sie mit der Funktion DBMS_CLOUD_AI.CREATE_CONVERSATION eine Unterhaltung ohne Anpassung erstellen.
SELECT DBMS_CLOUD_AI.CREATE_CONVERSATION FROM DUAL;Ergebnis:
CREATE_CONVERSATION
------------------------------------
30C9DB6E-EA4D-AFBA-E063-9C6D46644B92Das folgende Beispiel zeigt, wie Sie mit der Funktion DBMS_CLOUD_AI.CREATE_CONVERSATION Attribute wie title, retention_days und conversation_length angeben.
SELECT DBMS_CLOUD_AI.CREATE_CONVERSATION(
attributes => '{"title":"This is a test conversation",
"retention_days":7,
"conversation_length":20}')
FROM DUAL;CREATE_CONVERSATION-Attribute
Attribute
| Attributname | Standardwert | Beschreibung |
|---|---|---|
|
|
Neue Unterhaltung |
Der vom Benutzer zugewiesene Name für die Unterhaltung. Wenn diese Option nicht angegeben ist, generiert das LLM ein LLM, wenn die Unterhaltung zum ersten Mal mit einer Eingabeaufforderung verwendet wird. |
|
|
NULL |
Stellt eine benutzerdefinierte Beschreibung bereit, die den Zweck oder den Kontext der Unterhaltung zusammenfasst. Wenn es nicht bereitgestellt wird, generiert das LLM eines, wenn die Unterhaltung zum ersten Mal mit einer Eingabeaufforderung verwendet wird, und aktualisiert es beim 5. Einsatz erneut, um genauere und relevantere Informationen aufzunehmen. |
|
|
7 |
Geben Sie an, wie viele Tage die Unterhaltungshistorie beibehalten werden soll. Dieser wird ab dem Erstellungsdatum in der Datenbank gespeichert. Wenn Sie den Wert weglassen, setzt das System ihn auf den Standardwert 7. Wenn Sie die Konversation auf 0 setzen, wird sie beibehalten, bis Sie sie mit der Prozedur |
|
|
NULL |
Geben Sie die Anzahl der letzten Prompts und Antworten an, die in die aktuelle Eingabeaufforderung aufgenommen werden sollen. Der maximal zulässige Wert beträgt 999. Sie können diesen Wert außer Kraft setzen, indem Sie den Parameter
conversation_length in der Funktion DBMS_CLOUD_AI.GENERATE angeben oder ihn im AI-Profil mit SELECT AI <ACTION> <PROMPT> festlegen. Wenden Sie die folgenden Prioritätsregeln für conversation_length an:
Wenn keiner von ihnen die |
DBMS_CLOUD_AI.CREATE_CONVERSATION anpassen können.-- Create conversation with custom attributes
SELECT DBMS_CLOUD_AI.CREATE_CONVERSATION(
attributes => '{"title":"Conversation 1",
"description":"this is a description",
"retention_days":5,
"conversation_length":5}')
AS conversation_id FROM dual;Prozedur UPDATE_CONVERSATION
Diese Prozedur aktualisiert eine vorhandene Konversation mit einem angegebenen Wert der Konversationsattribute.
Syntax
DBMS_CLOUD_AI.UPDATE_CONVERSATION(
conversation_id IN VARCHAR2,
attributes IN CLOB
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Eindeutige Nummer, die einer Unterhaltung zugewiesen ist. Dies ist ein obligatorischer Parameter. |
|
|
Attribute für Unterhaltung im JSON-Format. Weitere Informationen finden Sie unter CREATE_CONVERSATION Attribute. |
Beispiel
EXEC DBMS_CLOUD_AI.UPDATE_CONVERSATION(
conversation_id => '30C9DB6E-EA4E-AFBA-E063-9C6D46644B92',
attributes => '{"retention_days":20,
"description":"This a sample description",
"title":"Sample title",
"conversation_length":20}');Ergebnis:
PL/SQL procedure successfully completed.Prozedur SET_CONVERSATION_ID
Diese Prozedur setzt die aktuelle Konversation auf die angegebene Kennung. Nachfolgende Prompts enthalten vorhandene Unterhaltungs-Prompts basierend auf den konfigurierten Attributen der Unterhaltung.
Syntax
DBMS_CLOUD_AI.SET_CONVERSATION_ID(
conversation_id IN VARCHAR2
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Eindeutige Nummer, die einer Unterhaltung in der aktuellen Sitzung zugewiesen ist. Dieser Parameter ist obligatorisch. |
Beispiel
EXEC DBMS_CLOUD_AI.SET_CONVERSATION_ID('30C9DB6E-EA4D-AFBA-E063-9C6D46644B92');
Ergebnis:
PL/SQL procedure successfully completed.Funktion GET_CONVERSATION_ID
DBMS_CLOUD_AI.SET_CONVERSATION_ID oder DBMS_CLOUS_AI.CREATE_CONVERSATION zurück. Wenn Sie keine Unterhaltung festgelegt haben, gibt die Funktion NULL zurück. Wenn Sie die Konversation löschen, wird sie auch in der Sitzung gelöscht. Siehe Prozedur CLEAR_CONVERSATION_ID.
Syntax
DBMS_CLOUD_AI.GET_CONVERSATION_ID
RETURN VARCHAR2;Beispiel
In diesem Beispiel wird die Konversationskennung angezeigt, die in der aktuellen Sitzung festgelegt wurde.
SELECT DBMS_CLOUD_AI.GET_CONVERSATION_ID;Ergebnis:
--------------------------------------------------------------------------------
30C9DB6E-EA4F-AFBA-E063-9C6D46644B92Prozedur CLEAR_CONVERSATION_ID
Bei dieser Prozedur wird eine in der Session festgelegte Unterhaltungs-ID gelöscht, um die Unterhaltungsfunktion für SELECT AI <ACTION> <PROMPT> zu deaktivieren. Wenn Sie keine Konversation festgelegt haben, löst das System keinen Fehler aus.
Syntax
DBMS_CLOUD_AI.CLEAR_CONVERSATION_ID;Beispiel
Dieses Beispiel zeigt die Anzeige der aktuellen Konversations-ID in der Session, das Löschen der ID und die Prüfung der Änderung.
-- A conversation id is set in the session
SELECT DBMS_CLOUD_AI.GET_CONVERSATION_ID FROM dual;
GET_CONVERSATION_ID
--------------------------------------------------------------------------------
3A88BFF0-1D7E-B3B8-E063-9C6D46640ECD
-- Clear the conversation id
EXEC DBMS_CLOUD_AI.CLEAR_CONVERSATION_ID;
PL/SQL procedure successfully completed.
-- The conversation id is removed from the session
SELECT DBMS_CLOUD_AI.GET_CONVERSATION_ID FROM dual;
GET_CONVERSATION_ID
--------------------------------------------------------------------------------Prozedur DELETE_CONVERSATION_PROMPT
Die Prozedur entfernt eine bestimmte Eingabeaufforderung aus der Konversation.
Syntax
DBMS_CLOUD_AI.DELETE_CONVERSATION_PROMPT(
conversation_prompt_id IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Eindeutige Nummer, die einer Eingabeaufforderung in einer Konversation zugewiesen ist. Sie können die Prompt-ID suchen, indem Sie die View Dies ist ein obligatorischer Parameter. |
|
|
Wenn Der Standardwert für diesen Parameter ist |
Beispiel
EXEC DBMS_CLOUD_AI.DELETE_CONVERSATION_PROMPT('30C9DB6E-EA61-AFBA-E063-9C6D46644B92');Ergebnis:
PL/SQL procedure successfully completed.Prozedur DROP_CONVERSATION
Die Prozedur entfernt die Konversation und alle zugehörigen Prompts und die zugehörigen Antworten. Nach dem Löschen wird conversation_id ungültig. Wenn eine Unterhaltung gelöscht wird, während sie in der Sitzung festgelegt wird, wird sie automatisch gelöscht.
Syntax
DBMS_CLOUD_AI.DROP_CONVERSATION(
conversation_id IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Eindeutige Nummer, die einer Unterhaltung zugewiesen ist. Dies ist ein obligatorischer Parameter. |
|
|
Wenn Der Standardwert für diesen Parameter ist |
Beispiel
EXEC DBMS_CLOUD_AI.DROP_CONVERSATION('30C9DB6E-EA4D-AFBA-E063-9C6D46644B92');Ergebnis:
PL/SQL procedure successfully completed.FEEDBACK-Verfahren
Syntax
DBMS_CLOUD_AI.FEEDBACK(
profile_name IN VARCHAR2,
sql_id IN DBMS_ID,
feedback_type IN VARCHAR2 DEFAULT NULL,
response IN CLOB DEFAULT NULL,
feedback_content IN CLOB DEFAULT NULL,
operation IN VARCHAR2 DEFAULT 'ADD'
);
DBMS_CLOUD_AI.FEEDBACK(
profile_name IN VARCHAR2,
sql_text IN CLOB,
feedback_type IN VARCHAR2 DEFAULT NULL,
response IN CLOB DEFAULT NULL,
feedback_content IN CLOB DEFAULT NULL,
operation IN VARCHAR2 DEFAULT 'ADD'
);Parameter
| Parameter | Beschreibung |
|---|---|
|
|
Gibt das zu verwendende AI-Profil an. Wenn Sie keine Dies ist ein obligatorischer Parameter. |
|
|
Gibt die SQL-Abfrage an. Eine Dies ist ein obligatorischer Parameter. |
|
|
Enthält den vollständigen Text der SQL-Abfrage. Dies ist ein obligatorischer Parameter. |
|
|
Gibt den Feedbacktyp an. Die verfügbaren Werte sind:
Hinweis: Mit der ProzedurDBMS_CLOUD_AI.FEEDBACK können Sie sql_id oder sql_text angeben. Daher ist feedback_type erforderlich. Wenn Sie die Aktion feedback verwenden, ermittelt oder interpretiert das LLM den Feedbacktyp dynamisch.
Dies ist ein obligatorischer Parameter, wenn |
|
|
Stellt das korrekte SQL-Abfrageergebnis dar, das der Benutzer erwartet. Dies ist ein obligatorischer Parameter, wenn |
|
|
Erfasst das Feedback des Benutzers in natürlicher Sprache. Sie können diesen Parameter zusammen mit |
|
|
Gibt die auszuführende Operation an. Folgende Werte werden akzeptiert:
|
Beispiel
Das folgende Beispiel zeigt, wie Sie mit der Prozedur DBMS_CLOUD_AI.FEEDBACK die generierte SQL akzeptieren oder verbessern, indem Sie die Parameter aus der Prozedur angeben.
EXEC DBMS_CLOUD_AI.FEEDBACK(profile_name=>'OCI_FEEDBACK1',
sql_id=> '852w8u83gktc1',
feedback_type=>'positive',
operation=>'add');
EXEC DBMS_CLOUD_AI.FEEDBACK(profile_name=>'OCI_FEEDBACK1',
sql_text=> 'select ai showsql how many movies',
feedback_type=> 'negative',
response=>'SELECT SUM(1) FROM "ADB_USER"."MOVIES"',
feedback_content=>'Use SUM instead of COUNT');
EXEC DBMS_CLOUD_AI.FEEDBACK(profile_name=>'OCI_FEEDBACK1',
sql_id=> '852w8u83gktc1',
operation=>'delete');Vektor-Index für FEEDBACK
<profile_name>_FEEDBACK_VECINDEX mit Standardattributen erstellt, wenn Sie das Feedbackfeature zum ersten Mal verwenden.
Sie können die zugehörigen Attribute wie similarity_threshold und match_limit mit der Prozedur DBMS_CLOUD_AI.UPDATE_VECTOR_INDEX ändern. Mit diesem Index können Sie zukünftig generierte SQL basierend auf dem Feedback verfeinern. Diese Tabelle wird gelöscht, wenn das zugehörige AI-Profil gelöscht wird. Sie können auch <profile_name>_FEEDBACK_VECINDEX löschen. Wenn Sie dies tun, verwendet Select AI kein Feedback mehr als Hinweise für die Aktionen runsql, showsql und explainsql. Wenn Sie jedoch neues Feedback mit der Funktion "KI-Feedback auswählen" übermitteln, erstellt Select AI automatisch einen neuen Feedbackvektorindex
Hinweis:
Der Standardwert vonmatch_limit für feedback ist 3.
Vektortabellenname
Die Tabelle <profile_name>_FEEDBACK_VECINDEX$VECTAB enthält Vektordarstellungen (Einbettungen) von Benutzerfeedback zusammen mit anderen Parametern, die von Select AI zur Verbesserung der SQL-Generierung im Zeitverlauf verwendet werden.
Parameter
| Spalte | Beschreibung |
|---|---|
|
|
Umfasst JSON-Objektattribute gemäß der FEEDBACK-Prozedur. |
|
|
Enthält die Benutzereingabeaufforderung. |
|
|
Enthält Vektordarstellungen (Einbettungen) der Benutzereingabeaufforderung. |
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der automatisch generierten Vektorindextabelle zur Abfrage und Rückmeldung.
SQL> select content, attributes from OCI_FEEDBACK1_FEEDBACK_VECINDEX$VECTAB where JSON_VALUE(attributes, '$.sql_text') = 'select ai showsql how many movies';
CONTENT
----------------------------------------------------------------------------------------------------
how many movies
ATTRIBUTES
----------------------------------------------------------------------------------------------------
{"response":"SELECT SUM(1) FROM \"ADB_USER\".\"MOVIES\"","feedback_type":"negative","sql_id":null,"sql_text":"select ai showsql how many movies","feedback_content":null}
DBMS_CLOUD_AI.feedback Procedure(Positive Feedback)