こんにちは！データベースの設計やAPIの裏側を覗いていると、避けて通れないのが「JSONB型」のデータですよね。
「RDBの強みであるトランザクションやインデックスの恩恵を受けつつ、NoSQLのようにスキーマレスなデータを柔軟に放り込みたい」
そんなわがままを完璧に叶えてくれるPostgreSQLの奥義、それが`JSONB`型です。
今回は、PostgreSQLの公式管理ツールであり、現場のインフラから開発まで幅広く使われる「pgAdmin」を使って、このJSONBデータを自由自在に操るための実践テクニックを伝授します。
これをマスターすれば、カオスに見えるJSONデータから欲しい情報を一瞬で引き出し、日々のデータ確認やデバッグ作業が劇的に楽になりますよ。さあ、一緒に扉を開けましょう！
—
1. そもそもpgAdminとJSONBの立ち位置とは？
まず前提として、PostgreSQLの`JSONB`は、単なる文字列（`json`型）ではなく、バイナリ形式で効率的にパース・保存されたJSONデータです。キーの重複排除や、内部での高速なインデックス検索（GINインデックスなど）が効くため、現代のWebアプリケーション開発ではマストと言っても過言ではありません。
そしてpgAdminは、そのPostgreSQLの力をブラウザやデスクトップから直感的に引き出すための最強のGUIクライアントです。生のSQLを書かなくてもツリービューからデータを覗けますが、「JSONBの本気」を引き出すには、やはり適切なSQLクエリとpgAdminの機能を組み合わせるのが一番の近道です。
—
2. 動作確認：テスト用テーブルの作成とデータの投入
百聞は一見に如かず。まずはpgAdminの「Query Tool」を開いて、今日の実験場となるテーブルを作りましょう。
ECサイトの「注文データ（orders）」をイメージしてください。顧客が購入した際の商品情報や配送先が、`JSONB`として丸ごと1つのカラムに格納されているシチュエーションです。
— 1. 実験用の注文テーブルを作成
CREATE TABLE orders (
id SERIAL PRIMARY KEY,
— 注文に関するあらゆるメタデータをJSONBで保持
order_data JSONB,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
— 2. テストデータを投入（少しネストしたリアルな構造にしています）
INSERT INTO orders (order_data) VALUES
(‘{
“customer”: {“name”: “山田 太郎”, “email”: “yamada@example.com”, “tier”: “gold”},
“items”: [
{“product_id”: “P-001”, “name”: “メカニカルキーボード”, “price”: 18000, “qty”: 1},
{“product_id”: “P-042”, “name”: “パームレスト”, “price”: 3000, “qty”: 1}
],
“shipping”: {“status”: “shipped”, “carrier”: “Yamato”, “fee”: 600}
}’),
(‘{
“customer”: {“name”: “鈴木 花子”, “email”: “hanako@example.com”, “tier”: “silver”},
“items”: [
{“product_id”: “P-005”, “name”: “4Kモニター”, “price”: 45000, “qty”: 1}
],
“shipping”: {“status”: “processing”, “carrier”: “Sagawa”, “fee”: 0}
}’),
(‘{
“customer”: {“name”: “佐藤 健”, “email”: “sato@example.com”, “tier”: “gold”},
“items”: [
{“product_id”: “P-001”, “name”: “メカニカルキーボード”, “price”: 18000, “qty”: 2},
{“product_id”: “P-010”, “name”: “デスクマット”, “price”: 2500, “qty”: 1}
],
“shipping”: {“status”: “delivered”, “carrier”: “Yamato”, “fee”: 600}
}’);
これで準備完了です！pgAdminのオブジェクトブラウザから `orders` テーブルを右クリックして「View/Edit Data」を開いてみてください。JSONデータが綺麗に（かつ展開可能に）表示されるのが確認できるはずです。
—
3. pgAdminで使える！JSONB抽出・検索の極意（SQLテクニック）
ここからが本番です。JSONBを自在に操るための主要な演算子と関数を、実用的なクエリとともに見ていきましょう。
① 基本のキ：値を取り出す（`->` と `->>`）
- `->` : 結果を JSONB型 のまま取得する（さらに階層を掘り下げる時に使う）
- `->>` : 結果を テキスト（Text） として取得する（WHERE句の条件や表示の時に使う）
例：顧客の名前とメールアドレスをテキストとして取得する
SELECT
order_data->’customer’->>’name’ AS customer_name,
order_data->’customer’->>’email’ AS customer_email
FROM orders;
先輩のワンポイントアドバイス：
「最後の階層の値を取り出すときは、基本的に `->>` を使って型をテキストに確定させるのが、後続の処理でバグを生まないコツですよ」
② 検索の要：JSONの中身で絞り込む（`->>` と `@@`）
ゴールド会員（`tier: “gold”`）の注文だけを抽出したい場合、このように書きます。
SELECT
id,
order_data->’customer’->>’name’ AS name
FROM orders
— 顧客のtierが ‘gold’ の行を抽出
WHERE order_data->’customer’->>’tier’ = ‘gold’;
さらに、PostgreSQLのJSONBパス演算子（`@@`）を使うと、もっとスマートに記述できます。
— jsonb_path_ops やインデックスと組み合わせると爆速になる書き方
SELECT FROM orders
WHERE order_data @@ ‘$.customer.tier == “gold”‘;
③ 配列をを展開する：`jsonb_array_elements`
「注文に含まれる商品（items配列）を、1行ずつバラして集計したい！」という現場の要望は非常に多いです。ここで登場するのが `jsonb_array_elements` です。
SELECT
o.id AS order_id,
item->>’name’ AS product_name,
(item->>’price’)::integer AS price,
(item->>’qty’)::integer AS qty
FROM orders o,
— 配列を展開して行に変換する（LATERAL JOINの挙動）
LATERAL jsonb_array_elements(o.order_data->’items’) AS item;
このクエリをpgAdminで実行してみてください。1つの注文から複数の商品行が綺麗に展開され、数値型へのキャスト（`::integer`）によって集計もできる形に生まれ変わります。これは本当に便利なのでぜひ覚えておいてください。
—
4. 日々の開発が爆速になる！pgAdminの「ビュー（View）」活用術
毎回こんな長くて複雑なJSONパースのクエリを書くのは面倒ですよね？
そこで強力な武器になるのが、「PostgreSQLのビュー（View）」と「pgAdminのGUI機能」の組み合わせです。
先ほどの複雑なJSON構造を、まるで普通のRDBのテーブルのように扱える「仮想的なテーブル（ビュー）」としてデータベース内に保存してしまいましょう。
ステップ1：ビューを作成する
pgAdminのQuery Toolで以下を実行します。
CREATE OR REPLACE VIEW v_order_summary AS
SELECT
o.id AS order_id,
o.order_data->’customer’->>’name’ AS customer_name,
o.order_data->’customer’->>’tier’ AS customer_tier,
o.order_data->’shipping’->>’status’ AS shipping_status,
(o.order_data->’shipping’->>’fee’)::integer AS shipping_fee,
o.created_at
FROM orders o;
ステップ2：pgAdminでビューを視覚的に確認・活用する
pgAdminの左ツリーメニューを更新（Refresh）すると、「Views」という項目の中に `v_order_summary` が出現します。
これを右クリックして「View/Edit Data」 -> 「All Rows」を開いてみてください。
JSONの知識が全くない他のメンバーやビジネス部門の人でも、まるで普通の美しい一覧表のようにデータを閲覧できるようになります。
さらに、pgAdminの「Query Tool」からこのビューに対して、普通のテーブルと同様に条件を指定して検索できます。
— ビューに対して普通のWHERE句が使える！
SELECT FROM v_order_summary
WHERE customer_tier = ‘gold’ AND shipping_status = ‘shipped’;
JSONBの「柔軟性（書き込みのしやすさ）」を裏で維持しながら、ビューを使うことで表側のシステムや分析担当者には「正規化された美しいテーブル」として見せる。このアーキテクチャ設計ができるようになると、データベースエンジニアとしての格が一段と上がります。
—
まとめ
いかがでしたでしょうか？
- `->` と `->>` を使い分けて安全に値を取り出す
- `jsonb_array_elements` で配列を美しく行展開する
- 複雑なJSON構造は ビュー（View） に閉じ込めて、pgAdminで快適に管理する
pgAdminという強力な相棒がいれば、JSONB型はもはや怖いものではなく、あなたの開発を強力に加速させる最高の武器に変わります。
「毎日のデータ確認や集計作業が劇的に楽になった！」と感じていただけたら嬉しいです。ぜひ、今日の開発から試してみてくださいね！