Oracleをベクターデータベースとして使用

以下のジョブは、Oracle Database 23aiに接続し、類似検索用のテーブルを作成し、名言に関するデータをそこに挿入して、ベクタータイプによる類似検索を実行することを目的としています。

始める前に

このシナリオでは、OracleのAIベクター検索機能を使用します。詳細は、該当するOracleのドキュメンテーションをご覧ください。

コンポーネントをリンク

手順

[Palette] (パレット)から、tPrejob、tOracleConnection、tFileInputDelimited、tLogRowを2つ、tMap、tOracleOutput、tOracleInput、tPostjob、tOracleCloseというコンポーネントをドラッグ＆ドロップします。
ここではデータが処理されないため、OnComponentOk接続を使ってtPrejobをtOracleConnectionに、tPostjobをtOracleCloseにリンクさせます。
[Row] (行) > [Main] (メイン)接続を使って他のコンポーネントを接続させます。
OnSubjobOkトリガーリンクを使って、メインジョブをサブジョブに接続させます。

コンポーネントを設定

手順

tOracleConnectionコンポーネントをダブルクリックして、[Component] (コンポーネント)ビューを開きます。
Oracle 23aiデータベースへの接続を設定します。
tFileInputDelimitedコンポーネントをダブルクリックして[Component] (コンポーネント)ビューを表示させます。
Oracleデータベースに挿入したいサンプルファイルのパスとプロパティを設定します。

このシナリオでは、作者、年、国が含まれている名言のTXTサンプルが使用されます。
最初のtLogRowコンポーネントをダブルクリックして、[Component] (コンポーネント)ビューを開きます。
必要であれば[Sync column] (カラムを同期)をクリックし、前のコンポーネントからスキーマストラクチャーを取得します。

[Mode] (モード)エリアで[Table] (テーブル)を選択し、[Print content with log4j] (log4jでコンテンツを入力)をクリックすると、コンソールにジョブの結果が表示されます。
tMapコンポーネントをダブルクリックして、[Map Editor] (マップエディター)を開きます。
入力テーブルからout1テーブルに、id、statement、author、year、countryという各カラムをドラッグします。
out1テーブルの最後にstatement_cloneカラムを追加し、入力テーブルからこのカラムにstatementカラムをドラッグします。この新しいカラムは、Oracleのベクターテーブルの参照カラムとして使用されます。
[OK]をクリックして変更を確定し、エディターを閉じます。
tOracleOutputコンポーネントをダブルクリックして、[Component] (コンポーネント)ビューを開きます。
[Basic settings] (基本設定)ビューで、ベクターテーブルとして使われるOracleテーブルの名前(このユースケースではvectableと呼ばれます)を入力します。
[Action on table] (テーブルでのアクション)リストで[Drop table if exists and create] (テーブルが存在する場合はドロップして作成)を選択して、[Action on data] (データでのアクション)で[Insert] (挿入)を選択します。

ベクターテーブルの詳細は、該当するOracleのドキュメンテーションをご覧ください。
[Advanced settings] (詳細設定)ビューで、[Additional Columns] (追加のカラム)テーブルに行を追加し、選択したベクターカラムにサンプルデータを挿入できるようにするためのSQL式を入力します。
[Data type] (データ型)をVECTORに設定し、[Reference column] (参照カラム)としてstatement_cloneを選択し、[Position] (位置)リストで[Replace] (置換)を選択して、次のSQL式を入力します:
```
"TO_VECTOR(VECTOR_EMBEDDING(ALL_MINILM_L12_V2 USING ? as data))"
```
tOracleInputコンポーネントをダブルクリックして、[Component] (コンポーネント)ビューを開きます。
[Basic settings] (基本設定)ビューで、[Query] (クエリー)フィールドに次のクエリーを入力し、先に作成したベクターテーブルからサンプルデータをフェッチします:
```
"
SELECT statement 
FROM vectable 
ORDER BY VECTOR_DISTANCE(vec, TO_VECTOR(VECTOR_EMBEDDING(ALL_MINILM_L12_V2 USING '" + context.query + "' as data)), EUCLIDEAN_SQUARED)
FETCH FIRST 5 ROWS ONLY
"
```
[Advanced settings] (詳細設定)ビューで、[Trim column] (カラムをトリミング)テーブルにresultというカラムを追加します。このカラムは、ジョブ実行時にコンソールに表示されます。
2番目のtLogRowコンポーネントをダブルクリックして、[Component] (コンポーネント)ビューを開きます。
必要であれば[Sync column] (カラムを同期)をクリックし、前のコンポーネントからスキーマストラクチャーを取得します。

[Mode] (モード)エリアで[Table] (テーブル)を選択し、[Print content with log4j] (log4jでコンテンツを入力)をクリックすると、コンソールにジョブの結果が表示されます。

ジョブを実行

手順

Ctrl + Sを押してジョブを保存します。
F6を押して実行します。

タスクの結果

[Run] (実行)コンソールに、ベクターテーブルからサンプルデータを取得するSQLクエリーの結果が表示されます。クエリー結果の最初の5行のみが表示されます。

ベクターテーブルが作成されたら、そのテーブルで類似検索を行うことができます。たとえば"Matter of work"というクエリーでは、次のような結果が得られます:

.-----------------------------------------------------.
|                      tLogRow_2                      |
|=---------------------------------------------------=|
|result                                               |
|=---------------------------------------------------=|
|The only way to do great work is to love what you do.|
|The only way to do great work is to love what you do.|
|Knowledge is power.                                  |
|To do nothing is the way to be nothing.              |
|With great power comes great responsibility.         |
'-----------------------------------------------------'

Oracleでベクター検索を実行する方法については、該当するOracleのドキュメンテーションをご覧ください。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください