PostgreSQLの全文検索はどのように機能しますか？

Question

Accepted Answer

PostgreSQLには**組み込みの全文検索**があります。これは`LIKE`よりもはるかに強力で、ステミング、ランキング、言語対応を備えたドキュメント/テキストから単語を検索します。**`tsvector`**（処理済みドキュメント）と**`tsquery`**（検索クエリ）型を使用し、GINインデックスで高速化します。

## LIKEが解決しない問題

```text
LIKE '%word%' → no stemming (won't match "running" for "run"), no ranking, no language
  awareness, and can't use an index well (leading wildcard) → slow and limited.
Full-text search → stems words, ignores stop words, ranks by relevance, indexable.
```

## tsvectorとtsquery

```sql
-- to_tsvector — process text into searchable lexemes (stemmed, stop-words removed)
SELECT to_tsvector('english', 'The cats are running fast');
-- → 'cat':2 'fast':5 'run':4  (stemmed: cats→cat, running→run; "the"/"are" removed)

-- to_tsquery / plainto_tsquery — parse a search query
SELECT to_tsvector('english', body) @@ to_tsquery('english', 'running')
FROM articles;   -- @@ = the match operator; matches "run" stem
```

`to_tsvector`は正規化された**見出し語**（単語をステミングし、ストップワードを削除）にテキストを変換し、`to_tsquery`は検索用語を解析します。`@@`演算子はマッチをテストします。つまり、「running」を含むドキュメントは「run」、「runs」などに一致します。

## 検索可能な列 + GINインデックス（実用的なセットアップ）

```sql
-- add a generated tsvector column and index it with GIN
ALTER TABLE articles ADD COLUMN search_vector tsvector
  GENERATED ALWAYS AS (to_tsvector('english', title || ' ' || body)) STORED;
CREATE INDEX idx_search ON articles USING GIN (search_vector);

-- fast searches using the index
SELECT title FROM articles
WHERE search_vector @@ plainto_tsquery('english', 'machine learning');
```

## 関連性によって結果をランキング

```sql
SELECT title, ts_rank(search_vector, query) AS rank
FROM articles, plainto_tsquery('english', 'database') query
WHERE search_vector @@ query
ORDER BY rank DESC;          -- most relevant first
```

`ts_rank`は各ドキュメントがどれだけよく一致するかをスコア付けし、関連性でソートされた結果を有効にします。

## なぜ重要なのか

PostgreSQLの組み込み全文検索は、多くのユースケースにおいて**検索エンジン（Elasticsearchなど）を別途用意することなく、データベース内で検索機能を実装できる**貴重な機能です。したがって、テキスト検索が必要なアプリケーションにとって理解することは有用です。

主な価値は、`LIKE`よりもはるかに強力な点にあります（単語をステミングできず、結果をランキングできず、効率的にインデックスできません）。全文検索は**単語ステミング**（「run」に対して「running」にマッチ）、**ストップワード削除**、**言語対応**、**関連性ランキング**を提供し、重要なことに**インデックス可能**です（高速検索のためのGINインデックス）。これは、Postgresで直接実装できる本当の検索機能（ユーザーが期待する種類：単語の変動のマッチング、関連性によるランキング）を提供します。

コア概念を理解する—**`tsvector`**（処理済み、ステミングされたドキュメントテキスト）、**`tsquery`**（解析された検索用語）、**`@@`**マッチ演算子、および**`ts_rank`**関連性ランキング—に加えて実用的なセットアップ（パフォーマンスのためにGINでインデックスされた生成された`tsvector`列）は、効果的な検索を実装する方法をカバーしています。

専用の検索エンジンは複雑なニーズに対してより多くを提供しますが、PostgreSQL全文検索は多くのアプリケーションにとって十分で便利です（別の検索システムの運用上の複雑さを回避し、検索データを関連するデータと一貫性を保つため）。

テキスト検索は一般的なアプリケーション要件であり、PostgreSQLが強力な組み込み全文検索（強力で、インデックス可能で、ステミングとランキング付き）を提供しており、多くの場合に別の検索エンジンなしで十分なため、全文検索の理解—tsvector/tsqueryモデル、インデックスセットアップ、ランキング—は、PostgreSQLの組み込み機能を使用して本当の検索機能を追加できる実用的で関連性の高い知識です。これは、より複雑な外部ソリューションに有利な点でしばしば見落とされる、有用な機能です。PostgreSQLで十分な場合があります。