Das folgende Beispiel erteilt die Berechtigung EXECUTE für das Package DBMS_CLOUD_PIPELINE, das für RAG erforderlich ist:

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

Um die Berechtigungen zu prüfen, die einem Benutzer für die Packages DBMS_CLOUD_AI und DBMS_CLOUD_PIPELINE erteilt wurden, kann ein Administrator Folgendes ausführen:

SELECT table_name AS package_name, privilege 
 FROM DBA_TAB_PRIVS 
 WHERE grantee = '<username>'
 AND   (table_name = 'DBMS_CLOUD_PIPELINE'
        OR table_name = 'DBMS_CLOUD_AI');

BEGIN  
    DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
         host => 'api.openai.com',
         ace  => xs$ace_type(privilege_list => xs$name_list('http'),
                             principal_name => 'ADB_USER',
                             principal_type => xs_acl.ptype_db)
   );
END;
/

Parameter:

• host: Der Host. Dabei kann es sich um den Namen oder die IP-Adresse des Hosts handeln. Sie können einen Platzhalter verwenden, um eine Domain oder ein IP-Subnetz anzugeben. Beim Host- oder Domainnamen ist die Groß-/Kleinschreibung nicht zu beachten.

  KI-Provider	Host
  OpenAI	api.openai.com
  Cohere	api.cohere.ai
  Azure OpenAI-Service	<azure_resource_name>.openai.azure.com Weitere Informationen zu azure_resource_name finden Sie unter Profilattribute.
  Google	generativelanguage.googleapis.com
  Anthropisch	api.anthropic.com
  Umarmendes Gesicht	api-inference.huggingface.co

• ace: Die Access Control-Einträge (ACE). Der Typ XS$ACE_TYPE wird angegeben, um jeden ACE-Eintrag für die ACL zu erstellen. Weitere Details finden Sie unter ACLs und ACEs erstellen.

Im folgenden Beispiel werden Zugangsdaten erstellt, um den Zugriff auf OpenAI zu ermöglichen.

EXEC 
DBMS_CLOUD.CREATE_CREDENTIAL(
credential_name   => 'OPENAI_CRED', 
username          =>  'OPENAI', 
password          =>  '<your_api_token>');

Parameter:

• credential_name: Der Name der zu speichernden Zugangsdaten. Der Parameter credential_name muss den Benennungskonventionen für Oracle-Objekte entsprechen.

• username: Mit den Argumenten username und password werden Ihre Zugangsdaten für AI-Provider angegeben.

  username ist ein benutzerdefinierter Benutzername.

• password: Mit den Argumenten username und password werden Ihre Zugangsdaten für AI-Provider angegeben.

  password ist der Secret-API-Schlüssel Ihres KI-Providers und hängt vom Provider ab:

  KI-Provider	API-Schlüssel
  OpenAI	Informationen zum Abrufen der API-Schlüssel finden Sie unter Verwenden Sie OpenAI.
  Cohere	Informationen zum Abrufen Ihrer API-Schlüssel finden Sie unter Cohere verwenden.
  Azure OpenAI-Service	Informationen zum Abrufen der API-Schlüssel und zum Konfigurieren des Service finden Sie unter Azure-Service OpenAI verwenden. Hinweis Wenn Sie den Azure-Service-Principal OpenAI zur Authentifizierung verwenden, können Sie die Prozedur DBMS_CLOUD.CREATE_CREDENTIAL überspringen. Ein Beispiel für die Authentifizierung mit dem Azure-Service-Principal OpenAI finden Sie unter Beispiele für die Verwendung von Select AI.
  OCI Generative AI	Siehe OCI Generative AI verwenden, um API-Signaturschlüssel zu generieren.
  Google	Informationen zum Generieren Ihrer API-Schlüssel finden Sie unter Google verwenden.
  Anthropisch	Informationen zum Generieren Ihrer API-Schlüssel finden Sie unter Anthropic verwenden.
  Umarmendes Gesicht	Informationen zum Generieren Ihrer API-Schlüssel finden Sie unter Hugging Face verwenden.

Das folgende Beispiel erteilt der ADB_USER Quota für den Tablespace, um Select AI mit RAG zu verwenden:

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

Um die Tablespace Quota zu prüfen, die einem Benutzer erteilt wurde, führen Sie folgenden Befehl aus:

SELECT TABLESPACE_NAME, BYTES, MAX_BYTES 
FROM DBA_TS_QUOTAS 
WHERE USERNAME = '<username>' AND
      TABLESPACE_NAME LIKE 'DATA%';

Parameter:

• TABLESPACE_NAME: Der Tablespace, dem die Quota zugewiesen ist. In Autonomous Database werden Tablespaces automatisch verwaltet und haben DATA als Präfix.
• BYTES: Der Speicherplatz, der derzeit vom Benutzer im Tablespace belegt wird.
• MAX_BYTES: Die maximal zugewiesene Quota (in Byte). Wenn MAX_BYTES -1 ist, bedeutet dies, dass der Benutzer eine unbegrenzte Quota für den Tablespace hat. Der Datenbankbenutzer, der den Vektorindex erstellt, muss MAX_BYTES ausreichend größer als Byte haben, um den Vektorindex aufzunehmen, oder MAX_BYTES muss -1 für eine unbegrenzte Quota sein.

Im folgenden Beispiel mit dem OpenAI-Provider wird ein AI-Profil mit dem Namen OPENAI erstellt und das OPENAI-Profil für die aktuelle Benutzersession festgelegt.

-- Create AI profile
--BEGIN
  DBMS_CLOUD_AI.CREATE_PROFILE(
  profile_name   => 'OPENAI',
  attributes     =>'{"provider": "openai",
			"credential_name": "OPENAI_CRED",
			"object_list": [{"owner": "SH", "name": "customers"},
					  {"owner": "SH", "name": "sales"},
					  {"owner": "SH", "name": "products"},
					  {"owner": "SH", "name": "countries"}]
       }');
END;
/
 
PL/SQL procedure successfully completed.
 
--
-- Enable AI profile in current session
--
EXEC DBMS_CLOUD_AI.set_profile('OPENAI');
 
PL/SQL procedure successfully completed.