【入門編】テーブル定義とデータ型 – Cloud Spanner

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

「世界最強のデータベース」なんて呼ばれると、身構えてしまうかもしれませんね。でも大丈夫。Cloud Spannerの本質は、実は「とてつもなく広くて、絶対に破綻しない整理整頓された巨大な図書館」のようなものなんです。

今日は、その図書館の「本棚（テーブル）」をどう設計し、どんな種類の情報をしまえるのか、その基本をマスターしましょう。ここさえ押さえれば、Spannerを使いこなす第一歩は完璧です。

—

1. テーブルは「究極の整理整頓」のための場所

Spannerのテーブルは、Excelのシートを想像してください。行と列で情報を管理する、あの形です。

ただし、Spannerには一つだけ、絶対に守らなければならないルールがあります。それが「プライマリキー（主キー）」です。これは、その行を特定するための「背表紙のラベル」のようなもの。

例えば、ユーザー情報を保存するなら「ユーザーID」がこれにあたります。「誰が・どのデータか」を世界中で一意に識別できる魔法の鍵ですね。

— ユーザー情報を管理するテーブルの作成
CREATE TABLE Users (
UserId INT64 NOT NULL, — ユーザーID（これが主キー！絶対に重複させません）
UserName STRING(100), — 名前（最大100文字）
CreatedAt TIMESTAMP, — アカウント作成日時
) PRIMARY KEY (UserId); — UserIdを鍵として指定

2. Spannerが扱える「魔法の素材」たち

Spannerでは、保存するデータの種類をあらかじめ決めておく必要があります。これを「データ型」と呼びます。主要なものを、日常の道具に例えて紹介しましょう。

INT64（整数）: 数えられるもの。ユーザーIDや、商品の在庫数など。
FLOAT64（浮動小数点）: 割り算が必要なもの。身長や、計算を伴うスコアなど。
STRING（文字列）: 名前や住所。`(100)`のように長さを指定します。「何文字入るか」を設計時に決めておくのがSpanner流のエコな管理術です。
BOOL（真偽値）: 「はい」か「いいえ」か。有効・無効の切り替えに。
BYTES（バイナリ）: 写真やファイルそのもの。データの中身をそのまま保存します。
DATE / TIMESTAMP: 時間の記録。TIMESTAMPは「何時何分何秒の何ミリ秒」まで正確に刻みます。
JSON: ちょっと特殊な箱。「構造が決まっていない自由なデータ」を入れるための便利なポケットです。
ARRAY（配列）: 「一つの箱の中に、複数の値を入れる」ことができます。例えば、一人のユーザーが持つ「複数の興味タグ」を、わざわざ別のテーブルを作らずに一つの行にまとめて保存できるんです。これはかなり強力ですよ！

3. 設計で「心に留めておいてほしいこと」

初心者のうちは、以下の3点だけ意識してみてください。

1. STRINGの長さは慎重に: STRING(MAX)も使えますが、必要最小限の長さを決めておくと、データベースの効率がぐんと上がります。
2. ARRAYは魔法だが使いすぎ注意: 複数の情報をまとめられるARRAYは便利ですが、検索の仕方が少し複雑になります。「何でもかんでもARRAYに入れる」のは避け、まずはシンプルなテーブル設計を心がけましょう。
3. 主キーは「予測不可能」なものを選ぶ: これは少し上級テクニックですが、主キーに「連番（1, 2, 3…）」を使うと、データが増えた時に特定の場所に負荷が集中してしまいます。UUIDのような、少しバラついた値を使うのがSpannerの性能を100%引き出すコツです。

—

最後に：あなたも今日からSpanner使い

テーブルを作るということは、「どんな世界観をデータとして表現したいか」を決めることと同じです。

Spannerは、あなたがどれだけデータを詰め込んでも、どれだけ世界中の人が同時にアクセスしても、決してへこたれません。この「安心感」を支えるのが、今日学んだ正しい型選びと、丁寧なテーブル設計なのです。

「ここをこうしたらどうなるんだろう？」とワクワクしながら、ぜひ自分のテーブルを作ってみてください。何かわからないことがあれば、いつでも聞きに来てくださいね。

あなたのデータベース構築が、素晴らしいものになりますように！