AlloyDB for PostgreSQL の RUM インデックスを使用すると、インデックスに語彙素とともに位置情報と属性情報を保存することで、全文検索クエリを高速化できます。rum 拡張機能を有効にすると、RUM インデックスを作成し、関連性ランキング、フレーズ検索、タイムスタンプベースの並べ替えを最適化できます。
始める前に
RUM 拡張機能を作成するには、alloydbsuperuser データベース ロールが必要です。
AlloyDB 管理者(roles/alloydb.admin)Identity and Access Management(IAM)ロールは、AlloyDB リソースに対する完全な制御権を付与しますが、alloydbsuperuser データベース ロールは付与しません。拡張機能を作成するには、管理者が alloydbsuperuser データベース ロールを明示的に付与する必要があります。
ロールの付与の詳細については、IAM ユーザーまたはサービス アカウントをクラスタに追加するをご覧ください。
RUM 拡張機能を作成する
RUM 拡張機能は、データベースごとに 1 回作成する必要があります。
psqlまたは別のクライアントを使用して AlloyDB データベースに接続します。詳細については、クラスタ インスタンスに接続するをご覧ください。次の SQL コマンドを実行して、拡張機能を作成します。
CREATE EXTENSION IF NOT EXISTS rum;
RUM インデックスを作成する
全文検索クエリを最適化するには、データに RUM インデックスを作成します。RUM には、さまざまなユースケースに対応する複数の演算子クラスが用意されています。
RUM 演算子クラスの種類
次の表に、さまざまな RUM 演算子クラスとその主なユースケースをまとめます。
| オペレーター クラス | 主なユースケース | 制限事項 |
|---|---|---|
rum_tsvector_ops |
ランキングとフレーズ検索を使用した標準の全文検索。 | なし |
rum_tsvector_hash_ops |
全文検索のインデックスが小さくなり、更新が高速化されます。 | 接頭辞検索はサポートされていません。 |
rum_tsvector_addon_ops |
別の列で並べ替えられた全文検索。 | なし |
rum_anyarray_ops |
配列列内の検索。 | なし |
rum_<TYPE>_ops |
距離ベースのクエリ用のスカラー型のインデックス登録。 | なし |
rum_tsvector_hash_addon_ops |
別の列で並べ替えられたハッシュベースの全文検索。 | 接頭辞の一致はサポートされていません。 |
rum_tsquery_ops |
逆引き検索用に保存された tsquery 値のインデックス登録。 |
なし |
rum_anyarray_addon_ops |
別の列で並べ替えられた配列検索。 | なし |
基本的な全文検索のインデックス
高速なランキングとフレーズ検索機能が必要な標準のテキスト検索には、rum_tsvector_ops 演算子クラスを使用します。この演算子クラスは、インデックス内の各語彙素の位置を格納します。次の例では、content 列を持つ documents という名前のテーブルを作成します。
documentsという名前のテーブルを作成します。sql CREATE TABLE documents ( id SERIAL PRIMARY KEY, title TEXT NOT NULL, content TEXT NOT NULL, published_at TIMESTAMP WITH TIME ZONE DEFAULT NOW() );documentsテーブルにサンプルデータを入力します。INSERT INTO documents (title, content) VALUES ('Title', 'This search engine is working as intended');生成された
tsvector列をテーブルに追加します。この列には、処理されたテキストが自動的に保存され、クエリのパフォーマンスが向上します。ALTER TABLE documents ADD COLUMN search_vector tsvector GENERATED ALWAYS AS (to_tsvector('english', content)) STORED;新しい
search_vector列に RUM インデックスを作成します。CREATE INDEX idx_docs_rum ON documents USING rum (search_vector rum_tsvector_ops);インデックスを使用してテーブルをクエリします。
<=>演算子は、インデックスから直接ドキュメントとクエリの関連性スコア(距離)を計算し、高速な並べ替えを可能にします。SELECT title, content FROM documents WHERE search_vector @@ to_tsquery('english', 'search <-> engine') ORDER BY search_vector <=> to_tsquery('english', 'search <-> engine');documentsテーブルにさらにデータを入力します。INSERT INTO documents (title, content) VALUES ('Title1', 'English is my primary language.'); INSERT INTO documents (title, content) VALUES ('Title2', 'Google has a great engineering culture');接頭辞検索クエリを実行します。これにより、
engineerやenglishなど、engで始まる単語を含むドキュメントが検索されます。SELECT title, content FROM documents WHERE search_vector @@ to_tsquery('english', 'eng:*');
最適化されたハッシュ検索のインデックス
rum_tsvector_hash_ops 演算子クラスを使用して、インデックス サイズを縮小し、更新速度を向上させます。このクラスには、完全な語彙素ではなく、各語彙素のハッシュが格納されます。このアプローチでは、インデックスは小さくなりますが、接頭辞検索はサポートされません。次の例では、search_vector 列を含む documents という名前のテーブルがあることを前提としています。
ハッシュ演算子クラスを使用して RUM インデックスを作成します。
CREATE INDEX idx_docs_rum_hash ON documents USING rum (search_vector rum_tsvector_hash_ops);documentsテーブルにさらにデータを入力します。INSERT INTO documents (title, content) VALUES ('Title3', 'That person was driving incredibly fast, however the routing was not very efficient');標準一致クエリを実行します。
SELECT * FROM documents WHERE search_vector @@ to_tsquery('english', 'fast & efficient');
タイムスタンプで並べ替えられた検索用インデックス
rum_tsvector_addon_ops 演算子クラスを使用して、テキストでフィルタリングし、別のフィールド(タイムスタンプなど)で並べ替えるクエリを最適化します。このパターンでは、追加フィールドの値がインデックスに直接保存されるため、検索後の低速な並べ替えオペレーションを回避できます。次の例では、search_vector 列と published_at 列を含む documents という名前のテーブルがあることを前提としています。
published_atタイムスタンプを含むインデックスを作成します。CREATE INDEX idx_docs_rum_timestamp ON documents USING rum (search_vector rum_tsvector_addon_ops, published_at) WITH (attach = 'published_at', to = 'search_vector');engineという単語を含むドキュメントを検索し、出版日順に並べ替えるクエリを実行します。このインデックスは、検索と並べ替えの両方を効率的に処理します。SELECT title, published_at FROM documents WHERE search_vector @@ to_tsquery('english', 'engine') ORDER BY published_at DESC;
配列検索用のインデックス
rum_anyarray_ops 演算子クラスを使用して、タグのリストなどの配列列にインデックスを付けます。これにより、重複する配列(&&)、含まれる配列(@>)、または他の配列に含まれる配列(<@)を効率的にクエリできます。次の例では、documents テーブルに tags 列を追加します。
tags列を追加し、データを入力します。ALTER TABLE documents ADD COLUMN tags TEXT[]; INSERT INTO documents (title, content, tags) VALUES ( 'Title4', 'Sample Text', ARRAY['ai', 'ml'] );tagsという名前のTEXT[]列に RUM インデックスを作成します。CREATE INDEX idx_tags_rum ON documents USING rum (tags rum_anyarray_ops);クエリを実行して、タグに
aiまたはmlが含まれるドキュメントを検索します。SELECT * FROM documents WHERE tags && '{"ai", "ml"}';
スカラー型のインデックス
rum_<TYPE>_ops 演算子クラスを使用して、整数、タイムスタンプ、浮動小数点数などの連続値を含む列にインデックスを付けます。これらの演算子クラスを使用すると、<=> 演算子を使用して値間の距離を効率的に計算できます。次の例では、documents という名前のテーブルがあることを前提としています。
documentsテーブルにratingなどの一般的な整数列を追加します。ALTER TABLE documents ADD COLUMN rating INT; UPDATE documents SET rating = floor(random() * 5 + 1);rating列に RUM インデックスを作成します。CREATE INDEX idx_rating_rum ON documents USING rum (rating rum_int4_ops);クエリを実行して、
ratingが値 5 に最も近いドキュメントを見つけます。SELECT title, rating FROM documents ORDER BY rating <=> 5;
タイムスタンプで並べ替えられた最適化されたハッシュ検索のインデックス
rum_tsvector_hash_addon_ops 演算子クラスを使用すると、ハッシュ インデックスの利点とアドオン インデックスの並べ替え機能を組み合わせることができます。このクラスは、各語彙素のハッシュと追加の列の値を格納します。この構成では、追加の列による効率的な並べ替えがサポートされますが、プレフィックス マッチングはサポートされません。次の例では、search_vector 列と published_at タイムスタンプ列を含む documents という名前のテーブルがあることを前提としています。
ハッシュ演算子クラスを使用し、
published_atタイムスタンプを含む RUM インデックスを作成します。CREATE INDEX idx_docs_rum_hash_timestamp ON documents USING rum (search_vector rum_tsvector_hash_addon_ops, published_at) WITH (attach = 'published_at', to = 'search_vector');engineを含むドキュメントを検索し、出版日で並べ替えるクエリを実行します。SELECT title, published_at FROM documents WHERE search_vector @@ to_tsquery('english', 'engine') ORDER BY published_at DESC;
保存済みクエリのインデックス
tsquery 値のインデックスを作成するには、rum_tsquery_ops 演算子クラスを使用します。これにより、「逆検索」を実行して、指定された入力ドキュメントに一致する保存済みクエリを特定できます。次の例では、queries という名前のテーブルが作成されます。
クエリを保存するテーブルを作成します。
sql CREATE TABLE queries ( query_text tsquery ); INSERT INTO queries (query_text) VALUES (plainto_tsquery('AlloyDB is fast!'));query_text列に RUM インデックスを作成します。CREATE INDEX idx_queries_rum ON queries USING rum (query_text rum_tsquery_ops);クエリを実行して、ドキュメントに一致する保存済みクエリを検索します。
SELECT * FROM queries WHERE to_tsvector('english', 'AlloyDB is fast') @@ query_text;
タイムスタンプで並べ替えられた配列検索のインデックス
rum_anyarray_addon_ops 演算子クラスを使用して、並べ替え用の追加の列とともに配列列にインデックスを付けます。次の例では、tags 列と published_at タイムスタンプ列を含む documents という名前のテーブルがあることを前提としています。
published_atタイムスタンプを含むtags列に RUM インデックスを作成します。CREATE INDEX idx_tags_rum_timestamp ON documents USING rum (tags rum_anyarray_addon_ops, published_at) WITH (attach = 'published_at', to = 'tags');クエリを実行して、
aiタグが付いたドキュメントを検索し、公開日で並べ替えます。SELECT title, published_at FROM documents WHERE tags @> '{"ai"}' ORDER BY published_at DESC;
次のステップ
- 全文検索について確認する。
- ハイブリッド ベクトル類似性検索を実行する方法を学ぶ。