Neon入門 — SQLで商品を保存して、DBのブランチを試そう

ひよこ

データベースを使ってみたいけど、サーバーの準備から必要なの？

ペンギン先生

NeonはクラウドでPostgreSQLを使えるサービスだよ。まずは練習用のプロジェクトを作り、ブラウザーのSQL Editorで「りんごは200円」というデータを保存してみよう。

ひよこ

最初からアプリも作るの？

ペンギン先生

今回はSQLだけで大丈夫。計算結果の2が返るかを確かめてから、商品テーブルへ進むよ。準備と成功の目印を本文にまとめたんだ。

ひよこ

商品を追加したらどうやって見つけるの？

ペンギン先生

SELECTで、商品番号appleの行を選ぶよ。名前と価格が見えれば成功。同じ番号をもう一度追加すると主キーの重複になるので、更新とは区別しよう。

ひよこ

ブランチってGitと同じ？

ペンギン先生

別の場所で試すという発想は似ているね。でもNeonではDBのデータや構造を分岐させるよ。子の変更は親から独立していて、Gitのように変更が自動でマージされるわけではないんだ。

ひよこ

じゃあ価格の変更も安心して試せそう！

ペンギン先生

練習用の子ブランチで250円へ変更し、親では200円のままかを確かめよう。元のデータも引き継ぐので、本番の個人情報を気軽にコピーする用途とは分けて考えようね。

ひよこ

アプリからはどうつなぐの？

ペンギン先生

Connectでブランチ・DB・ロールを選んで接続情報を取得するよ。接続文字列にはパスワードが入るので、サーバー側の環境変数で管理しよう。HTTPでクエリを送れる専用ドライバーもあるんだ。

ひよこ

サーバーレスなら費用も待ち時間もゼロ？

ペンギン先生

使っていない計算部分を休止する機能はあるけど、再開には時間がかかるし、保存容量などの料金条件は別だよ。無料枠や制限も契約画面で確認しよう。

ひよこ

最初は何を覚えればいいかな？

ペンギン先生

「Neon」って出てきたら「クラウドでPostgresを使い、DBの分岐も試せるサービス」と思えばだいたいOK！まずは商品を保存して、親と子の価格を比べてみよう。

最初のゴール：商品を1件、保存して読む

SQLを少し知っていれば、アプリをまだ作れなくても始められます。今回は実際の顧客情報を使わず、りんご200円の練習データだけを扱います。

1. Neonにログインし、新しい練習用プロジェクトを作ります。プラン・料金・リージョンを確認してください。
2. SQL Editorを開き、選択中のプロジェクト・ブランチ・データベースが練習用か確認します。初期ブランチ名は作成方法などで異なるので、画面の名前を使います。
3. 初期表示のSQLを置き換え、SELECT 1 + 1 AS answer;を実行します。answerが2なら最初の接続確認は成功です。

SQL Editorで商品を保存する

次を新しい練習DBで一度実行します。

CREATE TABLE learning_products (
    sku text PRIMARY KEY,
    name text NOT NULL,
    price integer NOT NULL,
    CHECK (price > 0)
);
INSERT INTO learning_products
    (sku, name, price)
VALUES ('apple', 'りんご', 200);
SELECT name, price
FROM learning_products
WHERE sku = 'apple';

結果はりんご / 200の1行です。CREATE TABLEやINSERTまで繰り返すと、既存テーブルや主キー重複のエラーになります。見直すときは最後のSELECTだけを実行しましょう。エラーが出たら、ブランチの選択と実行した範囲を確認します。

子ブランチだけで250円に変える

商品を登録した練習ブランチから、price-testなどの子ブランチを作ります。ブランチはコピーオンライト方式でデータを分岐し、子の変更は親から独立します。

SQL Editorで子ブランチを選び、次を実行します。

UPDATE learning_products
SET price = 250
WHERE sku = 'apple';
SELECT name, price
FROM learning_products
WHERE sku = 'apple';

子では250円。親を選んでSELECTだけを実行すると200円です。これが今回の成功の目印です。子を変えても親へ自動反映はされません。本番へ構造変更を反映する場合は、別途マイグレーションなどを設計します。

ブランチは通常、元のデータも引き継ぎます。機密データがある場合はアクセス権やスキーマのみの分岐を検討します。学習が終わったら、自分の練習用の子ブランチを削除するか、不要な計算・保存データを残していないか確認しましょう。

アプリとつなぐときの三つの確認

専用の@neondatabase/serverlessでは、neon()でHTTPの単発クエリや非対話型トランザクション、Pool・ClientでWebSocketの接続を扱います。用途と実行環境の制約を公式資料で確認してください。ブラウザーへDBパスワードを埋め込む必要はありません。 通常はアプリのサーバーからDBへ接続します。

休止するのは計算部分です。アクセス時の再開待ちや保存容量の料金は別に考えます。「無料で無制限」「常に待ち時間ゼロ」という意味ではありません。

次に学ぶなら

SQLそのものが難しければSQLの仕組み、アプリとの境界を知りたければAPI開発入門へ進みましょう。DBの分岐を使う前に、Git入門でコードのブランチと比べてみるのも役立ちます。

参考資料

• Neon Consoleのツアー — SQL Editorと接続先の選択
• Neon Branching — コピーオンライトと独立した変更
• Neon Connection methods — 接続文字列の構成
• Neon Serverless driver — HTTPとWebSocketの用途
• Neon Scale to zero — 計算部分の休止と再開