L'exemple suivant accorde le privilège EXECUTE pour le package DBMS_CLOUD_PIPELINE requis pour RAG :

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

Pour vérifier les privilèges accordés à un utilisateur pour les packages DBMS_CLOUD_AI et DBMS_CLOUD_PIPELINE, un administrateur peut exécuter les opérations suivantes :

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

Les paramètres sont les suivants :

• host : hôte, qui peut être le nom ou l'adresse IP de l'hôte. Vous pouvez utiliser un caractère générique pour spécifier un domaine ou un sous-réseau IP. Le nom d'hôte ou de domaine ne distingue pas les majuscules des minuscules.

  Fournisseur d'intelligence artificielle	Hôte
  OpenAI	api.openai.com
  Fournisseurs compatibles OpenAI	Par exemple, pour Fireworks AI, utilisez api.fireworks.ai
  Cohere	api.cohere.ai
  Service OpenAI Azure	<azure_resource_name>.openai.azure.com Pour en savoir plus sur azure_resource_name, reportez-vous à Attributs de profil.
  Google	generativelanguage.googleapis.com
  Anthropique	api.anthropic.com
  Visage en étreinte	api-inference.huggingface.co
  AWS	bedrock-runtime.us-east-1.amazonaws.com

• ace : entrées de contrôle d'accès (ACE). Le type XS$ACE_TYPE est fourni pour construire chaque entrée ACE pour l'ACL. Pour plus d'informations, reportez-vous à Création d'ACL et d'ACE.

L'exemple suivant crée des informations d'identification pour activer l'accès à OpenAI.

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

Les paramètres sont les suivants :

• credential_name : nom des informations d'identification à stocker. Le paramètre credential_name doit être conforme aux conventions de dénomination des objets Oracle.

• username : ensemble, les arguments username et password indiquent vos informations d'identification de fournisseur AI.

  username est un nom utilisateur spécifié par l'utilisateur.

• password : ensemble, les arguments username et password indiquent vos informations d'identification de fournisseur AI.

  password est la clé d'API secrète du fournisseur d'IA et dépend du fournisseur :

  Fournisseur d'intelligence artificielle	Clés d'API
  OpenAI	Reportez-vous à Utilisation de OpenAI pour obtenir vos clés d'API.
  Fournisseurs compatibles OpenAI	Reportez-vous à Utilisation des fournisseurs compatibles avec OpenAI pour obtenir vos clés d'API et provider_endpoint.
  Cohere	Reportez-vous à Utilisation de Cohere pour obtenir vos clés d'API.
  Service OpenAI Azure	Reportez-vous à Utilisation du service OpenAI Azure pour obtenir vos clés d'API et configurer le service. Remarque Si vous utilisez le principal de service OpenAI Azure pour vous authentifier, vous pouvez ignorer la procédure DBMS_CLOUD.CREATE_CREDENTIAL. Reportez-vous à Exemples d'utilisation de Select AI pour obtenir un exemple d'authentification à l'aide du principal de service OpenAI Azure.
  OCI Generative AI	Reportez-vous à Utilisation d'OCI Generative AI pour générer des clés de signature d'API.
  Google	Reportez-vous à Utilisation de Google pour générer vos clés d'API.
  Anthropique	Reportez-vous à Utilisation d'Anthropic pour générer vos clés d'API.
  Visage en étreinte	Reportez-vous à Utilisation de Hugging Face pour générer vos clés d'API.
  AWS	Reportez-vous à Utilisation d'AWS pour obtenir vos clés d'API et votre ID de modèle.

L'exemple suivant accorde des quotas sur le tablespace à ADB_USER pour utiliser Select AI avec RAG :

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

Pour vérifier le quota de tablespace accordé à un utilisateur, exécutez la commande suivante :

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

Les paramètres sont les suivants :

• TABLESPACE_NAME : tablespace auquel le quota est affecté. Dans Autonomous Database, les tablespaces sont gérés automatiquement et comportent le préfixe DATA.
• BYTES : quantité d'espace actuellement utilisée par l'utilisateur dans le tablespace.
• MAX_BYTES : quota maximal affecté (en octets). Si MAX_BYTES a la valeur -1, cela signifie que l'utilisateur dispose d'un quota illimité sur le tablespace. L'utilisateur de base de données qui crée l'index vectoriel doit avoir une taille MAX_BYTES suffisamment grande que les octets pour prendre en charge l'index vectoriel, ou MAX_BYTES doit avoir une taille -1 pour un quota illimité.

L'exemple suivant avec le fournisseur OpenAI crée un profil AI appelé OPENAI et définit le profil OPENAI pour la session utilisateur en cours.

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