MongoDB入門 — 商品1件でドキュメントとCRUDを試そう

ひよこ

MongoDBは普通の表と何が違うの？

ペンギン先生

商品を1枚のカードのようなドキュメントで保存できるDBだよ。りんごの名前、価格、色をまとめて扱ってみよう。内部形式はBSONで、JSONに似た書き方で操作できるんだ。

ひよこ

列を先に決めなくていいなら、何でも入れてよい？

ペンギン先生

構造が柔軟なだけで、ルールが不要ではないよ。価格が数値か、必要な項目があるかは、アプリやDBのスキーマ検証で確かめよう。

ひよこ

最初はどこに保存するの？

ペンギン先生

今回はAtlasに新しい練習用の接続先を用意する流れだよ。料金を確認し、練習DBだけを扱えるDBユーザーと自分の接続元IPを設定してからつなごう。

ひよこ

接続できないときは全IPを許可する？

ペンギン先生

まず自分の現在のIP、DBユーザー、接続先を確認しよう。0.0.0.0/0へ広げることを、初心者の標準手順にはしないよ。

ひよこ

商品はどうやって登録するの？

ペンギン先生

mongoshでinsertOneを使い、返ったinsertedIdを覚えるよ。その_idで同じ商品の検索・更新・削除を体験できるんだ。

ひよこ

検索が遅ければインデックスを増やせばいい？

ペンギン先生

調べる項目に合うインデックスを検討するよ。追加すると保存領域や更新の負担も増えるので、検索条件と実行計画を見ながら選ぼう。

ひよこ

複数の商品をまとめて変更する保証は？

ペンギン先生

単一ドキュメントの書き込みは原子的だよ。複数ドキュメントのトランザクションも対応する構成で使えるけど、設計や読み書きの設定を確認する必要があるんだ。

ひよこ

最初の覚え方は？

ペンギン先生

「MongoDB」って出てきたら「データをドキュメント単位で保存するDB」と思えばだいたいOK！まず1件の登録、検索、価格変更、削除を順に試そう。

最初のゴール：りんごのカードを1枚操作する

MongoDBでは、関連する値をドキュメントとしてまとめられます。今回はりんご・200円・赤を一つにし、CRUD（作成・読み取り・更新・削除）を試します。

{
  "name": "りんご",
  "price": 200,
  "colors": ["赤"]
}

文字列・数値・配列を同じドキュメントに入れています。BSONはJSONに似た文書表現に加え、日付などの型も扱います。

Atlasで接続準備をする

この手順はAtlasのアカウントと、MongoDB Shell（mongosh）が必要です。プラン、料金、利用可能な構成は作成画面で確認します。

1. 新しい練習用プロジェクトでDBの接続先を用意します。本番データは使いません。
2. DBユーザーを作ります。Atlasのログインアカウントとは別です。練習DBだけを読み書きできる権限と、推測されにくいパスワードを設定します。
3. IP access listへ自分の現在の公開IPを追加します。可能なら一時的な許可を使います。
4. ConnectでMongoDB Shellを選び、表示される接続手順に従います。パスワードはプロンプトで入力し、記事・Git・公開画面へ貼りません。

接続失敗では、現在のIP、DBユーザー、DNS・ネットワーク、接続先の状態を順に確認します。全IPを許可することを最初の解決策にしません。 学習が終わったら不要な接続許可と練習リソースを整理します。

mongoshで1件を登録・検索する

接続できたら、次をmongoshで実行します。learning_shopという自分の練習DBと、products_demoというコレクションだけを扱います。

use learning_shop
const products = db.products_demo;
const added = products.insertOne({
  name: "りんご",
  price: 200,
  colors: ["赤"]
});
const productId = added.insertedId;
products.findOne({ _id: productId });

_idと、りんご・200が表示されれば成功です。insertOneを再実行すると別のドキュメントが増えるので、見直すときはfindOneだけ実行します。シェルを閉じると変数は残らないため、再接続時は対象の_idを確認してください。

同じ1件だけを更新・削除する

同じシェルで、保存した_idを使います。

products.updateOne(
  { _id: productId },
  { $set: { price: 250 } }
);
products.findOne({ _id: productId });

価格が250になったか確認します。matchedCountが0なら、対象の_idやDBが違わないか確認してください。$setは指定した項目を変えるので、名前と色は残ります。

最後に、この練習で登録した1件だけを削除します。

products.deleteOne({ _id: productId });
products.findOne({ _id: productId });

削除数が1、検索結果がnullなら完了です。コレクション全体を消す操作は必要ありません。

柔軟な構造を使うときの考え方

柔軟なスキーマでも、価格に文字列が混ざれば集計を間違えることがあります。スキーマ検証で型や範囲を指定できます。単一文書の原子性と、複数文書のトランザクションは分けて考えましょう。

次に学ぶなら

SQLとNoSQLの比較でデータのまとめ方を比べ、API開発入門で商品を外から取得する窓口の作り方へ進めます。

参考資料

• MongoDB CRUD — 登録・検索・更新・削除と単一文書の原子性
• Atlas IP access list — IP単位の接続許可と一時許可
• Atlas cluster creation — クラスタ作成の前提
• MongoDB Schema validation — 型・値の検証
• MongoDB Indexes — 検索条件とインデックス
• MongoDB Transactions — 対応構成と読み書きの条件
• Atlas Database users — DBユーザーとAtlasユーザーの違い
• mongosh Connect — 接続とパスワードのプロンプト
• MongoDB BSON types — 文書形式と型