次の例では、RAGに必要なDBMS_CLOUD_PIPELINEパッケージに対するEXECUTE権限を付与します。

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

DBMS_CLOUD_AIおよびDBMS_CLOUD_PIPELINEパッケージについてユーザーに付与された権限をチェックするために、管理者は次を実行できます。

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

パラメータは次のとおりです:

• host: ホスト。ホストには、ホストの名前またはIPアドレスを指定できます。ワイルドカードを使用して、ドメインまたはIPサブネットを指定できます。ホストまたはドメイン名は大/小文字が区別されません。

  AIプロバイダ	ホスト
  OpenAI	api.openai.com
  OpenAI互換プロバイダ	たとえば、Fireworks AIの場合は、api.fireworks.aiを使用します
  Cohere	api.cohere.ai
  Azure OpenAIサービス	<azure_resource_name>.openai.azure.com azure_resource_nameの詳細は、「プロファイル属性」を参照してください。
  Google	generativelanguage.googleapis.com
  人類学	api.anthropic.com
  ハギング面	api-inference.huggingface.co
  AWS	bedrock-runtime.us-east-1.amazonaws.com

• ace: アクセス制御エントリ(ACE)。ACLの各ACEエントリを作成するために、XS$ACE_TYPEタイプが提供されています。詳細は、Creating ACLs and ACEsを参照してください。

次の例では、OpenAIへのアクセスを有効にする資格証明を作成します。

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

パラメータは次のとおりです:

• credential_name: 格納する資格証明の名前。credential_nameパラメータは、Oracleオブジェクトのネーミング規則に準拠している必要があります。

• username: username引数とpassword引数の両方で、AIプロバイダの資格証明を指定します。

  usernameは、ユーザー指定のユーザー名です。

• password: username引数とpassword引数の両方で、AIプロバイダの資格証明を指定します。

  passwordはAIプロバイダのシークレットAPIキーで、プロバイダによって異なります:

  AIプロバイダ	APIキー
  OpenAI	APIキーを取得するには、OpenAIの使用を参照してください。
  OpenAI互換プロバイダ	APIキーおよびprovider_endpointを取得するには、「OpenAI互換プロバイダの使用」を参照してください。
  Cohere	APIキーを取得するには、Cohereの使用を参照してください。
  Azure OpenAIサービス	APIキーを取得してサービスを構成するには、Azure OpenAIサービスの使用を参照してください。 ノート Azure OpenAIサービス・プリンシパルを使用して認証する場合は、DBMS_CLOUD.CREATE_CREDENTIALプロシージャをスキップできます。Azure OpenAI Serviceプリンシパルを使用した認証の例については、Select AIの使用例を参照してください。
  OCI生成AI	API署名キーを生成するには、OCI生成AIの使用を参照してください。
  Google	APIキーを生成するには、Googleの使用を参照してください。
  人類学	APIキーを生成するには、Anthropicの使用を参照してください。
  ハギング面	APIキーを生成するには、Hugging Faceの使用を参照してください。
  AWS	APIキーおよびモデルIDを取得するには、AWSの使用を参照してください。

次の例では、RAGでSelect AIを使用するように表領域の割当て制限をADB_USERに付与します。

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

ユーザーに付与された表領域割当て制限を確認するには、次を実行します。

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

パラメータは次のとおりです:

• TABLESPACE_NAME: 割当て制限が割り当てられる表領域。Autonomous Databaseでは、表領域は自動的に管理され、接頭辞としてDATAが付きます。
• BYTES: 表領域でユーザーが現在使用している領域の量。
• MAX_BYTES: 割り当てられる最大割当て容量(バイト単位)。MAX_BYTESが-1の場合、表領域に対する割当て制限は無制限です。ベクトル索引を作成するデータベース・ユーザーは、ベクトル索引に対応するためにMAX_BYTESをバイトより十分に大きくするか、MAX_BYTESを無制限の割当て制限に対して-1にする必要があります。