はじめに
Autonomous Databaseの付属ツールの１つであるデータ変換（Data Transforms）がOCI生成AIサービスを利用したベクトル埋め込みとの統合がサポートされました。
これにより、データ変換のデータフロー機能をつかってGUIでベクトル埋め込みの作業を行うことができるようになりました。
事前作業
- Oracle Database 23aiベースのAutonomous Database
- ネットワークACLの設定
データベースユーザーにホストに対する接続権限を付与
BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => '*',
ace => xs$ace_type(privilege_list => xs$name_list('connect'),
principal_name => 'admin',
principal_type => xs_acl.ptype_db));
END;
/
- サンプル表、データの作成
作業用の表を作成しデータを格納します。また、Embedding結果を格納するためにVector型の列を持つ表を作成します。
create table wikisample (title varchar2(30),TEXT CLOB);
insert into wikisample (title,text) values('San Francisco','San Francisco is in California.');
-- 省略
commit;
create table wikisample_v (title varchar2(30),TEXT CLOB,v vector);
データ変換（ Data Transforms ) の起動とログイン
データ変換（Data Transforms)はデータベース・アクションから起動できます。
起動しているAutonomous Databaseの詳細から、「データベース・アクション」の「すべてのデータベース・アクションの表示」を選択
データベース・アクション起動パッド
データベース・アクションのメニューから「データ変換」を選択
データ変換（Data Transforms)にログイン
データ変換に関連付けられたVMがプロビジョニングされます。
プロビジョニングされるVMのサイズはOCI WebコンソールのAutonomous Databaseの詳細の「ツール構成」から確認することができます。
Data Transformsの起動の確認
接続の作成
Embeddingデータを格納するAutonomous DatabaseとOCI 生成AIへの接続を作成します。
データ変換（Data Transforms)から「Connections」を選択
Autonomos Databaseへの接続が確認できます。
「Create Connection」をクリック
Service Typeから「Services」～「OCI Generative AI」を選択
接続の名前とOCI生成AIを利用するためのクレデンシャル情報を入力し「Create」をクリック
プロジェクトとデータフローの作成
Embeddingを実施するデータフローとそのデータフローを格納するプロジェクトを作成します。
データ変換（Data Transforms)から「Projects」を選択
「Create Data Flow」をクリック
「Create Data Flow」の画面で、データフローの名前を入力
「Create New Project」を選択し、プロジェクトの名前を入力
データフローの画面で「Add a Schema」をクリックして、Autonomous Databaseの接続とスキーマを選択します。
接続したスキーマが所持する表のリストからEmbedding対象とする表を選択
データベース機能ツールバーから「MACHINE LERNING」を選択
「Text Embedding Vector」をデザイン・キャンバスにドラッグし、最初に選択した表から「コネクタ」アイコン(「コネクタ」アイコン)をドラッグして、コンポーネントを接続
デザイン・キャンパス内の「Text Embedding Vector」をクリックし、OCI生成AIに関する情報を入力
- AI Service:「OCI Generative AI」
- Connection: 接続の名前（例：OCI_GENAI_CONN）
- AI Model:Embeddingに使用するモデルをリストから選択（例：cohere.embed-multilingual-v3.0）
「Column Mapping」（列マッピング）でinput_textの編集アイコンをクリック
「Expression」（式）列にEmbedding対象とするテキスト列をドラッグ
デザイン・キャンバスにEmbeddin結果を格納する表をドラッグ（例：WIKISAMPLE_V）
選択した表の編集から「Column Mapping」（列マッピング）でベクトル列の編集アイコンをクリック
「Expression」（式）列にTextEmbeddingVectorのVECTOR_EMBEDDINGをドラッグ
列マッピングの確認
Embeddingの実施と確認
データ・フローを保存して実行します。
保存していない場合ダイアログが表示されます。
データフローを開始
ジョブの確認
Embedding結果をSQLで確認（例：データベース・アクションSQL）
ベクトル列の値
おわりに
Autonomous Databaseのデータ変換を使うことでGUIベースにEmbeddingのフロー作成・実行ができました。
データ変換の使用を開始すると、ツールに関連付けられたVMがプロビジョニングされ、データベースECPU数に加えてツールに割り当てられたECPU数の時間課金が発生します。
データベースインスタンスが停止または終了した場合、またはデータ変換が指定された最大アイドル時間（デフォルト10分）を超えるアイドル状態の場合、データ変換に割当て済ECPUの請求が停止します。