DBMS_CLOUD_AI-Package

profile_name

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.

attributes

Profilattribute im JSON-Format. Weitere Informationen finden Sie unter Profilattribute für KI.

Der Standardwert ist NULL.

Status des Profils.

Der Standardwert ist aktiviert.

description

Beschreibung für das AI-Profil.

Der Standardwert ist NULL.

annotations

Bietet zusätzliche Metadaten zu Datenbanktabellen und -spalten mit dem 23ai-Annotationsfeature.

Die gültigen Werte sind TRUE oder FALSE. Der Standardwert ist FALSE. Bei den Werten ist die Groß-/Kleinschreibung nicht zu beachten.

TRUE: Erweitert die Benutzereingabeaufforderung um Anmerkungen auf Tabellen- und Spaltenebene sowie um weitere Metadaten zum LLM.

FALSE: Enthält keine Annotationen als Teil der erweiterten Prompt-Metadaten.

azure_deployment_name

Name des bereitgestellten Azure OpenAI Service-Modells. 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 azure_deployment_name finden Sie unter Azure-Serviceressource OpenAI erstellen und bereitstellen.

azure_embedding_deployment_name

Name des bereitgestellten Einbettungsmodells von Azure OpenAI.

Der Name darf nur alphanumerische Zeichen, Unterstriche und Bindestriche enthalten. Der Name darf nicht mit einem Bindestrich oder Unterstrich beginnen oder enden.

azure_resource_name

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 azure_resource_name finden Sie unter Azure-Serviceressource OpenAI erstellen und bereitstellen.

case_sensitive_values

Gibt an, ob Select AI das LLM anweisen soll, SQL ohne Beachtung der Groß-/Kleinschreibung für Spalten zu generieren, die Zeichenfolgen- oder Textwerte enthalten.

Folgende Werte werden unterstützt:

Der Standardwert ist false.

comments

Enthält Tabellen- und Spaltenkommentare in den Metadaten, die zum Übersetzen von Eingabeaufforderungen in natürlicher Sprache mit KI verwendet werden. BOOLEAN-Datentyp wird unterstützt. Die gültigen Werte sind TRUE oder FALSE für eine Zeichenfolge mit dem Datentyp VARCHAR2. Bei den Werten ist die Groß-/Kleinschreibung nicht zu beachten.

constraints

Verwaltet, ob referenzielle Integritäts-Constraints wie Primär- und Fremdschlüssel in die an das LLM gesendeten Metadaten eingeschlossen werden sollen.

Die gültigen Werte sind TRUE oder FALSE. Der Standardwert ist FALSE. Bei den Werten ist die Groß-/Kleinschreibung nicht zu beachten.

TRUE: Enthält referenzielle Constraints in die erweiterten Prompt-Metadaten, die an das LLM gesendet werden.

FALSE: Enthält keine referenziellen Integritäts-Constraints.

conversation

Ein Attribut VARCHAR2, das angibt, ob die Unterhaltungshistorie für ein Profil aktiviert ist. Gültige Werte sind true oder false. Der Standardwert ist false. Bei den Werten muss nicht zwischen Groß- und Kleinschreibung unterschieden werden.

credential_name

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.

Vault-Secret-Zugangsdaten werden ebenfalls unterstützt.

Die Hauptauthentifizierung, z. B. der Azure-Service-Principal, wird ebenfalls unterstützt. Weitere Informationen zur Konfiguration finden Sie unter Azure Service Principal für den Zugriff auf Azure-Ressourcen verwenden.

Dies ist ein obligatorisches Attribut. Siehe Prozedur CREATE_CREDENTIAL.

embedding_model

Das im AI-Profil definierte Einbettungsmodell. Im Folgenden werden die unterstützten KI-Provider für die Einbettungsmodelle mit ihren Standardwerten aufgeführt:

enforce_object_list

Gibt an, ob das LLM auf die Generierung von SQL beschränkt werden soll, das nur Tabellen verwendet, die von der Objektliste abgedeckt werden.

Folgende Werte werden unterstützt:

• true: Erzwingt die Verwendung nur der Tabellen, die in der Objektliste angegeben sind.

• false: Ermöglicht dem LLM die Verwendung von Tabellen, auf die der Benutzer zugreifen kann.

Bei den Werten ist die Groß-/Kleinschreibung nicht zu beachten. Der Standardwert ist false.

max_tokens

Gibt die Anzahl der Token an, die pro Generation vorhergesagt werden sollen. Der Standardwert ist 1024. Weitere Informationen finden Sie unter Tokenizer.

model

Der Name des KI-Modells, mit dem Antworten generiert werden.

Siehe KI-Provider und LLMs auswählen, und geben Sie den Modellnamen an.

object_list

Array von JSON-Objekten, das Eigentümer- und Objektnamen angibt, die für die Übersetzung in 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.

Folgende Objekttypen können verwendet werden:

• Tabellen
• Ansichten
• Materialized Views
• Globale temporäre Tabellen
• Externe Tabellen
• Synonyme für die obigen Objekttypen

Bei der Übersetzung der natürlichen Sprache in SQL werden der Objektname, der Objekteigentümer, Objektspalten und Kommentare über HTTPS-Anforderungen an den AI-Provider gesendet. Vermeiden Sie die Angabe von Objekten mit sensiblem Objektnamen, Spaltennamen oder Kommentaren in der Objektliste.

KI-Provider haben möglicherweise Einschränkungen bei der Größe der Metadaten, die in Übersetzungsanforderungen zulässig sind. Beschränken Sie die Liste der Objekte, die für die Eingabeaufforderungen in natürlicher Sprache durch die Anwendungsbenutzer geeignet sind.

[
  {"owner": "SH", "name": "SALES",
  {"owner": "TEST_USER"}
]

Externe Tabellen, die mit der Synchronisierung von OCI Data Catalog oder AWS Glue erstellt wurden, können auch die Objektliste verwenden. Auf diese Weise können Sie Metadaten in zentralen Datenkatalogen verwalten und die Metadaten direkt für die Übersetzung von Eingabeaufforderungen in natürlicher Sprache mit KI verwenden.

object_list_mode

Gibt an, ob Metadaten für die relevantesten Tabellen oder alle Tabellen an das LLM gesendet werden sollen.

Unterstützte Werte sind:

• automated: Sendet Metadaten nur für die spezifischen Tabellen, die für die Abfrage am relevantesten sind.

• all: Sendet Metadaten für alle Tabellen, auf die der Benutzer zugreifen kann.

Wenn object_list_mode auf automated gesetzt ist, erstellt Select AI automatisch einen Vektorindex namens <profile_name>_OBJECT_LIST_VECINDEX mit Standardattributen. Siehe

oci_apiformat

Gibt das Format an, in dem die API erwartet, dass Daten gesendet und empfangen werden. Verwenden Sie dieses Attribut, um Textantworten zu generieren. Dieses Attribut gilt für OCI Generative AI-Chatmodelle in einem dedizierten KI-Cluster. Geben Sie dieses Attribut an, wenn Sie eine Modell-OCID im Attribut model angeben oder einen Endpunkt im Attribut oci_endpoint_id angeben.

oci_compartment_id

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 PDB.

oci_endpoint_id

Diese Attribute geben die Endpunkt-OCID des dedizierten KI-Hostingclusters von Oracle 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 gemeinsamen Infrastruktur On-Demand.

oci_runtimetype

Dieses Attribut gibt den Laufzeittyp des angegebenen Modells an. Dieses Attribut gilt für OCI Generate Text models in einem dedizierten KI-Cluster. Geben Sie dieses Attribut an, wenn Sie eine Modell-OCID im Attribut model angeben oder einen Endpunkt im Attribut oci_endpoint_id angeben.

Alle zulässigen Werte finden Sie in OCI Generative AI runtimeType. Siehe LlmInferenceRequest-Referenz.

provider

KI-Provider für das KI-Profil.

Unterstützte Provider

• openai
• Kohärenz
• azurblau
• Datenbank
• OCI
• google
• anthrop
• huggingface
• Aws

Dies ist ein obligatorisches Attribut.

provider_endpoint

Gibt den API-Endpunkt für OpenAI-kompatible Provider an. Dieses Attribut ist nur für OpenAI-kompatible Provider spezifisch. Geben Sie provider_endpoint als Attribut in der Prozedur DBMS_CLOUD_AI.CREATE_PROFILE anstelle des Attributs provider an. Unter OpenAI-kompatible Provider verwenden wird beschrieben, wie Sie den Parameter abrufen.

Beispiel: api.fireworks.ai/inference

region

Die Standardregion für AWS ist us-east-1.

Die Standardregion ist us-chicago-1.

stop_tokens

Der generierte Text wird am Anfang der frühesten Stoppsequenz beendet. Die Sequenz wird in den Text integriert. Der Attributwert muss ein gültiges Array von Zeichenfolgenwerten im JSON-Format sein. stop_tokens nimmt ein JSON-Array als Eingabe an. Weitere Informationen zu Stopptoken oder Stoppsequenzen finden Sie in der Dokumentation OpenAI oder Cohere.

temperature

Das Sampling von Generate Text-Modellen beinhaltet Zufälligkeit, so dass der gleiche Prompt bei jedem "Generate" verschiedene Ausgaben ergeben 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 Dienstleister.

vector_index_name

Name des Vektorindex. Der Vektorindexname muss den Benennungsregeln der Oracle SQL-ID entsprechen. Die maximale Länge des Vektorspeichernamens beträgt 125 Zeichen.

profile_name

Name des AI-Profils

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn kein AI-Profil vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

profile_name

Name für das zu aktivierende AI-Profil

Dieser Parameter ist obligatorisch.

profile_name

Name für das AI-Profil.

Dieser Parameter ist obligatorisch.

profile_name

Name des AI-Profils, für das Sie die Attribute festlegen möchten.

Dieser Parameter ist obligatorisch.

attribute_name

Name des AI-Profilattributs

Dieser Parameter ist obligatorisch.

attribute_value

Wert des Profilattributs. Der Wert kann den Typ BOOLEAN, CLOB, NUMBER oder VARCHAR2 aufweisen.

Der Standardwert ist NULL.

prompt

Eingabeaufforderung in natürlicher Sprache zum Übersetzen mit KI.

Die Eingabeaufforderung kann SELECT AI <action> als Präfix enthalten. Die Aktion kann auch separat als Parameter "action" bereitgestellt werden. Die in der Eingabeaufforderung angegebene action überschreibt den Parameter "action". Die Standardaktion ist showsql.

Dieser Parameter ist obligatorisch.

profile_name

Name des AI-Profils. Dieser Parameter ist optional, wenn in der Session bereits ein AI-Profil mit DBMS_CLOUD_AI.SET_PROFILE festgelegt ist.

Der Standardwert ist NULL.

EXEC DBMS_CLOUD_AI.set_profile('OPENAI');

-----------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'how many customers',
                              profile_name => 'OPENAI',
                              action       => 'runsql')
FROM dual;
-----------------------------------------------

SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'how many customers',
                              profile_name => 'OPENAI',
                              action       => 'showsql')
FROM dual;
-----------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'how many customers',
                              profile_name => 'OPENAI',
                              action       => 'explainsql')
FROM dual;
------------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'how many customers',
                              profile_name => 'OPENAI',
                              action       => 'narrate')
FROM dual;
-------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'what is oracle autonomous database',
                              profile_name => 'OPENAI',
                              action       => 'chat')
FROM dual;

Aktion zum Übersetzen natürlicher Eingabeaufforderungen mit KI. Die unterstützten Aktionen umfassen runsql (Standard), showsql, explainsql, narrate und chat. Beschreibungen der Aktionen sind in Eingabeaufforderungen mit KI-Schlüsselwort eingeben enthalten.

profile_name

Ein Name für das AI-Profil in der aktuellen Session.

Dieser Parameter ist obligatorisch.

profile_name

Das AI-Profil mit den erforderlichen LLM-Serviceinformationen. Dies kann mit der Prozedur CREATE_PROFILE erstellt werden.

object_name

• Die Berechtigungen SELECT und INSERT für die Tabellenobjekte sind für den Benutzer erforderlich, der sie verwendet.
• Die Tabelle ist entweder leer oder enthält Datensätze.

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.

Die Anzahl der Datensätze, die synthetisch generiert werden sollen.

user_prompt

Das Veröffentlichungsdatum für die Filme sollte 2019 sein

params

Optionale Attribute, die im JSON-Objektzeichenfolgenformat angegeben werden, um das Verhalten einer API zu ändern. Siehe Optionale Parameter.

object_list

sample_rows

Nummer

0 <= sample_rows <= 100

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 0.

table_statistics

Boolescher Wert

Aktivieren oder deaktivieren Sie die Verwendung von Tabellenstatistikinformationen.

Der Standardwert ist False.

priority

Zeichenfolge

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 HIGH.

• HIGH: Gibt die Anzahl der parallelen LLM-Anforderungen basierend auf der ECPU-Anzahl der Datenbank an (oder die OCPU-Anzahl, wenn Ihre Datenbank OCPUs verwendet).

• MEDIUM: Legt die Anzahl der nebenläufigen Prozesse gemäß dem Nebenläufigkeitslimit für den Medium-Service fest. Der Standardwert ist 4.

• LOW: Führt den Pipelinejob ohne parallele Verarbeitung in einer seriellen Reihenfolge aus.

Die maximale Anzahl gleichzeitiger paralleler Prozesse für die Generierung synthetischer Daten ist auf 64 begrenzt.

comments

Aktivieren oder deaktivieren Sie das Senden von Kommentaren an das LLM, um die Datengenerierung zu steuern.

Der Standardwert ist False.

index_name

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.

attributes

Benutzerdefinierte Attribute für den Vektorindex in JSON. Eine Liste der konfigurierbaren Parameter finden Sie unter Vektorindexattribute.

Der Standardwert ist NULL.

Der Standardwert ist Deaktiviert.

description

Beschreibung für den Vektorindex.

Der Standardwert ist NULL.

index_name

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.

include_data

Gibt an, ob sowohl der Vektorspeicher des Kunden als auch der Vektorindex zusammen mit dem Vektorindexobjekt gelöscht werden.

Mögliche Werte:

• TRUE
• FALSE

Der Standardwert ist TRUE.

Gibt an, ob Fehler ignoriert werden sollen, die auftreten, wenn der Vektorindex nicht vorhanden ist.

Mögliche Werte:

• TRUE
• FALSE

Wenn dieser Parameter auf TRUE gesetzt ist, werden alle Fehler umgangen, die auftreten, wenn der Vektorindex nicht vorhanden ist.

Der Standardwert ist FALSE.

index_name

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.

index_name

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.

index_name

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.

attribute_name

Name der benutzerdefinierten Attribute, die in der Prozedur CREATE_VECTOR_INDEX als JSON-Parameter angegeben sind.

Sie können die folgenden Attribute nicht ändern:

• location
• vector_table_name
• chunk_size
• chunk_overlap
• vector_distance_metric
• vector_dimension

Dies ist ein obligatorischer Parameter.

Vom Benutzer angegebener Wert für die benutzerdefinierte attribute_name. Der Wert kann den Typ CLOB, NUMBER oder VARCHAR2 aufweisen.

Der Standardwert ist NULL.