次の例では、api.openai.comエンドポイントを使用する権限をADB_USERに付与します。

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

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

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

EXEC DBMS_CLOUD.CREATE_CREDENTIAL('OPENAI_CRED', 'OPENAI', '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の使用を参照してください。
  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の使用を参照してください。

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

-- Create AI profile
--
SQL> BEGIN
  DBMS_CLOUD_AI.create_profile(
      'OPENAI',
      '{"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
--
SQL> EXEC DBMS_CLOUD_AI.set_profile('OPENAI');
 
PL/SQL procedure successfully completed.