スキーマは消えずにアプリへ移る — NoSQLとMongoDB

NoSQLとMongoDB。データベースと入れ子になった文書カード、構造を確認する虫眼鏡。

ここまで、保存の話は全部 MySQL でやってきました。表を作り、列を決め、WHERE で絞る。 トランザクションの回では、その表が壊れないところまで見ました。

前回: MySQLとPostgreSQLの違いは1割 — 移して確かめる 作業場所はVMの中(Ubuntu Server)です。appdb(MySQL)、Redis、Docker Compose、~/server の Express + Knex が動いている状態から始めます。

そして、そこまで来ると必ずこの言葉に出会います。

「今はもう NoSQL だよ」

この一言は、ほぼ確実に間違っています。 理由は簡単で、「NoSQL」という1つのソフトは存在しないからです。

この回でやりたいのは、MongoDB の使い方を覚えることではありません。

  • 「NoSQL」が何の総称なのかを、4つに分けて整理する
  • 同じデータを両方に入れて、見比べる
  • そのうえで「どっちを選ぶか」を、自分の言葉で言えるようにする

結論だけ先に書いておきます。この記事の最後は「迷ったらリレーショナル」です。 そう書く根拠を、実際に触ってから積み上げます。

対象レベル: 初級〜中級 / 区分: 必修

目次

この記事でわかること

  • 「NoSQL」は1つのものではないこと。すでに使っている Redis も NoSQL の一種だということ
  • 「スキーマがないから楽」は誤解であること。スキーマは消えるのではなく、アプリ側に移るだけだということ
  • 結合が多いデータには向かず、形が決まっていないデータには向くこと。そして「タスク一覧」はどちらでもよいこと
  • MongoDB でもトランザクションは使えるが、標準の構成では使えないこと。そもそも「使わなくて済む形」に寄せる設計思想だということ
  • 選べないときの既定値は「リレーショナル」でよい理由

この記事でやること

  1. NoSQL を4種類に分けて、手元の Redis がどこに入るかを確かめる
  2. Docker Compose で MongoDB を立てる(外に公開しない形で)
  3. mongosh で、同じタスク一覧をドキュメントとして入れて取り出す。SQLと1行ずつ対応させる
  4. わざと形の違うドキュメントを混ぜて、何も起きないことを確認する(これが誤解の正体)
  5. トランザクションを打ってみて、エラーを出す
  6. Node.js(mongodb パッケージ)から繋ぐ

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
リレーショナルデータベース(RDB)表で持つデータベース。MySQL がこれ。この記事では「SQL側」と呼びます
NoSQL「表とSQLでは持たない」データベースの総称。 特定のソフト名ではない
ドキュメントJSON のかたまり1件。 SQL側の「行」に当たるが、中に入れ子や配列を持てる
コレクションドキュメントの入れ物。 SQL側の「テーブル」に当たる
MongoDBドキュメント指向のデータベースソフト。 NoSQL の中で最もよく使われるものの1つ
mongoshMongoDB に手で命令を打つためのシェル。mysql コマンドに当たる
スキーマ「このデータはどんな形をしているか」の決まり。 列名・型・必須かどうか
BSONMongoDB が内部で使うJSONに似た形式。日付やバイナリなど、JSONに無い型を持てる
レプリカセット同じデータを複数のサーバーで持つ構成。 MongoDB のトランザクションはこれが前提

「NoSQL」は「No SQL(SQLは無い)」と読まれてきましたが、今は「Not only SQL(SQLだけではない)」と説明されることのほうが多いです。 この読み替えが、この記事の主張そのものです。置き換えるものではなく、増えた選択肢です。

① 「NoSQL」は1つのものではない

まずここを整理しないと、以降の話が全部ぼやけます。

「NoSQL」と呼ばれているものは、少なくとも4種類の、まったく別のデータの持ち方の総称です。

種類データの持ち方代表得意なこと
キーバリュー「名前」と「中身」の対だけRedis、Memcached1件を名前で取る。とにかく速い
ドキュメントJSONのかたまりを1件として持つMongoDB、CouchDB形が揃っていないデータをそのまま入れる
列指向(ワイドカラム)行ではなく列の単位でまとめて持つCassandra、HBase膨大な書き込み、大量データの集計
グラフ点(もの)と線(関係)で持つNeo4j「友達の友達」のような関係の追跡

ここで一番大事なのは、1行目です。

あなたはもう NoSQL を使っています。 Redisの回で入れた Redis が、キーバリュー型の NoSQL です。

あのとき何をしたか思い出してください。

  • app:v1:stats:user:1 という名前を決めて、SET して GET した
  • WHERE で絞ることも、他のキーと結合することもしなかった
  • 消えてもいいデータだけを置いた

表もSQLも使っていません。 「NoSQL を使ったことがない」と思っていたなら、それは言葉の側の問題です。

そして、ここから分かることがあります。

「MySQL から NoSQL に乗り換える」という文は、そもそも成立していません。 Redis は MySQL の代わりではなかったはずです。MongoDB も同じで、「別の役をやる別のソフト」です。

この記事で扱うのは、4つのうち「ドキュメント」の1つだけです。残り3つを扱ったことにはなりません。

② 「スキーマがないから楽」は誤解

MongoDB を勧める文章で、最もよく見る売り文句がこれです。

「スキーマレスだから、ALTER TABLE が要らない。設計しなくていい」

前半は本当です。後半は嘘です。

ORMとマイグレーションの回で、列を1本足すのにマイグレーションを書きました。MongoDB では、その手続きが本当に要りません。 新しい項目を持ったドキュメントを、そのまま入れられます。

では、何が起きるか。

tasks に、こういうデータが混ざります。

{ "title": "買い物",   "done": false }
{ "title": "掃除",     "completed": true }
{ "title": "洗濯",     "done": "false" }
{ "titel": "ゴミ出し", "done": false }

4件とも、MongoDB は何も文句を言わずに受け取ります。 そして、

  • 2件目は done ではなく completed(書いた人が違う)
  • 3件目は 真偽値ではなく文字列の "false"(if (task.done) が真になる)
  • 4件目は title の綴りを間違えている(一覧に空欄で出る)

MySQL なら、全部その場でエラーになっていました。 列が無い、型が違う、と。

スキーマは消えていません。 「done は真偽値である」という決まりは、依然として必要です。 変わったのは、その決まりを誰が守らせるかだけです。データベースが守っていたものを、これからはアプリのコードが守ります。

「入れる場所が変わるだけ」 — これがこの記事で一番覚えてほしい一文です。

そして場所が変わると、性質も変わります。

スキーマをDBが持つ(MySQL)スキーマをアプリが持つ(MongoDB)
違反したとき入る前に落ちる。 データは常に正しい入ってしまう。 読むときに初めて気づく
直すときALTER TABLE(マイグレーション)コードを直す。既存のデータは古いまま残る
守る範囲そのDBに繋ぐ全員(別のアプリ、手打ちの mysql も)そのコードを通った分だけ
速さ変更に手続きが要るすぐ変えられる

最後の行だけを見て「楽」と言っているのが、あの売り文句の正体です。上の3行を引き受ける覚悟とセットでないと成立しません。

MongoDB 自身も、この問題を認めています。 「JSON Schema バリデーション」という機能があり、コレクションに「この形以外は入れるな」という決まりを設定できます。 つまり、実運用ではスキーマを書き戻すことになるわけです。であれば、最初から表で持つほうが素直ではないか — これがこの記事の最後の結論に繋がります。

③ Docker Compose で MongoDB を立てる

apt では入れません。 MongoDB は Ubuntu の標準リポジトリに無く、公式リポジトリを足す手順が要ります。そして、この記事のあと消す予定のものです。

Composeの回でやったとおり、ファイル1枚で立てて、1コマンドで消せる形にします。

bash
$ mkdir -p ~/mongo
$ cd ~/mongo
$ nano compose.yaml
services:
  mongo:
    image: mongo:8
    restart: unless-stopped
    environment:
      MONGO_INITDB_ROOT_USERNAME: ${MONGO_USER}
      MONGO_INITDB_ROOT_PASSWORD: ${MONGO_PASS}
    ports:
      - "127.0.0.1:27017:27017"
    volumes:
      - mongo-data:/data/db

volumes:
  mongo-data:

ports: を外に出さない

この1行が、この節で一番大事です。

    ports:
      - "127.0.0.1:27017:27017"

よくある書き方は - "27017:27017" です。これを書いてはいけません。

27017:27017 と書くと、VMの全てのネットワーク接続先で待ち受けます。 つまり、同じネットワークにいる他の機械から、そのまま繋がります。 MySQLの回でもRedisの回でも同じ話をしました。データベースは外に出しません。

しかも、Docker には固有の落とし穴があります。

ufw で 27017 を塞いでも、Docker が公開したポートは通ってしまいます。 Docker はファイアウォールの手前に自分の転送規則を差し込むため、ufw status が「拒否」と表示していても、外から繋がることがあります。

だから、ufw に頼るのではなく、ports: の左側で縛ります。 127.0.0.1: を頭に付けると、VM自身からしか繋がりません。

一番安全なのは、そもそも ports: を書かないことです。書かなければ、外にも、VM自身にも公開されません。 それでも docker compose exec でコンテナの中には入れます。

この記事で 127.0.0.1: 付きで公開しているのは、⑦ で ~/server の Node.js から繋ぐためだけです。⑦ をやらないなら、ports: の3行はまるごと消してください。

パスワードを直書きしない

Composeの回と同じで、compose.yaml に生では書きません。

bash
$ cd ~/mongo
$ printf 'MONGO_USER=root\nMONGO_PASS=%s\n' "$(openssl rand -base64 18 | tr -d '/+=')" > .env
$ chmod 600 .env
$ cat .env
MONGO_USER=root
MONGO_PASS=xxxxxxxxxxxxxxxxxxxxxx

この MONGO_PASS は、あとで使うので控えてください。 ~/mongo/.env に入っています。 .env は絶対に Git に上げないでください。 GitHubの回で .gitignore に入れたのと同じ扱いです。

上げる

bash
$ cd ~/mongo
$ docker compose up -d
$ docker compose ps
NAME            IMAGE     STATUS         PORTS
mongo-mongo-1   mongo:8   Up 12 seconds  127.0.0.1:27017->27017/tcp

PORTS の欄に 127.0.0.1: が付いていることを確認してください。 ここが 0.0.0.0:27017->27017/tcp になっていたら、外に出ています。 compose.yaml を直して docker compose up -d をやり直します。

[スクリーンショット: 01_compose_ps.png] docker compose ps の出力を撮ってください。PORTS 欄が 127.0.0.1:27017->27017/tcp になっていることが分かるように写してください。

外から繋がらないことを、実際に確かめます。 ホストのWindows側の PowerShell で打ちます。

PowerShell
PS> Test-NetConnection -ComputerName VMのIPアドレス -Port 27017
TcpTestSucceeded : False

False が正解です。 繋がってしまったら、ports: の書き方を見直してください。

④ 同じタスク一覧を、ドキュメントとして入れてみる

新しい題材は使いません。 MySQLの回からずっと使っている tasks を、そのまま MongoDB に入れ直します。 同じものを両方に入れるから、違いが見えます。

mongosh はコンテナの中に入っています。

bash
$ cd ~/mongo
$ docker compose exec mongo mongosh -u root -p "$(grep MONGO_PASS .env | cut -d= -f2)" --authenticationDatabase admin
Current Mongosh Log ID: ...
Using MongoDB:          8.0.x
test>

test> が出たら入れています。ここから先は SQL ではなく JavaScript です。

データベースとコレクションを決める

use appdb

CREATE DATABASE に当たるものはありません。 use した時点ではまだ存在しません。 最初の1件を入れた瞬間に、勝手に作られます。 コレクションも同じです。 CREATE TABLE は要りません。これが「スキーマレス」の実際の見え方です。

1件入れる(INSERT)

db.tasks.insertOne({ title: "買い物に行く", done: false, createdAt: new Date() })
{
  acknowledged: true,
  insertedId: ObjectId('66d...')
}

insertedId に注目してください。 MySQL では id が 1, 2, 3 と増えていきました。MongoDB は _id という項目を自動で作り、ObjectId という12バイトの値を入れます。

連番ではないのは、意図的です。サーバーが複数台あっても、相談せずに一意な値を作れるようにするためです。「1台の採番係」を置かない、という思想がここに出ています。

まとめて入れる

db.tasks.insertMany([
  { title: "掃除する", done: true,  createdAt: new Date() },
  { title: "洗濯する", done: false, createdAt: new Date() },
  { title: "本を読む", done: false, createdAt: new Date(), tags: ["趣味"] }
])

4件目に tags を足しました。 何も起きません。 これが ② で書いた話です。

取り出す(SELECT)

db.tasks.find()
db.tasks.find({ done: false })
db.tasks.find({ done: false }, { title: 1, _id: 0 })
db.tasks.find({ done: false }).sort({ createdAt: -1 }).limit(2)
db.tasks.countDocuments({ done: false })

書き換える・消す

db.tasks.updateOne({ title: "洗濯する" }, { $set: { done: true } })
db.tasks.deleteOne({ title: "本を読む" })

SQLとの対応表

新しい概念はほとんどありません。 書き方が違うだけです。

やることSQL(MySQL)MongoDB
入れ物テーブルコレクション
1件行(row)ドキュメント
項目カラムフィールド
主キーid(AUTO_INCREMENT)_id(ObjectId)
1件追加INSERT INTO tasks (title) VALUES ('買い物')db.tasks.insertOne({ title: "買い物" })
全件SELECT * FROM tasksdb.tasks.find()
絞るSELECT * FROM tasks WHERE done = 0db.tasks.find({ done: false })
列を選ぶSELECT title FROM tasksdb.tasks.find({}, { title: 1, _id: 0 })
並べるORDER BY created_at DESC.sort({ createdAt: -1 })
件数制限LIMIT 2.limit(2)
数えるSELECT COUNT(*) FROM tasksdb.tasks.countDocuments()
書き換えUPDATE tasks SET done = 1 WHERE id = 3db.tasks.updateOne({ _id: ... }, { $set: { done: true } })
消すDELETE FROM tasks WHERE id = 3db.tasks.deleteOne({ _id: ... })
索引を張るCREATE INDEX ... ON tasks (done)db.tasks.createIndex({ done: 1 })
集計GROUP BYdb.tasks.aggregate([...])
結合JOIN$lookup(後述。使いたくない)

一番下の行が、⑤ の主役です。

WHERE を忘れる事故は、こちらにもあります

MySQLの回で、WHERE を忘れた UPDATE で全行が飛ぶ話をしました。MongoDB にも同じ形の事故があります。

db.tasks.deleteMany({})

条件が空の {} は「全件」を意味します。 deleteMany({}) はコレクションを空にします。 updateMany({}, ...) も同じです。

{} は「条件なし」ではなく「全部に一致」です。打つ前に必ず db.tasks.countDocuments({ 条件 }) で件数を見てください。 SQL側と同じ習慣です。

索引はこちらでも要ります

「NoSQL だから速い」も誤解です。

db.tasks.find({ done: false }).explain("executionStats").executionStats.totalDocsExamined

索引が無ければ、MongoDB も全件を見に行きます。 パフォーマンス改善の回で EXPLAIN を読んだのと、まったく同じ話です。COLLSCAN と出ていたら全件走査です。

db.tasks.createIndex({ done: 1 })

索引の考え方は、SQL側で身に付けたものがそのまま使えます。 NoSQLに移っても、この仕事は消えません。

⑤ 向いている形と、向いていない形

ここが山場です。 使い方は今ので全部です。問題は「いつ使うか」です。

向いていない形 — 結合が多いデータ

具体例で見ます。 認証の回で users を作り、タスクに持ち主が付きました。ここに「プロジェクト」と「コメント」が増えたとします。

  • ユーザー は複数の プロジェクト に所属する
  • プロジェクト は複数の タスク を持つ
  • タスク には複数の コメント が付く
  • コメント を書いたのは ユーザー

SQL側では、これは1文で書けます。

SELECT t.title, u.name, COUNT(c.id)
FROM tasks t
JOIN users u ON u.id = t.user_id
JOIN comments c ON c.task_id = t.id
GROUP BY t.id

MongoDB では、$lookup で似たことができます。できますが、

  • 書くのが JOIN の何倍も長い(配列と入れ子の組み立てを自分で書く)
  • 結合先のコレクションに索引が無いと、極端に遅くなる
  • 3つ、4つと繋ぐと、まず読めない

$lookup は「できるが、そのために作られていない」機能です。 「JOIN が要るなら、それは表で持つべきデータ」 — これが一番実用的な判断基準です。

そして、逃げ道として「じゃあ埋め込めばいい」と言われます。 タスクの中にユーザー名を入れてしまえばいい、と。

{ "title": "買い物", "user": { "id": 3, "name": "田中" } }

このとき、田中さんが改名したら何が起きるか。

田中さんが書いた全てのドキュメントを探し出して、全部書き換える必要があります。 これが「正規化していない」状態そのものです。SQL側では user_id だけ持って、名前は1箇所にしか置きませんでした。そのありがたみは、崩してみて初めて分かります。

まとめると、こうです。

データの性質向く先
あちこちから参照されるSQL側(1箇所に置いて、IDで指す)
後から名前や属性が変わるSQL側
結合して集計するSQL側

向いている形 — 形が決まっていないデータ

逆に、MongoDB が明確に強いのはここです。

例1: 商品

  • 本には 著者・ページ数・ISBN
  • 服には サイズ・色・素材
  • 食品には 賞味期限・原材料・アレルギー表示

SQL側でこれをやると、地獄になります。 選択肢は3つあって、全部つらいです。

  1. 全部の列を1つの表に持つ → 本の行では服の列が全部 NULL。列が100本を超える
  2. カテゴリごとに表を分ける → 「全商品を1つの一覧に出す」ができなくなる
  3. 商品ID・項目名・値 の表を作る → 何にでも入るが、検索も型もSQLでは面倒

MongoDB なら、そのまま入ります。

{ "name": "SQL入門", "type": "book",  "author": "山田", "pages": 320 }
{ "name": "Tシャツ", "type": "cloth", "size": "M", "color": "白" }

例2: 外部APIの応答をそのまま保存する

返ってくるJSONの形を、こちらが決められません。 相手の都合で項目が増えます。「来たものをそのまま置いておく」用途に、ドキュメント型はそのまま嵌まります。

例3: ログ・イベント

種類ごとに付いている項目が違い、後から結合しない。 書き込みが多く、1件ずつが独立している。

共通しているのは、この2つです。

① 形が事前に決まらない ② 1件が自己完結していて、他と結合しない この2つが揃ったときが、ドキュメント型の出番です。

正直に書きます: 「タスク一覧」はどちらでもよい

ここまで散々 MongoDB に入れてきましたが、はっきり書きます。

この記事で入れた tasks は、MongoDB で持つ理由がありません。 そして、MySQL で持つ理由も、決定的なものはありません。

なぜなら、この規模だからです。

  • 数千件しかない(どちらでも一瞬)
  • 形が決まっている(title と done と createdAt)
  • 結合も、ユーザーとの1本だけ

「どちらでも動く」領域が、実は一番広いです。技術選定の記事は、たいてい極端な例で比べます。 1億件の書き込み、10段のJOIN。しかし、あなたが作るものの多くは、その中間にあります。

では、中間ではどうするか。 それが ⑧ です。

⑥ トランザクションは使えるが、設計思想が違う

トランザクションの回で、送金の途中でプロセスを殺して3000円を消しました。MongoDB で同じことを試します。

const s = db.getMongo().startSession()
s.startTransaction()
s.getDatabase("appdb").tasks.insertOne({ title: "試し" })
MongoServerError: Transaction numbers are only allowed on a replica set member or mongos

エラーになります。(startTransaction() の時点ではまだ何も送られず、中で最初の操作をしたときに出ます)そして、これは壊れているわけではありません。

MongoDB の複数ドキュメントにまたがるトランザクションは、「レプリカセット」構成でないと使えません。 いま立てたのは1台構成(standalone)なので、そもそも機能が有効になっていません。

MySQL では、入れた瞬間から START TRANSACTION が打てました。 この差が、思想の差です。

1つのドキュメントの中は、常に原子的

ただし、これは常に保証されています。

db.tasks.updateOne(
  { title: "掃除する" },
  { $set: { done: true }, $push: { history: { at: new Date(), by: "田中" } } }
)

1つのドキュメントへの1回の更新は、何をどれだけ書き換えても「全部やるか、1つもやらないか」です。 途中まで書けた状態は、絶対に発生しません。

つまり、MongoDB の設計はこう言っています。

MySQL の考え方MongoDB の考え方
データの分け方正規化して、表に分ける一緒に更新するものは、1つのドキュメントに入れる
整合性の取り方トランザクションで、複数の表をまとめるそもそも1件で完結させて、トランザクションを不要にする
注文と明細orders と order_items の2表order の中に items: [...] を配列で持つ

「注文と明細」の行が分かりやすいです。SQL側では2つの表に分け、前回のようにトランザクションで囲みました。MongoDB では、明細を注文の中に配列で入れます。 そうすれば1件の更新で済み、トランザクションが要りません。

「トランザクションが使える/使えない」ではなく、「トランザクションが要る形にしない」。これが設計思想の違いです。

使いたい場合(参考)

1台でもレプリカセットとして動かせば使えます。 compose.yaml に command を足します。

    command: ["--replSet", "rs0", "--keyFile", "/data/keyfile"]

ただし、認証を有効にしたレプリカセットには鍵ファイルの用意が要り、接続文字列にも directConnection=true が必要になります。

この記事では、ここまでにします。 やらなくても、⑦ まで進めます。

覚えておいてほしいのは1つだけです。 「MongoDB でもトランザクションは使えます」と書いてある記事は、その前提(レプリカセット)を省いていることがある、ということです。素の1台では使えません。

⑦ Node.js から繋ぐ

最後に、~/server から繋ぎます。 Node.jsのAPIの回から育ててきたアプリです。

bash
$ cd ~/server
$ npm install mongodb

接続情報を .env に足します。

bash
$ nano ~/server/.env
MONGO_URL=mongodb://root:さっき控えたパスワード@127.0.0.1:27017/?authSource=admin

authSource=admin を忘れないでください。 これが無いと Authentication failed になります。「どのデータベースにそのユーザーが登録されているか」を指定する項目で、MONGO_INITDB_ROOT_USERNAME で作ったユーザーは admin に登録されます。 127.0.0.1 になっていることも確認してください。 ③ で ports: を絞ったので、VM自身からしか繋がりません。

繋いで、取り出すだけの小さなファイルを作ります。

bash
$ nano ~/server/mongo-test.js
const { MongoClient } = require("mongodb");

async function main() {
  const client = new MongoClient(process.env.MONGO_URL);
  await client.connect();

  const tasks = client.db("appdb").collection("tasks");

  await tasks.insertOne({ title: "Nodeから入れた", done: false, createdAt: new Date() });

  const list = await tasks.find({ done: false }).sort({ createdAt: -1 }).limit(5).toArray();
  console.log(list);

  await client.close();
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});
bash
$ node --env-file=.env mongo-test.js
[
  {
    _id: new ObjectId('66d...'),
    title: 'Nodeから入れた',
    done: false,
    createdAt: 2026-09-08T02:10:33.412Z
  },
  ...
]

[スクリーンショット: 02_node_mongo.png] node --env-file=.env mongo-test.js を実行して、ドキュメントの配列が表示された画面を撮ってください。

気づいてほしい点が3つあります。

  1. mongosh で打った命令と、コードがほぼ同じ形です。db.tasks.find(...) がそのまま tasks.find(...) になっただけ。SQLのように「文字列を組み立てて渡す」形ではありません
  2. 文字列を組み立てないので、SQLインジェクションと同じ形の事故は起きにくいです。ただし「起きない」ではありません。 利用者の入力をそのまま検索条件のオブジェクトに入れると、{ "$ne": null } のような演算子を送り込まれることがあります(NoSQLインジェクション)。入力は必ず型を確かめてから使います
  3. _id は ObjectId という専用の型です。JSONで返すと文字列になり、受け取った文字列でそのまま検索しても一致しません。 new ObjectId(文字列) に変換する必要があります

3つ目は、必ず1回はハマります。 「一覧は出るのに、詳細ページが404になる」の正体がこれです。

ここまで来たら、~/server の app.js に MongoDB のルートを足すこともできます。 ただしこの記事では足しません。 理由は次の節です。

⑧ 結局どちらを選ぶか — 迷ったらリレーショナル

判断の材料は出そろいました。まとめます。

まず、この質問に答える

質問はい →いいえ →
保存するデータの形が、事前に決まっているかSQL側ドキュメント型を検討
複数の種類をまたいで集計・結合するかSQL側ドキュメント型でもよい
「全部やるか、1つもやらないか」が要る操作があるかSQL側どちらでも
お金・在庫・権限を扱うかSQL側どちらでも
1件が自己完結していて、後から他と繋がないかドキュメント型SQL側

そして、迷ったらリレーショナルにする

理由を4つ書きます。「みんなが使っているから」ではありません。

理由1: 間違えたときのやり直しが利く。 表からドキュメントへは、いつでも移せます。 SQLの結果をJSONにして入れるだけです。逆は簡単ではありません。 形が揃っていないドキュメントの山を、あとから表に流し込むには、まず形を揃える作業が要ります。 そしてその作業は、データが増えてからでは終わりません。

理由2: 制約を外すのは簡単、後から掛けるのは難しい。 ② で書いたとおりです。最初から「done は真偽値」と決めておけば、違反したデータは1件も存在しません。 後から決めると、既に入っている違反データを全部直してからでないと、決まりを適用できません。

理由3: 要件は必ず「結合」の方向に増える。 「タスクだけ」で終わるアプリはありません。 ユーザーが付き、プロジェクトが付き、コメントが付き、「先月、誰が何件終わらせたか」を聞かれます。⑤ で見たとおり、その方向の変化に強いのは表のほうです。

理由4: 分からないことを調べやすい。 SQLは半世紀近く使われている共通語です。詰まったときに出てくる情報の量が違います。そして、パフォーマンス改善の回でやった EXPLAIN のような道具も、SQL側のほうが充実しています。

「迷ったら」というのは、「決め手が無いなら」という意味です。 ⑤ で見た「向いている形」に、あなたのデータがはっきり当てはまるなら、迷っていません。 そのときは MongoDB を選んでください。

そして、両方使ってよい

最後に、一番実用的な答えを書きます。

選ぶのは「どちらか一方」ではありません。

あなたはもう、それをやっています。

置き場所何を置いているか
MySQL消えたら困るもの。 タスク、ユーザー
Redis消えてもいいもの。 キャッシュ、セッション
(もし要るなら)MongoDB形が決まらないもの。 外部APIの応答、種類ごとに項目が違うデータ

これが システム設計の回で見た考え方そのものです。役の違うものを、役ごとに置く。 Redisの回で「Redis は MySQL の代わりではない」と書いたのと、まったく同じことを、いま MongoDB について書いています。

ただし、

1つ増やすたびに、バックアップも、監視も、更新も、事故対応も1セット増えます。 「使い分けられる」は「使い分けるべき」ではありません。 1つで足りるなら、1つが正解です。

つまずいたところ

症状原因
docker compose up -d が image not foundイメージ名は mongo。mongodb ではありません
コンテナが起動直後に落ちるdocker compose logs mongo を見る。MONGO_INITDB_ROOT_PASSWORD が空のことが多い(.env の場所は compose.yaml と同じフォルダ)
古いCPUでコンテナが即終了するMongoDB 5.0 以降は AVX 命令が要ります。 VMの設定で仮想化支援が切れていると落ちます。docker compose logs に Illegal instruction
MongoServerError: Authentication failedauthSource=admin を付けていない、またはパスワード違い
mongosh が繋がるのに Node から繋がらないports: を書いていない。 コンテナの中からは繋がるが、VMからは繋がらない
ECONNREFUSED 127.0.0.1:27017コンテナが落ちている。docker compose ps
docker compose ps の PORTS が 0.0.0.0:27017外に出ています。 ports: を "127.0.0.1:27017:27017" に直して上げ直す
ufw で塞いだのに外から繋がる正常な挙動(そういう仕組み)です。 Docker の公開ポートは ufw より手前にあります。ports: の左側で縛ってください
Transaction numbers are only allowed on a replica set1台構成では複数ドキュメントのトランザクションは使えません。 ⑥ のとおり
一覧は出るのに1件が取れない_id は文字列ではなく ObjectId。 new ObjectId(id) に変換する
insertOne は成功するのに find で出ないuse したデータベース名が違う。 db.getName() で確認
db.tasks.find() が Type "it" for more で切れる正常。 20件ずつ表示されます。it で続き、.toArray() で全部
updateOne が { done: true } を渡して怒られる$set が要ります。 { $set: { done: true } }。$set 無しで渡すと、ドキュメント全体が置き換わります(他の項目が消える)
コレクションが空になったdeleteMany({}) を打っていないか確認。 {} は全件です

後片づけ

MongoDB は、動かしているだけでメモリを食います。 使えるメモリの半分近くを勝手に確保しにいく設定が既定です。学習用のVMでは、これが効きます。

入れたまま忘れると、次の回で「なぜか重い」の犯人になります。 使わないなら消してください。

止めるだけ(データは残る)

bash
$ cd ~/mongo
$ docker compose down

データごと消す

bash
$ cd ~/mongo
$ docker compose down -v
$ docker volume ls | grep mongo

-v を付けると名前付きボリュームごと消えます。 Composeの回でやったとおり、戻せません。 grep で何も出なければ消えています。

イメージも消す(1GB近くあります)

bash
$ docker rmi mongo:8
$ docker system df

練習用のファイルを消す

bash
$ rm ~/server/mongo-test.js

~/server/.env の MONGO_URL の行も消しておいてください。 繋がらない先を指したままの設定は、あとで自分を混乱させます。

appdb(MySQL)、Redis、~/server は残してください。 この回で消えるのは MongoDB だけです。

まとめ

  • 「NoSQL」は1つのソフトではない。 キーバリュー / ドキュメント / 列指向 / グラフの総称。この記事はそのうち1つしか扱っていない
  • Redis はキーバリュー型の NoSQL。 あなたはもう NoSQL を使っている
  • 「MySQL から NoSQL へ乗り換える」という文は成立しない。 役が違うものが増えただけ
  • 「スキーマがないから楽」は誤解。 スキーマは消えず、アプリ側に移る。 入れる場所が変わるだけ
  • 場所が変わると性質も変わる。 DBが守れば全員に効くが、アプリが守るとそのコードを通った分だけ
  • MongoDB には JSON Schema バリデーションがある。 実運用では結局スキーマを書き戻すことになる
  • ports: を外に出さない。 "127.0.0.1:27017:27017" と書く。要らないなら書かない
  • ufw で塞いでも Docker の公開ポートは通る。 ファイアウォールではなく ports: の左側で縛る
  • SQLとの対応は、ほぼ書き方の違いだけ。 テーブル=コレクション、行=ドキュメント、WHERE=find の引数
  • {} は「条件なし」ではなく「全部に一致」。 deleteMany({}) はコレクションを空にする
  • NoSQL だから速い、ではない。 索引が無ければ全件走査するのは同じ
  • 結合が多いデータには向かない。 JOIN が要るなら、それは表で持つべきデータ
  • 埋め込みで逃げると、改名のたびに全件書き換えになる。 正規化の価値は、崩すと分かる
  • 形が決まっていないデータには向く。 ① 形が事前に決まらない ② 1件が自己完結している、の2つが揃ったとき
  • 「タスク一覧」はどちらでもよい。 どちらでも動く領域が一番広い
  • 1台構成では、複数ドキュメントのトランザクションは使えない。 レプリカセットが前提
  • 1つのドキュメントへの1回の更新は、常に原子的。 だから「1件に収める」設計になる
  • _id は ObjectId。 文字列のまま検索しても一致しない
  • NoSQLインジェクションはある。 入力をそのまま検索条件のオブジェクトに入れない
  • 迷ったらリレーショナル。 ①移行が片方向 ②制約は後から掛けにくい ③要件は結合の方向に増える ④情報が多い
  • ただし、両方使ってよい。 1つ増やすたびに運用も1セット増えることを引き受けるなら

参考リンク


次に読む

この記事は 【第5段階】バックエンドとデータベース の 16 / 29 本目です。

記事
← 前の記事MySQLとPostgreSQLの違いは1割 — 移して確かめる
→ 次の記事SQLiteはおもちゃではない — 用途で選ぶデータベース

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Backend›Databases
  • NoSQL databases
  • MongoDB
  • スキーマの置き場所

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次