【入門編】 JSON型の利用 – Cloud Spanner

こんにちは。Cloud Spannerの世界へようこそ。

今日は、Spannerの数ある機能の中でも、特に「現代的なアプリケーション開発」において最強の武器となる「JSON型」についてお話しします。

「Spannerって、ガチガチの表（テーブル）を作る厳格なデータベースじゃないの？」と思っているなら、それは少しもったいない。実は、Spannerは驚くほど柔軟に進化しているんです。

さあ、肩の力を抜いて、一緒に見ていきましょう。

—

1. なぜ「JSON型」が重要なのか？：例え話で理解する

データベースを「図書館の巨大な書棚」だと想像してください。
これまでのSpannerは、「本はすべてこの規格の箱に入れなさい」と決まっていました。整然としていて検索は速いけれど、たまに「どこに分類していいかわからない付録」や「中身がコロコロ変わるメモ」が出てくると困ってしまいますよね。

この「決まりきっていない、自由な形のデータ」をそのまま放り込めるのが、Spannerの「JSON型」です。

従来の列： 氏名、年齢、住所（決まったフォーマット）
JSON型の列： 「ユーザーの興味関心」や「デバイスの設定情報」（中身が人によってバラバラ）

これらを1つのテーブルで仲良く管理できる。これがJSON型の正体です。

—

2. JSON型を使ってみる：定義と保存

まずは、JSONを格納するための場所を用意しましょう。

— ユーザーの基本情報テーブルに、自由記述ができる「metadata」列を追加するイメージです
CREATE TABLE Users (
UserId INT64 NOT NULL,
UserName STRING(MAX),
— ここがJSON型！どんなデータが入るか事前に決めなくてOK
Metadata JSON
) PRIMARY KEY (UserId);

データを保存する時は、こんな感じです。

INSERT INTO Users (UserId, UserName, Metadata)
VALUES (1, ‘Alice’, JSON ‘{“theme”: “dark”, “notifications”: true, “tags”: [“engineer”, “cloud”]}’);

見ての通り、普通の文字列のように見えますが、Spannerはこれを「ただの文字」ではなく「中身が解析可能なデータ」として扱ってくれます。

—

3. 中身をピンポイントで抜き出す：JSONパス式

ここからが魔法の時間です。保存したJSONの中身を、いちいちアプリ側で取り出して分解する必要はありません。Spannerにお任せしましょう。

「JSONパス式」という記法を使います。

— 「Metadataの中にある、themeという項目は何？」と聞くクエリ
SELECT
UserName,
Metadata.theme — ドットでつなぐだけで中身にアクセスできる
FROM Users
WHERE Metadata.notifications = true; — JSONの中身でフィルタリングも可能！

まるで、整理されていない箱の中に手を突っ込んで、目的の付箋だけをサッと取り出すような手軽さですね。

—

4. 検索を爆速にする：JSONへのインデックス

「でも、自由なデータに対して検索をかけたら遅くなるんじゃないの？」
そんな心配は無用です。Spannerには「JSON専用のインデックス」があります。

特定の項目を頻繁に検索するなら、インデックスを貼ってしまいましょう。

— Metadataの中の ‘theme’ を頻繁に検索するなら、これだけで爆速になります
CREATE INDEX UsersByTheme ON Users(JSON_VALUE(Metadata, ‘$.theme’));

これで、どれだけJSONが複雑になっても、Spannerは瞬時にデータを見つけ出します。

—

ここをクリアすれば、Spannerはあなたの最強の武器になる

今日のポイントをまとめると、たったの3つです。

1. 柔軟性： 構造が決まっていないデータも、JSON型なら怖くない。
2. 操作性： `Metadata.key` と書くだけで、中身を自由に取り出せる。
3. 高性能： インデックスを貼れば、自由なデータでも検索速度は妥協しない。

いかがでしたか？
「厳格なデータ」と「自由なデータ」を一つのデータベースで管理できる。このハイブリッドな柔軟性こそが、今のCloud Spannerを世界最高峰のデータベースたらしめている理由です。

まずは小さなテーブルで、JSON型の列を一つ作るところから始めてみてください。きっと「え、こんなに簡単に扱えるの？」と驚くはずですよ。

また何かわからないことがあれば、いつでも聞いてくださいね。あなたのエンジニアリングを全力で応援しています！