L'esempio seguente concede il privilegio EXECUTE per il pacchetto DBMS_CLOUD_PIPELINE richiesto per l'aggregazione RAG:

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

Per controllare i privilegi concessi a un utente per i pacchetti DBMS_CLOUD_AI e DBMS_CLOUD_PIPELINE, un amministratore può eseguire quanto riportato di seguito.

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

Di seguito sono riportati i parametri disponibili.

• host: l'host, che può essere il nome o l'indirizzo IP dell'host. È possibile utilizzare un carattere jolly per specificare un dominio o una subnet IP. Il nome dell'host o del dominio non distingue tra maiuscole e minuscole.

  Provider AI	Host
  OpenAI	api.openai.com
  Cohere	api.cohere.ai
  Servizio OpenAI di Azure	<azure_resource_name>.openai.azure.com Per ulteriori informazioni su azure_resource_name, vedere Attributi profilo.
  Google	generativelanguage.googleapis.com
  Antropico	api.anthropic.com
  Viso Hugging	api-inference.huggingface.co

• ace: le voci di controllo dell'accesso (ACE). Il tipo XS$ACE_TYPE viene fornito per costruire ogni voce ACE per l'ACL. Per ulteriori dettagli, vedere Creazione di ACL e ACE.

Nell'esempio seguente viene creata una credenziale per abilitare l'accesso a OpenAI.

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

Di seguito sono riportati i parametri disponibili.

• credential_name: il nome della credenziale da memorizzare. Il parametro credential_name deve essere conforme alle convenzioni di denominazione degli oggetti Oracle.

• username: gli argomenti username e password specificano insieme le credenziali del provider AI.

  username è un nome utente specificato dall'utente.

• password: gli argomenti username e password specificano insieme le credenziali del provider AI.

  password è la chiave API segreta del provider AI e dipende dal provider:

  Provider AI	Chiavi API
  OpenAI	Vedere Utilizzare OpenAI per ottenere le chiavi API.
  Cohere	Consulta l'articolo sull'utilizzo di Cohere per ottenere le tue chiavi API.
  Servizio OpenAI di Azure	Vedere Usa servizio OpenAI di Azure per ottenere le chiavi API e configurare il servizio. Nota Se si utilizza il principal del servizio OpenAI di Azure per l'autenticazione, è possibile saltare la procedura DBMS_CLOUD.CREATE_CREDENTIAL. Per un esempio di autenticazione mediante il principal del servizio OpenAI di Azure, vedere Esempi di utilizzo di Select AI.
  AI generativa OCI	Vedere Usa AI generativa OCI per generare chiavi di firma API.
  Google	Vedere Usa Google per generare le chiavi API.
  Antropico	Vedere Usa Anthropic per generare le chiavi API.
  Viso Hugging	Per generare le chiavi API, vedere Usa interfaccia Hugging.

L'esempio riportato di seguito concede quote sulla tablespace a ADB_USER per utilizzare Select AI con RAG:

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

Per controllare la quota di tablespace concessa a un utente, eseguire le operazioni riportate di seguito.

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

Di seguito sono riportati i parametri disponibili.

• TABLESPACE_NAME: la tablespace alla quale è assegnata la quota. In Autonomous Database, le tablespace vengono gestite automaticamente e dispongono di DATA come prefisso.
• BYTES: la quantità di spazio attualmente utilizzata dall'utente nella tablespace.
• MAX_BYTES: la quota massima assegnata (in byte). Se MAX_BYTES è -1, significa che l'utente dispone di una quota illimitata sulla tablespace. L'utente del database che crea l'indice vettoriale deve avere MAX_BYTES sufficientemente più grande dei byte per contenere l'indice vettoriale oppure MAX_BYTES deve essere -1 per una quota illimitata.

L'esempio seguente con il provider OpenAI crea un profilo AI denominato OPENAI e imposta il profilo OPENAI per la sessione utente corrente.

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