JSONBはPostgreSQLのバイナリJSON型です。効率的でクエリ可能かつインデックス可能な形式でJSONデータを保存します。リレーショナルデータベース内に柔軟で半構造化データを保存でき、リレーショナル完全性とNoSQL的な柔軟性を組み合わせることができます。これはPostgresの最も強力な機能の一つです。
JSON → stores the exact text (preserves whitespace/key order/duplicates), parsed each query
JSONB → stores a DECOMPOSED BINARY format → slightly slower to write, but MUCH faster
to query, and supports INDEXING and rich operators
→ Use JSONB in almost all cases (JSON only if you need exact text preservation).
CREATE TABLE products (id SERIAL, attributes JSONB);
INSERT INTO products (attributes) VALUES
('{"color": "red", "size": "L", "tags": ["new", "sale"]}');
-- extract values
SELECT attributes->'color' FROM products; -- -> returns JSONB: "red"
SELECT attributes->>'color' FROM products; -- ->> returns TEXT: red
SELECT attributes#>>'{tags,0}' FROM products; -- nested path: first tag
-- query by content
SELECT * FROM products WHERE attributes->>'color' = 'red';
SELECT * FROM products WHERE attributes @> '{"color": "red"}'; -- containment
SELECT * FROM products WHERE attributes ? 'color'; -- key exists
オペレータ：-> (JSONBフィールド取得)、->> (テキストとして取得)、@> (包含判定)、? (キー存在判定)、#>> (ネストパス)。これらによってJSONBは豊かなクエリ機能を持ちます。プレーンテキストとしてJSONを保存する場合と異なります。
-- a GIN index makes containment/key queries fast
CREATE INDEX idx_attrs ON products USING GIN (attributes);
-- now WHERE attributes @> '{"color": "red"}' uses the index
-- or index a specific extracted field
CREATE INDEX idx_color ON products ((attributes->>'color'));
✓ USE for: flexible/variable attributes, settings, API payloads, sparse fields,
semi-structured data that varies per row, or rapidly-evolving schemas
✗ AVOID for: data that's well-structured and queried relationally → use normal columns
(better constraints, types, and typically better performance for structured queries)
→ Mix both: structured data in columns, variable/flexible data in a JSONB column.
JSONBはPostgreSQLの最も重要で特徴的な機能の一つであり、それを理解することは非常に価値があります。なぜなら、リレーショナルデータベース内で半構造化データを保存し、効率的にクエリすることができるからです。Postgresの完全性、トランザクション、リレーショナルパワーと、ドキュメント/NoSQLストアの柔軟性を組み合わせています。これは現代のアプリケーションにとって重要な機能です。
プレーンテキストとしてJSONを保存する場合（またはJSON型）と比較した場合の主な利点は、JSONBがクエリ可能かつインデックス可能であるということです。豊かなオペレータ（->、->>、@>、?）を使用すればJSONコンテンツを抽出・フィルタできます。また、GINインデックス（またはフィールド抽出時のインデックス）によってこれらのクエリが高速になります。つまり、クエリパフォーマンスを犠牲にせずに、ドキュメントストア的な柔軟性が得られます。
このため、JSONBは柔軟または可変的な属性、設定、APIペイロード、スパースデータ、および進化するスキーマに理想的です。これらは現代的なニーズの一般的な例で、そうでなければNoSQLデータベースまたは不適切なスキーマ設計を必要とします。
JSONB vs JSONの区別（ほぼすべてのケースでJSONBを使用）、クエリオペレータ、インデックス作成（パフォーマンスに不可欠）、そして重要なJSONBと通常のカラムの使い分け（柔軟性・可変性・半構造化データにはJSONB、よく構造化されたリレーショナルクエリデータには通常のカラム。多くの場合両方を混合）を理解することは、成熟した設計判断を反映しています。
柔軟で半構造化データを処理する能力がますます重要になっており、JSONBはロバストなリレーショナルデータベース内でこれを提供しているため（多くの場合、別のNoSQLストアの必要性を排除）、JSONBを理解することは価値があり、頻繁に関連するスキルです。これはPostgreSQLが現代のアプリケーションで非常に人気がある重要な理由の一つであり、Postgresの全力を活用する証となります。