PostgreSQL JSONBのGINインデックス徹底解説｜jsonb_opsとjsonb_path_opsの違いと使い分け

PostgreSQLのJSONB型は、柔軟なデータ構造を扱える便利な機能ですが、大量のJSONデータを高速検索するには適切なインデックス設計が重要になります。

JSONBに対してGINインデックスを作成する場合、標準のjsonb_opsと、検索用途を限定することで高速化できるjsonb_path_opsという2種類の演算子クラスがあります。

どちらもJSONB検索を高速化するための仕組みですが、対応する検索条件やインデックスサイズ、性能特性が異なります。この記事では、それぞれの違いや選択基準について詳しく解説します。

PostgreSQLのJSONBとGINインデックスの基本

JSONB型は、JSONデータをPostgreSQL内部で効率的に扱える形式で保存するデータ型です。単純な文字列としてJSONを保存する場合と違い、内部構造を解析した状態で保持するため、キーや値を条件にした検索が可能になります。

例えば、以下のようなJSONBデータを保存できます。

{"name":"Tanaka","age":30,"tags":["database","postgresql"]}

しかし、JSONBデータは通常のB-treeインデックスでは効率的に検索できません。そこで利用されるのがGIN（Generalized Inverted Index）インデックスです。

GINインデックスは、複数の要素を含むデータを効率的に検索するためのインデックスで、配列や全文検索、JSONBのような複合データ構造に適しています。

jsonb_opsとは何か

jsonb_opsは、JSONB型に対するGINインデックスのデフォルト演算子クラスです。特別な指定をしない場合、この方式でインデックスが作成されます。

例えば、以下のようなSQLではjsonb_opsが利用されます。

CREATE INDEX idx_data ON users USING GIN (data);

jsonb_opsはJSONBのキーと値を幅広くインデックス化するため、多くの検索条件に対応できます。

jsonb_opsが対応する主な検索

• キーの存在確認（? 演算子）
• 複数キーの存在確認（?|、?& 演算子）
• 包含検索（@> 演算子）
• JSONPath検索（@?、@@ 演算子）

例えば、以下のような検索が可能です。

SELECT * FROM users WHERE data ? 'name';

このように、JSON内に特定のキーが存在するかを確認する処理ではjsonb_opsが適しています。

jsonb_path_opsとは何か

jsonb_path_opsは、JSONBの包含検索に特化したGINインデックスの演算子クラスです。

作成する場合は、明示的に指定します。

CREATE INDEX idx_data_path ON users USING GIN (data jsonb_path_ops);

jsonb_path_opsはjsonb_opsよりも保存する情報量を限定することで、インデックスサイズを小さくし、高速な検索を実現します。

ただし、対応する検索条件は限定されます。

jsonb_path_opsが得意な検索

jsonb_path_opsが特に高速なのは、JSONBの包含演算子である@>を利用した検索です。

例えば、以下のような検索です。

SELECT * FROM users WHERE data @> '{"role":"admin"}';

このように、「JSONの中に指定した構造が含まれているか」を調べる用途では非常に効率的です。

jsonb_opsとjsonb_path_opsの主な違い

簡単に言えば、jsonb_opsは「何でも検索できる汎用型」、jsonb_path_opsは「特定用途に絞った高速型」と考えると分かりやすくなります。

jsonb_opsを選択するケース

JSONBデータに対してさまざまな検索を行う可能性がある場合は、jsonb_opsが向いています。

例えば、ユーザー設定情報をJSONBで保存していて、以下のような検索を行う場合です。

• 特定の設定項目が存在するか確認する
• 複数のキーを条件に検索する
• 値だけではなくキー構造も検索対象にする

アプリケーションの仕様変更によって検索方法が増える可能性がある場合も、jsonb_opsの柔軟性が役立ちます。

jsonb_path_opsを選択するケース

JSONBの利用目的が包含検索中心の場合は、jsonb_path_opsが有効です。

例えば、ログデータやイベント情報をJSONBで保存し、「特定の属性を持つデータだけ取得する」という処理が大量に発生する場合があります。

具体例として、以下のような検索です。

SELECT * FROM events WHERE properties @> '{"type":"purchase"}';

このような検索が大量に実行されるシステムでは、jsonb_path_opsによってインデックスサイズを削減しながら高速化できます。

jsonb_path_opsの注意点

jsonb_path_opsは高速ですが、すべてのJSONB検索に利用できるわけではありません。

例えば、以下のようなキー存在確認は対応していません。

SELECT * FROM users WHERE data ? 'name';

そのため、jsonb_path_opsを採用する場合は、アプリケーションで実行されるSQLを事前に確認することが重要です。

検索条件と合わないインデックスを作成すると、期待した性能改善が得られないだけでなく、不要なインデックス容量を消費することになります。

JSONBのGINインデックスを設計するときのポイント

JSONBのインデックス設計では、単純に高速そうな方式を選ぶのではなく、実際の検索パターンを基準に判断することが重要です。

まず確認すべきポイントは、アプリケーションがどの演算子を利用しているかです。

また、実際のデータ量や検索頻度によって効果は変わるため、EXPLAIN ANALYZEなどで実行計画を確認しながら調整することが大切です。

まとめ：jsonb_opsとjsonb_path_opsは用途によって選択する

PostgreSQLのJSONBに対するGINインデックスでは、jsonb_opsとjsonb_path_opsのどちらを選ぶかによって、検索対応範囲や性能、インデックス容量が変わります。

jsonb_opsは幅広い検索に対応できる汎用的な方式で、検索条件が多様なシステムに向いています。

一方、jsonb_path_opsは@>による包含検索に特化しており、特定パターンの検索を大量に行うシステムでは、高速化や容量削減のメリットがあります。

JSONBを利用する際は、保存するデータ構造だけでなく、どのような検索が実行されるのかを考慮して、適切なGINインデックスを選択することが重要です。