AIプロファイルの管理

次の例では、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
  Anthropic	api.anthropic.com
  Hugging Face	api-inference.huggingface.co
  AWS	bedrock-runtime.us-east-1.amazonaws.com

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

次の例では、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サービス・プリンシパルを使用した認証の例については、Select AIの使用例を参照してください。
  OCI生成AI	API署名キーを生成するには、OCI生成AIの使用を参照してください。
  Google	APIキーを生成するには、Googleの使用を参照してください。
  Anthropic	APIキーを生成するには、Anthropicの使用を参照してください。
  Hugging Face	APIキーを生成するには、Hugging Faceの使用を参照してください。
  AWS	APIキーおよびモデルIDを取得するには、AWSの使用を参照してください。

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

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にする必要があります。

次の例では、OpenAIプロバイダを使用して、OPENAIというAIプロファイルを作成し、現在のユーザー・セッションのOPENAIプロファイルを設定します。

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