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.

DBMS_CLOUD_AI - Überblick

Beschreibt die Verwendung des Packages DBMS_CLOUD_AI.

Verwenden Sie das Package DBMS_CLOUD_AI, um KI-Profile zu erstellen und für den Zugriff auf ein Large Language Model (LLM) zu konfigurieren. Legen Sie das AI-Profil in der aktuellen Datenbankbenutzersession fest, um Aufgaben wie das Generieren, Ausführen und Erläutern von SQL auszuführen. Ermöglichen Sie außerdem Retrieval Augmented Generation und Interaktionen in natürlicher Sprache, einschließlich des Chats mit LLMs.

Weitere Informationen zu unterstützten Plattformen und LLMs finden Sie unter Informationen zur ausgewählten KI.

Zusammenfassung der DBMS_CLOUD_AI-Unterprogramme

In diesem Abschnitt werden die DBMS_CLOUD_AI-Unterprogramme behandelt, die mit der autonomen KI-Datenbank bereitgestellt werden.

Unterprogramm Beschreibung

Prozedur CREATE_PROFILE

Mit dieser Prozedur wird ein neues AI-Profil zum Übersetzen von Eingabeaufforderungen in natürlicher Sprache in SQL-Anweisungen erstellt.

Profilattribute

Stellt AI-Profilattribute bereit, die Sie konfigurieren können.

Prozedur CLEAR_PROFILE

Bei dieser Prozedur wird ein aktives AI-Profil in der aktuellen Session gelöscht.

Prozedur DISABLE_PROFILE

Bei diesem Verfahren wird ein AI-Profil in der aktuellen Datenbank deaktiviert.

Prozedur DROP_PROFILE

Bei diesem Verfahren wird ein vorhandenes AI-Profil gelöscht.

Prozedur ENABLE_PROFILE

Mit dieser Prozedur kann ein AI-Profil in der aktuellen Datenbank verwendet werden.

Funktion GENERATE

Mit dieser Funktion können Sie Select AI zustandslos mit Ihrem vorhandenen Profil verwenden.

Funktion GENERATE_SYNTHETIC_DATA

Diese Funktion erzeugt synthetische Daten.

Funktion GET_PROFILE

Diese Funktion gibt den Profilnamen zurück, der in der aktuellen Session verwendet wird.

Prozedur SET_ATTRIBUTE

Diese Prozedur legt AI-Profilattribute fest.

Prozedur SET_PROFILE

Diese Prozedur legt das AI-Profil für die aktuelle Datenbank fest.

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.

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 feedback zum ersten Mal verwenden.

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 conversation_id abrufen.

Prozedur CLEAR_CONVERSATION_ID

Mit dieser Prozedur können Sie alle in der aktuellen Session festgelegten conversation_id löschen.

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.

Funktion SUMMARIZIEREN

Diese Funktion fasst Ihren Inhalt basierend auf den Parametern zusammen.

SUMMARIZIERUNGsparameter

Mit den zusammengefassten Attributen können Sie die Summengenerierung anpassen.

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.

Prozedur DROP_VECTOR_INDEX

Mit diesem Verfahren wird ein Vektorspeicherindex entfernt. Es entfernt normalerweise das Vektorspeicher-Indexobjekt und löscht die Vektordatenbank.

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, und das System lädt keine Daten in den Vektorspeicher.

Prozedur ENABLE_VECTOR_INDEX

Mit dieser Prozedur wird ein zuvor deaktiviertes Vektorindexobjekt aktiviert oder aktiviert.

Prozedur UPDATE_VECTOR_INDEX

Diese Prozedur aktualisiert einen vorhandenen Vektorspeicherindex mit einem angegebenen Wert des Vektorindexattributs.

Vektorindexattribute

Stellt Vektorindexprofilattribute bereit, die Sie konfigurieren können.

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

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

Status des Profils.

Der Standardwert ist aktiviert.

description

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'),
		status     => 'enabled',							 
          description     => 'AI profile to use OpenAI for SQL translation'
     );
END;
/

Profilattribute

Attribute eines AI-Profils helfen bei der Verwaltung und Konfiguration des Verhaltens des AI-Profils. Einige Attribute sind optional und haben einen Standardwert.

Attribute

Attributname Beschreibung

annotations

Bietet zusätzliche Metadaten zu Datenbanktabellen und -spalten mit dem 26ai-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:

  • true: Gibt an, dass das LLM SQL-Abfragen mit Zeichenfolgenwerten generiert, bei denen die Groß-/Kleinschreibung beachtet wird.

  • false: Gibt das LLM an, um SQL-Abfragen zu generieren, bei denen die Groß-/Kleinschreibung für Zeichenfolgenwerte ignoriert wird.

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 muss die Groß-/Kleinschreibung nicht beachtet werden.

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 die Groß-/Kleinschreibung nicht beachtet 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:

  • OCI GenAI: cohere.embed-english-v3.0
  • OpenAI: text-embedding-ada-002
  • Azure OpenAI: text-embedding-ada-002
  • Cohere: embed-english-v2.0
  • Google: text-embedding-004
Hinweis

  • Der Parameter embedding_model ist für Anthropic und Hugging Face nicht anwendbar.

  • Geben Sie bei datenbankinternen Modellen den in die Datenbank importierten Modellnamen an, wenn Sie Select AI mit datenbankinternem Transformer-Modell verwenden möchten. Sie können den Modellnamen abrufen, indem Sie USER_MINING_MODELS abfragen.

    Syntax:

    Die folgende Syntax dient zur Verwendung des datenbankinternen Transformatormodells für embedding_model:

    "embedding_model": "[<model_schema>.]<model_name>"

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.

Hinweis

  • Cohere: Kleinere, "leichte" Modelle sind schneller, während größere Modelle eine bessere Performance erzielen.Benutzerdefinierte Modelle können auch mit ihrer vollständigen ID bereitgestellt werden.
  • OCI Generative AI: Die Chatmodelle werden für alle Select AI-Aktionen unterstützt, wie runsql, showsql, explainsql, narrate und chat.

    Select AI unterstützt vortrainierte Modelle für OCI Generative AI. Benutzerdefinierte Modelle können auch mit ihren vollständigen OCIDs geliefert werden. Wenn Sie OCID oder oci_endpoint_id angeben, stellen Sie sicher, dass Sie je nach OCI-Chatmodellen entweder oci_runtimetype oder oci_apiformat angeben.

    Weitere Informationen zu unterstützten Modellen in OCI Generative AI finden Sie unter Pretrained Foundational Models in Generative AI.

  • Dieser Parameter wird nicht für Azure verwendet, da das Modell bestimmt wird, wenn Sie Ihr Deployment im Azure OpenAI Service-Portal erstellen.

  • AWS: Amazon Bedrock-Grundlagenmodelle erfordern Zugriffsberechtigungen über die Amazon Bedrock-Konsole. Weitere Informationen finden Sie in der AWS-Dokumentation unter modelID.
  • OpenAI-kompatibel: Die unterstützten Modellnamen finden Sie in der Dokumentation des AI-Providers.

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.

Format:
[
  {"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.

Unterstützte Werte sind:
  • COHERE
  • GENERIC
Hinweis

Verwenden Sie dieses Attribut für OCI Generative AI-Chatmodelle

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.

Folgende Werte werden unterstützt:
  • COHERE
  • LLAMA
Hinweis

Dieses Attribut ist veraltet. Verwenden Sie oci_apiformat.

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

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 Chicago, Frankfurt, London und anderen ausgewählten Regionen verfügbar. Weitere Informationen finden Sie unter Regionen mit generativer KI.

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.

source_language

Die Sprache des Eingabetextes, der zur Übersetzung an den Anbieter gesendet wird. Akzeptiert entweder den vollständigen Sprachnamen oder den Sprachcode (language_code), der von Providern unterstützt wird. Bei den Werten ist die Groß-/Kleinschreibung nicht zu beachten.

target_language

Die Sprache, in die der Anbieter den Text übersetzt. Akzeptiert entweder den vollständigen Sprachnamen oder den Sprachcode (language_code), der von Providern unterstützt wird. Bei den Werten ist die Groß-/Kleinschreibung nicht zu beachten.

Im folgenden Beispiel wird Cohere als Provider verwendet und benutzerdefinierte Profilattribute angezeigt:
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,
	 "source_language": "en",
	 "target_language": "french"
       }');
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_apiformat": "COHERE"            
       }');                                                                  
END;                                                                         
/ 

Prozedur CLEAR_PROFILE

Bei diesem Verfahren werden alle aktiven AI-Profile gelöscht, die in der aktuellen Session festgelegt wurden. Nachdem Sie ein aktives Profil gelöscht haben, können Sie SELECT AI nicht mehr in der SQL-Befehlszeile verwenden oder das festgelegte AI-Profil beim Aufrufen von DBMS_CLOUD_AI.GENERATE verwenden. Dieses Verfahren löscht das Profil nicht.

Syntax

DBMS_CLOUD_AI.CLEAR_PROFILE;

Beispiel


   BEGIN
        DBMS_CLOUD_AI.CLEAR_PROFILE;
   END;
   /

Prozedur DROP_PROFILE

Das Verfahren 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

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.

Beispiel

BEGIN
     DBMS_CLOUD_AI.DROP_PROFILE(profile_name => 'OPENAI');
END;
/

Hinweise zur Verwendung

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 AI-Profil, das der Benutzer angibt. Die Prozedur ändert den Status des AI-Profils in ENABLED.

Syntax

DBMS_CLOUD_AI.ENABLE_PROFILE(
     profile_name         IN   VARCHAR2
 );

Parameter

Parameter Beschreibung

profile_name

Name für das zu aktivierende AI-Profil

Dieser Parameter ist obligatorisch.

Beispiel zum Aktivieren des AI-Profils

BEGIN
     DBMS_CLOUD_AI.ENABLE_PROFILE(
         profile_name    => 'OPENAI'
     );
END;
/

Prozedur DISABLE_PROFILE

Mit dieser Prozedur wird das AI-Profil in der aktuellen Datenbank deaktiviert. Der Status des AI-Profils wird durch diese Prozedur in DISABLED geändert.

Syntax

DBMS_CLOUD_AI.DISABLE_PROFILE(
      profile_name  IN  VARCHAR2
);

Parameter

Parameter Beschreibung

profile_name

Name für das AI-Profil.

Dieser Parameter ist obligatorisch.

Beispiel

BEGIN
     DBMS_CLOUD_AI.DISABLE_PROFILE(
         profile_name    => 'OPENAI'
     );
END;
/

FEEDBACK-Verfahren

Mit diesem Verfahren können Sie Select AI Feedback geben, um die Genauigkeit der Abfragegenerierung zu verbessern. Sie können sowohl positives als auch negatives Feedback sowie Textkommentare und geänderte SQL-Abfragen abgeben.

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

profile_name

Gibt das zu verwendende AI-Profil an. Wenn Sie keine profile_name angeben, verwendet Select AI das in der Session festgelegte Standardprofil.

Dies ist ein obligatorischer Parameter.

sql_id

Gibt die SQL-Abfrage an. Eine sql_id kann nur einen Feedbackeintrag enthalten.

Dies ist ein obligatorischer Parameter.

sql_text

Enthält den vollständigen Text der SQL-Abfrage.

Dies ist ein obligatorischer Parameter.

feedback_type

Gibt den Feedbacktyp an. Die verfügbaren Werte sind:
  • positive: Akzeptieren Sie die generierte SQL.
  • negative: Geben Sie die erforderlichen SQL-Abfrageverbesserungen an, indem Sie Fehler in der Abfrage identifizieren.
Hinweis

Mit der Prozedur DBMS_CLOUD_AI.FEEDBACK können Sie sql_id oder sql_text angeben. Daher ist feedback_type erforderlich. Wenn Sie die Aktion feedback verwenden, bestimmt oder interpretiert das LLM den Feedbacktyp dynamisch.

Dies ist ein obligatorischer Parameter, wenn operation add ist.

response

Stellt das korrekte SQL-Abfrageergebnis dar, das der Benutzer erwartet.

Dies ist ein obligatorischer Parameter, wenn operation add und feedback_type negative ist.

feedback_content

Erfasst das Feedback des Benutzers in natürlicher Sprache. Sie können diesen Parameter zusammen mit response verwenden.

operation

Gibt die auszuführende Operation an. Folgende Werte werden akzeptiert:
  • add (Standard): Fügen Sie Ihr Feedback hinzu, indem Sie feedback_type angeben.
  • delete: Löschen Sie Ihr Feedback, indem Sie sql_id angeben

Beispiel

Beispiel: Feedback für die generierte SQL mit Hinzufüge- oder Löschvorgängen geben

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

Wählen Sie "KI" aus, um einen Standardvektorindex namens <profile_name>_FEEDBACK_VECINDEX mit Standardattributen zu erstellen, 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 match_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

attributes

Umfasst JSON-Objektattribute gemäß der FEEDBACK-Prozedur.

content

Enthält die Benutzereingabeaufforderung.

embedding

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)

Funktion GET_PROFILE

Diese Funktion gibt den AI-Profilnamen zurück, der in der aktuellen Session festgelegt wurde.

Syntax

DBMS_CLOUD_AI.GET_PROFILE
;

Beispiel

In diesem Beispiel wird gezeigt, wie Sie den Namen des Profils in der aktuellen Session anzeigen können.


   SELECT DBMS_CLOUD_AI.GET_PROFILE
   from DUAL;

Prozedur SET_ATTRIBUTE

Mit dieser Prozedur können Sie AI-Profilattribute festlegen. Es wird überladen, um Attributwerte verschiedener Typen zu akzeptieren.

Syntax

DBMS_CLOUD_AI.SET_ATTRIBUTE(
      profile_name         IN   VARCHAR2,
      attribute_name       IN   VARCHAR2,
      attribute_value      IN   {BOOLEAN|VARCHAR2}
);

DBMS_CLOUD_AI.SET_ATTRIBUTE(
      profile_name         IN   VARCHAR2,
      attribute_name       IN   VARCHAR2,
      attribute_value      IN   CLOB DEFAULT NULL
);

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

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.

Beispiele

BEGIN
 DBMS_CLOUD_AI.SET_ATTRIBUTE(
   profile_name    => 'OPENAI',
   attribute_name  => 'credential_name',
   attribute_value => 'OPENAI_CRED_NEW'
 );
END;
/

Im folgenden Beispiel wird der Typ NUMBER als attribute_value akzeptiert.

BEGIN
 DBMS_CLOUD_AI.SET_ATTRIBUTE(
   profile_name    => 'OCI_PROFILE',
   attribute_name  => 'temperature',
   attribute_value => 0.5
 );
END;
/

Im folgenden Beispiel wird der Typ BOOLEAN als attribute_value akzeptiert.

BEGIN
 DBMS_CLOUD_AI.SET_ATTRIBUTE(
   profile_name    => 'OCI_PROFILE',
   attribute_name  => 'comments',
   attribute_value => 'true'
 );
END;
/

Im folgenden Beispiel wird der Typ VARCHAR2 als attribute_value akzeptiert.

BEGIN
 DBMS_CLOUD_AI.SET_ATTRIBUTE(
   profile_name    => 'OCI_PROFILE',
   attribute_name  => 'model',
   attribute_value => 'meta.llama-3.3-70b-instruct'
 );
END;
/

Funktion GENERATE

Diese Funktion stellt eine AI-Übersetzung bereit, wenn eine zustandslose Datenbankverbindung verwendet wird. Mit Ihrem vorhandenen AI-Profil können Sie diese Funktion verwenden, um die unterstützten Aktionen auszuführen, wie showsql, runsql, explainsql, narrate, summarize und chat. 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,
    params            IN  CLOB
) RETURN CLOB;

Parameter

Parameter Beschreibung

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 im Prompt angegebene action setzt den Parameter action außer Kraft. 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.

Folgende Bedingungen gelten:
  • Wenn ein Profil in der aktuellen Session festgelegt ist, kann der Benutzer das Argument profile_name in der Funktion DBMS_CLOUD_AI.GENERATE weglassen.
  • Wenn das Argument profile_name in der Funktion DBMS_CLOUD_AI.GENERATE angegeben wird, setzt es alle Werte außer Kraft, die in der Session mit der Prozedur DBMS_CLOUD_AI.SET_PROFILE festgelegt wurden.
  • Wenn in der Session kein Profil mit der Prozedur DBMS_CLOUD_AI.SET_PROFILE festgelegt ist, muss das Argument profile_name in der Funktion DBMS_CLOUD_AI.GENERATE angegeben werden.
Hinweis

Bei Database Actions können Sie entweder das Argument profile_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.
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;
Weitere Informationen finden Sie unter SQL-Anweisungen im Codeeditor ausführen.
action
Aktion zum Übersetzen natürlicher Eingabeaufforderungen mit KI. Die unterstützten Aktionen umfassen:
  • runsql (Standard)

  • showsql

  • explainsql

  • narrate

  • summarize

  • translate

  • chat

Beschreibungen der Aktionen sind in Eingabeaufforderungen mit KI-Schlüsselwort eingeben enthalten.

attributes Überschreiben Sie bestimmte AI-Profilattribute, indem Sie Attribute im JSON-Format angeben. Weitere Informationen finden Sie unter Profilattribute.
params

Geben Sie Konversationsparameter an. Siehe CREATE_CONVERSATION Attribute. Sie können nur die folgenden Parameter angeben:

  • conversation_id: Der Standardwert ist die in der aktuellen Session festgelegte Unterhaltungs-ID. Dies ist kein erforderlicher Parameter.
  • conversation_length: Sie können den vorhandenen Wert in einen geeigneten Wert für Ihren Anwendungsfall ändern. Dies ist kein erforderlicher Parameter.

Beispiele

Beispiel: Funktion GENERATE für die Auswahl von KI-Aktionen verwenden

Die folgenden Beispiele veranschaulichen die Aktionen runsql, showsql, explainsql, narrate, summarize, translate und chat, die mit der Funktion DBMS_CLOUD_AI.GENERATE verwendet werden können. Weitere Informationen finden Sie auch unter Eingabeaufforderungen mit AI-Schlüsselwort eingeben.

Beispiel für die Aktion runsql:

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

Beispiel für die Aktion showsql:

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

Beispiel für die Aktion explainsql:

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

Beispiel für die Aktion narrate:

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

Beispiel für die Aktion chat:

SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'what is oracle autonomous database',
                              profile_name => 'OPENAI',
                              action       => 'chat')
FROM dual;
Beispiel für die Aktion summarize:
SELECT DBMS_CLOUD_AI.GENERATE(
                prompt => TO_CLOB(
                            DBMS_CLOUD.GET_OBJECT(
                             credential_name => 'STORE_CRED',
                             object_uri => 'https://objectstorage.ca-toronto-1.oraclecloud.com' ||
                                '/n/namespace-string/b/bucketname/o/data_folder/' ||
                                'summary/test_4000_words.txt')),
                profile_name => 'GENAI_LLAMA',
                action => 'SUMMARIZE')
from DUAL;

Ergebnis:

The music streaming industry, led by Spotify, has revolutionized the way
people consume music, with streaming accounting for 80% of the American
recording industry's revenue. However, this shift has also complicated the
lives of artists trying to survive in an on-demand, hyper-abundant present.
Spotify's business model, which pays royalties based on an artist's
popularity, has led to concerns about the fairness of the system, with some
artists earning little to no royalties. The company's dominance has also
changed the way people listen to music, with a focus on convenience and
personalized playlists. Liz Pelly's book, "Mood Machine: The Rise of Spotify
and the Costs of the Perfect Playlist," explores the impact of Spotify's rise
on the music industry and listeners, arguing that the platform's emphasis on
affect and mood has led to a homogenization of music and a loss of autonomy
for listeners. As the music industry continues to evolve, questions remain
about the future of music creation and consumption, and whether artists will
be able to thrive in a system that prioritizes convenience and profit over
artistic expression.

Die folgenden Beispiele zeigen die Aktion translate:

Die folgenden Beispiele zeigen die Verwendung der Aktion translate im Prompt.
Hinweis

Ihr KI-Profil muss die Zielsprache angeben.
SELECT DBMS_CLOUD_AI.GENERATE('select ai translate text to be translated')
          FROM dual;
   

Das folgende Beispiel zeigt die in der Funktion DBMS_CLOUD_AI.GENERATE bereitgestellte Aktion translate zusammen mit target_language und source_language. In diesem Beispiel wird generative KI-Übersetzung verwendet. Der Eingabetext this is a document in Englisch (source_language: "en") wird ins Französische (target_language: "fr") übersetzt.

DECLARE
         l_attributes  clob := '{"target_language": "fr", "source_language": "en"}';
         output clob;
      BEGIN
         output := DBMS_CLOUD_AI.GENERATE(
                        prompt            => 'this is a document',
                        profile_name      => 'oci_translate',
                        action            => 'translate',
                        attributes        => l_attributes
                     );
Funktion GENERATE in einer Prozedur verwenden

Sie können DBMS_CLOUD_AI.GENERATE in einer Prozedur verwenden und die Funktion ausführen. Im folgenden Beispiel werden ai_prompt, profile_name und action als Eingabeparameter verwendet und DBMS_CLOUD_AI.GENERATE aufgerufen.

create or replace FUNCTION call_select_ai (ai_prompt  IN VARCHAR2, 
                                           ai_profile IN VARCHAR2,
                                           ai_action  IN VARCHAR2) -- valid for 'chat', 'narrate', 'showsql'
                                           RETURN CLOB AS sai_resp clob;
BEGIN
  sai_resp := DBMS_CLOUD_AI.GENERATE(prompt       => ai_prompt,
                                     profile_name => ai_profile,
                                     action       => ai_action);  
  return(sai_resp);
END call_select_ai;
Beispiel: Funktion GENERATE für Unterhaltungen verwenden

Das folgende Beispiel zeigt, wie Sie die Funktion DBMS_CLOUD_AI.GENERATE in einer Unterhaltungseinstellung verwenden. In diesem Beispiel wird davon ausgegangen, dass bereits eine Unterhaltung erstellt wurde.

SELECT DBMS_CLOUD_AI.GENERATE(
        prompt       =>  'What is the difference in weather between Seattle and San Francisco?',
        profile_name =>  'GENAI',
        action       =>  'CHAT',
        params       =>  '{"conversation_id":"30C9DB6E-EA4D-AFBA-E063-9C6D46644B92"}') AS RESPONSE;

Ergebnis:

RESPONSE
--------------------------------------------------------------------------------
Seattle and San Francisco, both located in the Pacific Northwest and Northern 
California respectively, experience a mild oceanic climate. However, there are 
some notable differences in their weather patterns:
 
1. **Temperature**: San Francisco tends to be slightly warmer than Seattle, 
especially during the summer months. San Francisco's average temperature ranges 
from 45?F (7?C) in winter to 67?F (19?C) in summer, while Seattle's average 
temperature ranges from 38?F (3?C) in winter to 64?F (18?C) in summer.
 
2. **Rainfall**: Seattle is known for its rainy reputation, with an average 
annual rainfall of around 37 inches (94 cm). San Francisco receives less rainfall, 
with an average of around 20 inches (51 cm) per year. However, San Francisco's 
rainfall is more concentrated during the winter months, while Seattle's rainfall 
is more evenly distributed throughout the year.
 
......

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 Prompt in natürlicher Sprache betrachtet. Je nachdem, welche Aktion Sie mit dem Präfix AI angeben, wird eine Antwort mit AI generiert. Informationen zur Verwendung des Präfixes AI finden Sie unter Beispiele für die Verwendung von Select AI und AI-Schlüsselwort zum Eingeben 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.

Syntax

DBMS_CLOUD_AI.SET_PROFILE(
    profile_name      IN  VARCHAR2,
);

Parameter

Parameter Beschreibung

profile_name

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

Dieser Parameter ist obligatorisch.

Beispiel


   BEGIN
        DBMS_CLOUD_AI.SET_PROFILE(
          profile_name    => 'OPENAI'
        );
   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 Prozedur DBMS_CLOUD_AI.CREATE_COVERSATION verwenden, können Sie die Einstellung von conversation_id überspringen, da sie von der Prozedur automatisch festgelegt wird.

Syntax

DBMS_CLOUD_AI.CREATE_COVERSATION(
  attributes            IN CLOB DEFAULT NULL
);

Parameter

Parameter Beschreibung

attributes

Attribute für Unterhaltung im JSON-Format. Weitere Informationen finden Sie unter CREATE_CONVERSATION Attribute.

Der Standardwert ist NULL.

Beispiel

Beispiel: Unterhaltung erstellen

Das folgende Beispiel zeigt das Erstellen einer Unterhaltung ohne Anpassung.

EXEC DBMS_CLOUD_AI.CREATE_COVERSATION;

Ergebnis:

PL/SQL procedure successfully completed.
Beispiel: Unterhaltung mit benutzerdefinierten Attributen erstellen

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_COVERSATION(
               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 Prozedur DBMS_CLOUD_AI.CREATE_COVERSATION verwenden, können Sie die Einstellung von conversation_id überspringen, da sie von der Prozedur automatisch festgelegt wird.

Syntax

DBMS_CLOUD_AI.CREATE_COVERSATION(
  attributes            IN CLOB DEFAULT NULL
) RETURN VARCHAR2;

Parameter

Parameter Beschreibung

attributes

Attribute für Unterhaltung im JSON-Format. Weitere Informationen finden Sie unter CREATE_CONVERSATION Attribute.

Der Standardwert ist NULL.

Beispiel

Beispiel: Unterhaltung erstellen

Das folgende Beispiel zeigt, wie Sie mit der Funktion DBMS_CLOUD_AI.CREATE_COVERSATION eine Unterhaltung ohne Anpassung erstellen.

SELECT DBMS_CLOUD_AI.CREATE_COVERSATION FROM DUAL;

Ergebnis:

CREATE_CONVERSATION
------------------------------------
30C9DB6E-EA4D-AFBA-E063-9C6D46644B92
Beispiel: Unterhaltung mit benutzerdefinierten Attributen erstellen

Das folgende Beispiel zeigt, wie Sie mit der Funktion DBMS_CLOUD_AI.CREATE_COVERSATION Attribute wie title, retention_days und conversation_length angeben.

SELECT DBMS_CLOUD_AI.CREATE_COVERSATION(
				attributes => '{"title":"This is a test conversation",
                               "retention_days":7,
                               "conversation_length":20}') 
FROM DUAL;

CREATE_CONVERSATION-Attribute

Diese Attribute verwalten den Konversationskontext, einschließlich der Aufbewahrungsdauer, der Anzahl der Prompts mit Antworten zum Speichern oder Anzeigen sowie Metadaten wie Titel und Beschreibung zur Referenz. Einige Attribute sind optional und haben einen Standardwert.

Attribute

Attributname Standardwert Beschreibung

title

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.

description

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.

retention_days

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 DBMS_CLOUD_AI.DROP_CONVERSATION oder DBMS_CLOUD.DELETE_ALL_OPERATIONS('CONVERSATION') manuell löschen.

conversation_length

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:
  1. Wert aus dem Attributargument in DBMS_CLOUD_AI.GENERATE
  2. Der in der Unterhaltung festgelegte Wert hat die nächste Priorität
  3. Der im KI-Profil definierte Wert hat die letzte Priorität

Wenn keiner von ihnen die conversation_length angibt, ist der Standardwert 10.

Das folgende Beispiel zeigt, wie Sie Unterhaltungsattribute in der Prozedur 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

conversation_id

Eindeutige Nummer, die einer Unterhaltung zugewiesen ist.

Dies ist ein obligatorischer Parameter.

attributes

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

conversation_id

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

Diese Funktion gibt die derzeit in der Session festgelegte Unterhaltungs-ID zurück, die entweder die Prozedur DBMS_CLOUD_AI.SET_CONVERSATION_ID oder DBMS_CLOUS_AI.CREATE_CONVERSATION verwendet. Wenn Sie keine Unterhaltung festgelegt haben, gibt die Funktion NULL zurück. Wenn Sie die Unterhaltung löschen, löscht das System sie in der Session als well.See 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-9C6D46644B92

Prozedur 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

conversation_prompt_id

Eindeutige Nummer, die einer Eingabeaufforderung in einer Konversation zugewiesen ist. Sie können die Prompt-ID suchen, indem Sie die View DBA/USER_CLOUD_AI_CONVERSATION_PROMPTS abfragen. Siehe DBMS_CLOUD_AI Ansichten.

Dies ist ein obligatorischer Parameter.

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn conversation_prompt_id nicht vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

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

conversation_id

Eindeutige Nummer, die einer Unterhaltung zugewiesen ist.

Dies ist ein obligatorischer Parameter.

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn conversation_id nicht vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

Beispiel

EXEC DBMS_CLOUD_AI.DROP_CONVERSATION('30C9DB6E-EA4D-AFBA-E063-9C6D46644B92');

Ergebnis:

PL/SQL procedure successfully completed.

Funktion SUMMARIZIEREN

Diese Funktion fasst Ihren Inhalt basierend auf den Anpassungsoptionen zusammen, die Sie als Parameter angeben.

Syntax

DBMS_CLOUD_AI.SUMMARIZE(
  content         IN  CLOB     DEFAULT NULL,
  credential_name IN  VARCHAR2 DEFAULT NULL,
  location_uri    IN  VARCHAR2 DEFAULT NULL,
  profile_name    IN  VARCHAR2 DEFAULT NULL,
  user_prompt     IN  CLOB     DEFAULT NULL,
  params          IN  CLOB     DEFAULT NULL
) RETURN CLOB;

Parameter

Parameter Beschreibung

content

Gibt den Text an, den Sie zusammenfassen möchten. Entweder content oder location_uri muss angegeben werden.

Dies ist kein erforderlicher Parameter.

credential_name

Identifiziert das Zugangsdatenobjekt, das zur Authentifizierung mit dem Objektspeicher verwendet wird. Sie müssen diese Zugangsdaten mit DBMS_CLOUD.CREATE_CREDENTIAL erstellen.
Hinweis

Verwenden Sie diesen Parameter nur, wenn Sie location_uri angeben.

location_uri

Liefert die URI, in der der Text gespeichert ist, oder den Pfad zu einer lokalen Datei. Entweder content oder location_uri muss angegeben werden.

Beispiel:

Objektspeicher: https://objectstorage.ca-toronto-1.oraclecloud.com/n/namespace-string/b/bucketname/o/data_folder/summary/test_file.txt

Lokale Datei: summary_gobject:test_file.txt

profile_name

Gibt das zu verwendende AI-Profil an. Wenn Sie keine profile_name angeben, verwendet Select AI das in der Session festgelegte Standardprofil. Wenn kein Standardprofil festgelegt ist, wird der Fehler zurückgegeben: ORA-20046: AI-Profil ist in der Session nicht aktiviert.

Der Standardwert ist NULL.

user_prompt

Stellt eine Eingabeaufforderung in natürlicher Sprache bereit, um die Zusammenfassung zu leiten oder anzupassen. Sie können zusätzliche Anweisungen über Übersichtsparameter hinaus aufnehmen.

Beispiel: Die Zusammenfassung muss mit "Zusammenfassung des Artikels" beginnen: "''

Dieser Parameter ist nicht obligatorisch.

params

Definiert Zusammenfassungsparameter. Siehe Parameter SUMMARIZE.

Beispiel

Weitere Informationen finden Sie unter Beispiel: AI Summarize auswählen.

SUMMARIZIERUNGsparameter

Diese Attribute verwalten die Generierung einer Übersicht mit benutzerdefinierten Parametern. Einige Attribute sind optional und haben einen Standardwert.

Attribute

Attributname Standardwert Beschreibung

min_words

0

Gibt die ungefähre Mindestanzahl von Wörtern an, die von der generierten Übersicht erwartet werden.

Hinweis

Dieser Parameter fungiert als Richtlinie und nicht als strenger Grenzwert: Die tatsächliche Länge der Zusammenfassung kann je nach bereitgestelltem Inhalt und der Interpretation des Modells variieren.

max_words

200

Gibt die ungefähre maximale Anzahl von Wörtern an, die von der generierten Übersicht erwartet werden.
Hinweis

Dieser Parameter fungiert als Richtlinie und nicht als strenger Grenzwert. Die tatsächliche Länge der Zusammenfassung kann je nach bereitgestelltem Inhalt und Interpretation des Modells variieren.

summary_style

Absatz
Gibt den Formatstil für die Zusammenfassung an. Folgende Übersichtsformatoptionen sind verfügbar:
  • paragraph: Die Zusammenfassung wird in einem oder mehreren Absätzen dargestellt.
  • list: Die Zusammenfassung ist eine Liste der Schlüsselpunkte aus dem Text.

chunk_processing_method

map_reduce
Wenn der Text das Tokenlimit überschreitet, das das LLM verarbeiten kann, muss er in verwaltbare Chunks aufgeteilt werden. Mit diesem Parameter können Sie die Methode für die Verarbeitung dieser Blöcke auswählen. Folgende Optionen werden bereitgestellt:

extractiveness_level

low Bestimmt, wie eng die Zusammenfassung dem ursprünglichen Wortlaut der Eingabe folgt. Es steuert, inwieweit das Modell es extrahiert oder umformuliert. Im Folgenden werden die Optionen aufgeführt:
  • High: Die Zusammenfassung bleibt in der Nähe der ursprünglichen Formulierung und verwendet nach Möglichkeit Sätze und Ausdrücke wieder.
  • Medium: Eine ausgewogene Mischung aus Extraktion und Paraphrasierung.
  • Low: Ermöglicht mehr Freiheit, die Eingabe neu zu formulieren, neu zu strukturieren oder zu vereinfachen, wobei der Schwerpunkt auf der Bedeutung und nicht auf der genauen Formulierung liegt.
Hinweis

Diese Einstellung dient als Richtlinie für das Zusammenfassungsverhalten des Modells. Sie erzwingt keine strikte Regel. Der tatsächliche Stil und der Wortlaut der Zusammenfassung können je nach Eingabeinhalt und Modellentscheidungen variieren.

TRANSLATE-Funktion

Mit dieser Funktion können Sie Ihren Text in die angegebene target_language übersetzen.

Sie können die Parameter source_language und target_language in der Funktion angeben oder sie aus dem AI-Profil des Benutzers übernehmen. Wenn Ihr KI-Profil kein source_language-Attribut enthält, erkennt der generative KI-Provider automatisch die Eingabesprache. Wenn das Attribut target_language fehlt, gibt Select AI einen Fehler zurück.

Syntax

DBMS_CLOUD_AI.TRANSLATE(
   profile_name      IN VARCHAR2,
   text              IN CLOB,
   source_language   IN VARCHAR2 DEFAULT NULL,
   target_language   IN VARCHAR2 DEFAULT NULL
) RETURN CLOB;

Parameter

Parameter Beschreibung

profile_name

Gibt das zu verwendende AI-Profil an.

Dies ist kein erforderlicher Parameter.

text

Gibt den Text an, den Sie übersetzen möchten.

Dies ist ein obligatorischer Parameter.

source_language

Sprache des Eingabetextes

target_language

Sprache, in die der Text übersetzt wird.

Beispiel

Weitere Informationen finden Sie unter Beispiel: AI Translate auswählen.

Funktion GENERATE_SYNTHETIC_DATA

Mit dieser Prozedur können Sie synthetische Daten für eine einzelne Tabelle, mehrere Tabellen oder ein vollständiges Schema generieren.

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 Erforderlich Beschreibung

profile_name

Ja

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

object_name

Ja Geben Sie einen Tabellennamen an, um synthetische Daten aufzufüllen.
  • 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.
owner_name Nein

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 Nein

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

user_prompt

Nein 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

params

Nein

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

object_list

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 Werte

Parameter Wertdatentyp Wert Beschreibung

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

  • True
  • False

Aktivieren oder deaktivieren Sie die Verwendung von Tabellenstatistikinformationen.

Der Standardwert ist False.

priority

Zeichenfolge

Gültige Werte:

  • HIGH
  • MEDIUM
  • LOW

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

Boolescher Wert
  • True
  • False

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

Der Standardwert ist False.

object_list-Parameter

Parameter Wertdatentyp Erforderlich Beschreibung

owner

Zeichenfolge

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.

name

Zeichenfolge

Nein

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.

record_count

Nummer

Nein

Die Anzahl der Datensätze, die synthetisch generiert werden sollen. Bitte geben Sie eine Zahl größer als 0 an.

Geben Sie record_count oder record_count_percentage an.

record_count_percentage

Nummer

Nein

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 record_count_percentage unterstützt.

Geben Sie record_count oder record_count_percentage an.

Wenn Sie den Parameter record_count_percentage verwenden, wird die endgültige Datensatzanzahl in der Tabelle wie folgt berechnet:
Original_Num_Rows *
      record_count_percentage

user_prompt

Zeichenfolge Nein 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 unter Beispiel: Synthetische Daten generieren.

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

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.

status
Status des Vektorindex. Mögliche Werte sind:
  • Enabled
  • Disabled

Der Standardwert ist Deaktiviert.

description

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

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.

force

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.

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

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.

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

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.

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

Diese Prozedur aktualisiert einen vorhandenen Vektorspeicherindex mit einem angegebenen Wert des Vektorindexattributs. Es wird überladen, um Attributwerte verschiedener Typen zu akzeptieren.

Syntax

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

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.

attribute_value

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

Der Standardwert ist NULL.

Beispiel

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;                                                                 
/

Vektorindexattribute

Mit den Attributen eines Vektorindex können Sie das Verhalten des Vektorindex verwalten und konfigurieren. Sie können nach Bedarf benutzerdefinierte Indexattribute hinzufügen. Einige Attribute sind optional und haben einen Standardwert.

Attribute

Attributname Wert Erforderlich Beschreibung
chunk_size 1024 (Standard) Nein

Textgröße für das Blockieren der Eingabedaten.

Bei Textdaten bedeutet dies die Anzahl der Zeichen.

chunk_overlap 128 (Standard) Nein

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.

location

NA 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 "*" kann als Platzhalter für mehrere Zeichen verwendet werden. Das Zeichen "?" kann als Platzhalter für ein einzelnes Zeichen verwendet werden.

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

Verzeichnis:

Sie können ein Verzeichnis und einen Dateinamen angeben. Das Format für die Angabe eines Verzeichnisses lautet: MY_DIR:filename.ext. Standardmäßig ist der Verzeichnisname MY_DIR ein Datenbankobjekt, bei dem die Groß-/Kleinschreibung nicht beachtet wird. Beim Dateinamen muss die Groß-/Kleinschreibung beachtet werden.

Sie können nur Platzhalter verwenden, um Dateinamen in einem Verzeichnis anzugeben. Das Zeichen * kann als Platzhalter für mehrere Zeichen verwendet werden, und das Zeichen ? kann als Platzhalter für ein einzelnes Zeichen verwendet werden. Beispiel: MY_DIR:* oder MY_DIR:test?.

Verwenden Sie doppelte Anführungszeichen, um einen Verzeichnisnamen anzugeben, bei dem die Groß-/Kleinschreibung beachtet wird. Beispiel: "my_dir1":*, "my_dir2":Test?

Um ein Anführungszeichen einzuschließen, verwenden Sie zwei Anführungszeichen. Beispiel: MY_DIR:''filename.ext. Gibt an, dass der Dateiname mit einem Anführungszeichen (') beginnt.

Die Dateien an diesem Speicherort können Dokumente in Formaten wie PDF, DOC, JSON, XML oder HTML sein. Siehe Unterstützte Dokumentformate.

match_limit

5 (Standard) Nein

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.

object_storage_credential_name

NA Ja

Gibt den Namen der Zugangsdaten für den Zugriff auf einen Objektspeicher an.

pipeline_name

<vector_index_name>$VECPIPELINE Nein

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.

profile_name

NA Ja

Name des AI-Profils, das zum Einbetten von Quelldaten und Benutzer-Prompts verwendet wird.

refresh_rate

1440 Minuten (Standard) Nein

Intervall für die Aktualisierung von Daten im Vektorspeicher. Die Einheit ist Minuten.

similarity_threshold

0 (Standard) Nein

Definiert die minimale Ähnlichkeitsebene, die erforderlich ist, damit zwei Elemente als Übereinstimmung betrachtet werden. Dies ist nützlich, um Ergebnisse in Übereinstimmungsalgorithmen zu filtern, um die Relevanz sicherzustellen.

vector_distance_metric

Eine Zeichenfolge, die einem der in der Beschreibung angegebenen Werte entspricht.

Nein

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:

  • EUCLIDEAN
  • L2_SQUARED (EUCLIDEAN_SQUARED)
  • COSINE (Standard)
  • DOT
  • MANHATTAN
  • HAMMING

vector_db_provider

oracle

Ja

Gibt den Providernamen an, der als Vektorspeicher verwaltet und dient.

vector_dimension

NA Nein

Gibt die Anzahl der Elemente in jedem Vektor innerhalb des Vektorspeichers an und definiert die Größe und Struktur der Datendarstellung.

vector_table_name

<vector_index_name>$VECTAB (Standard)

Nein

Gibt den Namen der Tabelle oder Sammlung an, in der Vektoreinbettungen und Blockdaten gespeichert werden.

Beispiel: Objektspeicher-URI-Speicherort angeben
Das folgende Beispiel zeigt, wie Sie einen Vektorindex mit dem OCI Generative AI-Vektorspeicher erstellen.
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;
/                                                                 
/
Beispiel: Geben Sie den Speicherort der Object Storage-URI mit einem Platzhaltermuster an

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;                                                                
/
Beispiel: Verzeichnisobjektspeicherort mit Platzhaltermuster angeben

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;                                                                
/
Beispiel: Speicherort des Directory-Objekts mit Platzhaltermuster angeben

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;                                                                
/
Beispiel: Geben Sie das Directory-Objekt mit Groß-/Kleinschreibung und allen Dateien als Platzhaltermuster an

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;                                                                
/
Beispiel: Dateinamenübereinstimmung im Directory-Objekt angeben

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;                                                                
/