AnalyticDB:pg_bigm

likequery()

likequery(text) は、検索キーワードを LIKE で処理可能なパターン文字列に変換します。この関数は、キーワードを % で囲み、入力内の %、_、\ などの特殊文字をエスケープします：

postgres=> SELECT likequery('pg_bigm has improved the full text search performance by 200%');
                            likequery
-------------------------------------------------------------------
 %pg\_bigm has improved the full text search performance by 200\%%
(1 行)

postgres=> SELECT * FROM pg_tools WHERE description LIKE likequery('search');
  tool   |                      description
---------+---------------------------------------------------------------------
 pg_bigm | PostgreSQL で 2-gram 全文検索機能を提供するツール
 pg_trgm | PostgreSQL で 3-gram 全文検索機能を提供するツール
(2 行)

show_bigm()

show_bigm(text) は、文字列内のすべての 2-gram 要素を含む配列を返します：

postgres=> SELECT show_bigm('full text search');
                           show_bigm
------------------------------------------------------------------
 {" f"," s"," t",ar,ch,ea,ex,fu,"h ","l ",ll,rc,se,"t ",te,ul,xt}
(1 行)

bigm_similarity()

bigm_similarity(text, text) は、2 つの文字列の 2-gram 集合間の最大類似度を表す 0 ～ 1 の浮動小数点数を返します。値が 0 の場合は完全に類似していないことを意味し、1 の場合は同一であることを意味します。

postgres=> SELECT bigm_similarity('full text search', 'text similarity search');
 bigm_similarity
-----------------
       0.5714286
(1 行)

postgres=> SELECT bigm_similarity('ABC', 'A');
 bigm_similarity
-----------------
            0.25
(1 行)

postgres=> SELECT bigm_similarity('ABC', 'B');
 bigm_similarity
-----------------
               0
(1 行)

postgres=> SELECT bigm_similarity('ABC', 'abc');
 bigm_similarity
-----------------
               0
(1 行)

pg_gin_pending_stats()

pg_gin_pending_stats(index) は、GIN インデックスの保留リスト内のページ数およびタプル数を返します。この関数は、fastupdate が有効（デフォルト）の場合に有用です。なぜなら、GIN インデックスは新しいエントリをメインインデックスにマージする前に、保留リストにバッチ処理するためです：

postgres=> SELECT * FROM pg_gin_pending_stats('pg_tools_idx');
 pages | tuples
-------+--------
     0 |      0
(1 行)

fastupdate = off でインデックスを作成した場合、保留リストは存在しないため、この関数は常に 0 を返します：

CREATE INDEX ON your_table_name (your_column_name gin_bigm_ops) WITH (fastupdate = off);

pg_bigm.last_update

読み取り専用。pg_bigm 拡張機能が最後に更新された日付です。

pg_bigm.enable_recheck

デフォルト： on

GIN インデックスから候補タプルを取得した後に、再検証（recheck）を実行するかどうかを制御します。デフォルト値の on のままにしてください。

このパラメーターの重要性： GIN 全文検索は 2 段階で動作します。まず、ビットマップ索引スキャンにより、2-gram の一致に基づいて候補タプルを取得します。次に、再検証（ヒープスキャン）により、各候補が LIKE パターンに実際に一致するかを確認します。これは、2-gram インデックスが誤検知を生じる可能性があるためです。enable_recheck を off に設定すると、このステップがスキップされ、不正確な結果が返される可能性があります。

pg_bigm.gin_key_limit

デフォルト： 0（すべての 2-gram 要素を使用）

全文検索クエリ実行時に使用される 2-gram 要素の最大数を設定します。デフォルト値の 0 は、検索キーワードのすべての 2-gram 要素を使用することを意味します。

変更が必要なケース： 極めて長い検索キーワードの場合、すべての 2-gram 要素を使用するとクエリの実行速度が大幅に低下する可能性があります。このパラメーターを小さな正の値に設定することで、使用する 2-gram 要素数を制限し、パフォーマンスを向上させることができます。ただし、要素数を減らすと、再検証フェーズでフィルター処理する必要のある誤検知候補の数が増加することにご注意ください。

pg_bigm.similarity_limit

=% 類似検索オペレーターにおける最小類似度しきい値を設定します。このしきい値を超える類似度を持つタプルのみが返されます。

変更が必要なケース： 類似検索クエリの結果が多すぎる場合（曖昧な一致が多い場合）は、この値を増加させて結果を絞り込みます。一方、検索語が短い、または精度が低い場合などは、この値を減少させて結果を広げます。

オペレーター

インデックスオペレータークラス

関数リファレンス