当前位置：首页 > article >正文

DifyでOracle Base Database Service(23ai)を利用する設定手順

article 2025/3/4 15:44:43

@[TOC](DifyでOracle Base Database Service(23ai)を利用する設定手順)

はじめに

本記事では、DifyプラットフォームとOracle Base Database Service（23aiエディション）を連携させる方法を解説します。クラウド環境における大規模データ処理を想定した設定方法となっています。

前提条件

Oracle Base Database Service 23ai の稼働環境
基本的なSQLコマンドの操作知識
Dockerランタイムの利用可能な環境

1. データベース側の設定

1.1 接続設定とユーザー作成

sshでOracle Base Database Serviceのコンピュート・インスタンスに接続して、以下コマンドを実行

$ sqlplus / as sysdba

-- コンテナデータベースへの接続
SQL> alter session set container=<PDB名>;

-- 接続数パラメータ変更
ALTER SYSTEM SET PROCESSES=500 SCOPE=SPFILE;

-- アプリケーション用ユーザー作成
CREATE USER dify IDENTIFIED BY <パスワード>
DEFAULT TABLESPACE users
QUOTA UNLIMITED ON users;

GRANT DB_DEVELOPER_ROLE TO dify;

exit;

1.2 全文検索用レクサー作成

技術ノート: Difyの現行バージョン(2025年3月2日時点)ではデフォルトでmy_chinese_vgram_lexerという命名が使用されていますが、今後は変更される可能性があります。

BEGIN
  CTX_DDL.CREATE_PREFERENCE(
    'my_chinese_vgram_lexer',
    'CHINESE_VGRAM_LEXER'
  );
END;
/

2. Dify環境の設定

2.1 リポジトリの取得

git clone -b 1.0.0 https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env  # 設定ファイルのテンプレートをコピー

2.2 環境変数設定

.envファイルの変更箇所：

### Oracle連携設定 ###
VECTOR_STORE=oracle

ORACLE_HOST=<データベースサーバーIP>
ORACLE_PORT=1521
ORACLE_USER=dify
ORACLE_PASSWORD=<設定したパスワード>
ORACLE_DATABASE=<PDB名>

2.3 Docker Composeの調整

docker-compose.yamlのOracle関連設定（外部DB利用時）：

services:
  oracle:
    image: container-registry.oracle.com/database/free:latest
    profiles: 
      - oracle-skip  # 外部DB利用時はコンテナ起動をスキップ
    volumes:
      - oradata:/opt/oracle/oradata
    environment:
      ORACLE_PWD: ${ORACLE_PWD:-Dify123456}