プロセスを止めるとデータが消えるのは、メモリにしか置いていないからです。MySQLを入れて表を作り、保存して取り出すところまでやります。
前回: APIの正体はJSONを返すHTTP — Node.jsで作る 作業場所はVMの中(Ubuntu)です。前回作った
~/server/app.jsを、そのまま育てます。
前回の最後で、こういうことをしました。
追加できました。 そして Ctrl + C で止めて、立て直したら。
消えていました。
tasks はただの変数なので、プロセスが死ねば一緒に消えます。 それはそうです。
この回で、消えない場所を用意します。
対象レベル: 初級〜中級 / 区分: 必修
この記事でわかること
- ファイルに書くだけでは駄目な理由(そして、それがデータベースの存在理由であること)
- SQLは4つ覚えれば動かせるということ
WHEREを忘れたUPDATEで、全行が書き換わるという事故と、その防ぎ方- データベースを外に出してはいけない理由と、それを確認する方法
この記事でやること
- MySQL を入れて、動いていることを確認する
- テーブルを作り、SQLの4つ(
INSERT/SELECT/UPDATE/DELETE)を打つ - アプリ専用のユーザーを作る(
rootで繋がない) - Node.js から繋いで、再起動しても消えないことを確かめる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| データベース | データを保存し、探し、書き換えるための専用のソフト。 「保存する場所」ではなく「保存を仕事にしているプログラム」 |
| MySQL | そのデータベースソフトのひとつ。世界で最も使われているものの1つ |
| SQL | データベースに命令を出すための言葉。「この条件のものを出して」と書く |
| テーブル | 表のこと。Excelのシートに近い。列(項目)と行(1件ずつのデータ)でできている |
| カラム / 行 | カラム=列(title など項目名)、行=1件のデータ |
「データベース」と「MySQL」の関係は、「Webサーバー」と「nginx」の関係と同じです。 前者が役割の名前、後者がその役割をやる具体的なソフトの名前です。サーバーとは何かの回と同じ整理です。
なぜファイルに書くだけでは駄目なのか
最初に思いつくのは、これです。
fs.writeFileSync("tasks.json", JSON.stringify(tasks));
動きます。 小さいうちは、これで十分です。では何が困るのか。 4つあります。
① 同時に書くと壊れる
サーバーは同時に何人からもリクエストを受けます。
2人が同時に「追加」を押すと、両方が「いまのファイル」を読んで、両方が書き戻します。 後から書いたほうが勝ち、先の1件は消えます。
さらに悪いのは、書いている途中でもう1つの書き込みが始まったときです。ファイルが半分だけ新しい、という状態になり、JSON.parse が失敗します。全部読めなくなります。
② 途中で落ちると壊れる
書き込みの最中に電源が切れたら、ファイルは中途半端な状態で残ります。
データベースは、この対策として「全部やるか、1つもやらないか」を保証します。トランザクションと呼ばれる仕組みです(この記事では扱いませんが、名前だけ覚えておいてください)。
③ 探すのが遅い
「done が false のものを出して」を、ファイルでやると全部読んで全部調べることになります。10件なら一瞬ですが、100万件なら現実的ではありません。
データベースは索引(インデックス)を持てるので、全部を見ずに探せます。辞書に「あ行はここ」と付いているのと同じです。
④ 全部をメモリに載せられない
JSON.parse は、ファイル全体をメモリに展開します。 1GBのファイルなら1GB使います。データベースは必要な行だけ読みます。
つまり、データベースは「保存する場所」ではありません。 「同時に来ても壊れず、途中で落ちても壊れず、大量でも速く探せる」ように保存を専門にしているプログラムです。 だから、わざわざ別のソフトを立てる価値があります。
① MySQL を入れる
数百MBあるので、少し待ちます。
動いているか確認する
プロセスとサービスの回でやったとおりに確認します。
● mysql.service - MySQL Community Server
Loaded: loaded (/usr/lib/systemd/system/mysql.service; enabled; preset: enabled)
Active: active (running) since ...
active (running) と enabled。 入れた時点で起動しているし、次回の起動時にも自動で立ち上がる状態になっています。
バージョンも見ておきます。
mysql Ver 8.0.x for Linux on x86_64 ((Ubuntu))
どこで待ち受けているかを、必ず見る
ここは飛ばさないでください。
LISTEN 0 151 127.0.0.1:3306 0.0.0.0:* users:(("mysqld",pid=...,fd=...))
127.0.0.1:3306 です。0.0.0.0 ではありません。
ネットワークの回からずっと見てきた区別が、ここで逆向きに効きます。
| 意味 | |
|---|---|
0.0.0.0:3306 | どこからでも繋がる。外にも開いている |
127.0.0.1:3306 | このマシンの中からしか繋がらない |
Webサーバーのときは 0.0.0.0 にしたくて苦労しました。データベースは逆で、127.0.0.1 のままにします。
データベースを外から見えるようにしてはいけません。 データベースには中身が全部入っています。 Webサーバーは「見せるためのもの」ですが、データベースは見せないためのものです。 だから
ufwで 3306番を開ける必要はありません。 そもそも外向きに待っていないので、開けても意味がなく、開けたら危険なだけです。Docker の回で「
-pは ufw を素通りする」と書いたのは、この話に繋がります。コンテナでDBを動かすとき、うっかりports:を書くと、この防御が消えます。
[スクリーンショット: 01_mysql起動確認.png] systemctl status mysql と sudo ss -tlnp | grep 3306 を1枚に収めて撮ってください。active (running) と 127.0.0.1:3306 の両方が読めることが条件です。
② 中に入る
Welcome to the MySQL monitor. Commands end with ; or \g.
mysql>
パスワードを聞かれません。 驚くところですが、正しい動きです。
Ubuntu の MySQL は、
rootを「パスワード」ではなく「Linuxのユーザーが誰か」で認証します(auth_socketという方式)。sudoで入れる人=そのマシンの管理者なんだから、それでいい、という考え方です。 パスワードが無いのではなく、パスワードを使わないので、ここは弱点ではありません。
mysql> が出たら、ここからは SQL です。Linux のコマンドではありません。
SQLは末尾に
;(セミコロン)が要ります。 忘れると、次の行が->になって入力待ちのまま止まります。 そのとき;を打ってEnterすれば実行されます。 「Enterを押したのに何も起きない」の原因は、ほぼこれです。
抜けるときは exit です。
③ データベースとテーブルを作る
用語がまぎらわしいので先に整理します。
| 意味 | 例え | |
|---|---|---|
| MySQL | 動いているソフト本体 | 建物 |
| データベース | その中の区画。アプリごとに作る | 部屋 |
| テーブル | データを入れる表 | 部屋の中の棚 |
アプリ用の部屋を作ります。
CREATE DATABASE appdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
utf8mb4を必ず指定してください。 MySQL のutf8は中途半端で、1文字3バイトまでしか入りません。 日本語は入りますが、絵文字(4バイト)が入らずエラーになります。utf8mb4が「本当のUTF-8」です。名前が紛らわしいだけで、選択肢は1つしかありません。 HTMLの回の<meta charset="UTF-8">と同じで、最初に決めておかないと後で全部やり直しになります。
使う部屋を指定します。
USE appdb;
棚を作ります。
CREATE TABLE tasks (
id INT AUTO_INCREMENT PRIMARY KEY,
title VARCHAR(200) NOT NULL,
done BOOLEAN NOT NULL DEFAULT FALSE,
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);
1行ずつ読みます。
| 部分 | 意味 |
|---|---|
id INT | 整数の列 |
AUTO_INCREMENT | 入れるたびに自動で1ずつ増える。 番号を自分で決めなくていい |
PRIMARY KEY | この列で1行を特定する。 重複できず、空にできない |
VARCHAR(200) | 最大200文字の文字列 |
NOT NULL | 空を許さない。 タイトルの無いタスクを作らせない |
BOOLEAN | 真偽値(MySQLでは中身は 0 / 1) |
DEFAULT FALSE | 指定しなければ false |
TIMESTAMP | 日時 |
DEFAULT CURRENT_TIMESTAMP | 入れた時刻が自動で入る |
AUTO_INCREMENTは、前回の手抜きを直しています。 前回のAPIではid: tasks.length + 1としていました。これは削除すると番号がぶつかります(3件のうち2番を消すと、次に作られるのも3番)。番号の管理はデータベースに任せるのが正解です。
できたか確認します。
SHOW TABLES;
DESCRIBE tasks;
+-------------------+
| Tables_in_appdb |
+-------------------+
| tasks |
+-------------------+
④ SQLの4つ
覚えるのは4つだけです。 「入れる・見る・書き換える・消す」。
入れる — INSERT
INSERT INTO tasks (title) VALUES ('Linuxのコマンドを覚える');
INSERT INTO tasks (title, done) VALUES ('サーバーを立てる', TRUE);
INSERT INTO tasks (title) VALUES ('データベースを繋ぐ');
id と created_at は書いていません。 自動で入るからです。
見る — SELECT
SELECT * FROM tasks;
+----+--------------------------------+------+---------------------+
| id | title | done | created_at |
+----+--------------------------------+------+---------------------+
| 1 | Linuxのコマンドを覚える | 0 | 2026-09-02 15:10:22 |
| 2 | サーバーを立てる | 1 | 2026-09-02 15:10:22 |
| 3 | データベースを繋ぐ | 0 | 2026-09-02 15:10:22 |
+----+--------------------------------+------+---------------------+
* は「全部の列」です。条件を付けられます。
SELECT id, title FROM tasks WHERE done = FALSE;
SELECT * FROM tasks ORDER BY created_at DESC;
SELECT COUNT(*) FROM tasks;
| 書き方 | 意味 |
|---|---|
WHERE | 条件で絞る |
ORDER BY ... DESC | 並べ替え(DESC は降順) |
COUNT(*) | 件数を数える |
書き換える — UPDATE
UPDATE tasks SET done = TRUE WHERE id = 3;
消す — DELETE
DELETE FROM tasks WHERE id = 3;
WHERE を忘れると、全行が飛びます
この記事で一番大事なところです。
UPDATE tasks SET done = TRUE;
これは「3番を完了にする」ではありません。「全部を完了にする」です。
DELETE FROM tasks;
これは「全部消す」です。 そして、確認は出ません。Ctrl + Z もありません。
防ぎ方は1つだけです。
UPDATEやDELETEを打つ前に、同じWHEREでSELECTする。
SELECT * FROM tasks WHERE id = 3; -- ① まず見る(1行だけ出るか)
UPDATE tasks SET done = TRUE WHERE id = 3; -- ② それから書き換える
①で3行出たなら、②は3行を書き換えます。 打つ前に気づけます。
これはnginx の回の nginx -t と同じ考え方です。壊れる操作の前に、壊れない操作で確かめる。
本番で
WHEREを忘れる事故は、実際に何度も起きています。 慣れた人でも起きます。 だから「気をつける」ではなく「手順にする」しかありません。
[スクリーンショット: 02_sql_select.png] SELECT * FROM tasks; の結果が表で出ている画面を撮ってください。
⑤ アプリ専用のユーザーを作る
アプリから root で繋いではいけません。
root は全部のデータベースを消せます。 アプリのプログラムに、そこまでの力は要りません。必要な権限だけを持つユーザーを作ります。
CREATE USER 'appuser'@'localhost' IDENTIFIED BY 'ここにパスワード';
GRANT SELECT, INSERT, UPDATE, DELETE ON appdb.* TO 'appuser'@'localhost';
FLUSH PRIVILEGES;
| 部分 | 意味 |
|---|---|
'appuser'@'localhost' | このマシンの中からだけ繋げるユーザー |
GRANT SELECT, INSERT, UPDATE, DELETE | 4つの操作だけ許す |
ON appdb.* | appdb の中だけ。 他のデータベースには触れない |
FLUSH PRIVILEGES | 権限を読み直す |
CREATE TABLE や DROP は与えていません。 アプリが表を消す必要はないからです。
これは権限の回でやった「余計な権限を使わない」と、まったく同じ話です。
sudoを毎回付けないのと同じ理由で、rootで繋ぎません。 万一アプリに穴があっても、壊せる範囲がこの部屋の中に収まります。
パスワードは、その場で作って控えてください。
exit で MySQL を抜けて、確認します。
パスワードを聞かれ、入れれば mysql> が出ます。 これで専用ユーザーで入れました。
権限が絞れていることも確かめられます。
DROP TABLE tasks;
ERROR 1142 (42000): DROP command denied to user 'appuser'@'localhost' for table 'tasks'
拒否されれば成功です。 exit で抜けてください。
「拒否されること」を確認するのが大事です。 権限を絞ったつもりで絞れていない、はよくあります。絞ったら、必ず一度ぶつけて確かめてください。
⑥ Node.js から繋ぐ
ここで前回のAPIと繋がります。
パスワードをコードに書かない
app.js にパスワードを直接書かないでください。 Docker Compose の回と同じで、共有した瞬間に漏れます。
DB_USER=appuser
DB_PASSWORD=さっき作ったパスワード
DB_NAME=appdb
Git を使っているなら、必ず除外します。
つなぎ替える
~/server/app.js を、まるごと置き換えます。
const express = require("express");
const mysql = require("mysql2/promise");
const app = express();
app.use(express.json());
app.use((req, res, next) => {
res.setHeader("Access-Control-Allow-Origin", "*");
res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
res.setHeader("Access-Control-Allow-Headers", "Content-Type");
if (req.method === "OPTIONS") return res.sendStatus(204);
next();
});
// 接続を使い回す入れ物。毎回つなぎ直すと遅く、すぐ上限に当たる
const pool = mysql.createPool({
host: "127.0.0.1",
user: process.env.DB_USER,
password: process.env.DB_PASSWORD,
database: process.env.DB_NAME,
waitForConnections: true,
connectionLimit: 10,
});
app.get("/api/tasks", async (req, res) => {
try {
const [rows] = await pool.query("SELECT id, title, done, created_at FROM tasks ORDER BY id");
res.json(rows);
} catch (err) {
console.error(err);
res.status(500).json({ error: "データベースに繋がりません" });
}
});
app.post("/api/tasks", async (req, res) => {
if (!req.body.title) {
return res.status(400).json({ error: "title は必須です" });
}
try {
const [result] = await pool.query("INSERT INTO tasks (title) VALUES (?)", [req.body.title]);
const [rows] = await pool.query("SELECT id, title, done, created_at FROM tasks WHERE id = ?", [
result.insertId,
]);
res.status(201).json(rows[0]);
} catch (err) {
console.error(err);
res.status(500).json({ error: "保存できませんでした" });
}
});
app.listen(3000, "0.0.0.0", () => {
console.log("http://0.0.0.0:3000/ で待っています");
});
動かします。
--env-file=.envは Node.js が用意している読み込み方です。これでprocess.env.DB_USERに入ります。 付け忘れるとundefinedになり、「Access denied for user ''@'localhost'」というエラーになります。ユーザー名が空、という意味です。
? を使う理由 — SQLインジェクション
コードのここに注目してください。
pool.query("INSERT INTO tasks (title) VALUES (?)", [req.body.title]);
文字列を繋げていません。 もし、こう書いたら。
// 絶対に書かない
pool.query(`INSERT INTO tasks (title) VALUES ('${req.body.title}')`);
利用者がタイトルにこう入れてきたら、どうなるか。
'); DROP TABLE tasks; --
組み上がるSQLは、こうなります。
INSERT INTO tasks (title) VALUES (''); DROP TABLE tasks; --')
テーブルが消えます(複文を許す multipleStatements: true の場合。既定は無効で、そのままなら構文エラー)。 これが SQLインジェクション です。
? を使うと、渡した値は「値」としてしか扱われません。 どんな文字が入っていても、SQLの一部にはなりません。
DOM操作の回で、
innerHTMLに入力値をそのまま入れるな(XSS)と書きました。 まったく同じ形の問題です。 「利用者が入れた文字を、命令として解釈させない」。場所がブラウザかデータベースかの違いだけです。そして、さっき
appuserからDROPの権限を外したのは、この事故の被害を小さくするためでもあります。 対策は1枚では足りません。
⑦ 本当に消えないか確かめる
前回の実験の、反対側をやります。
Ctrl + C でサーバーを止めて、立て直します。
同じ件数です。
VMごと再起動しても確かめられます。
繋ぎ直して、MySQL が勝手に起動していることを確認します。
データは残っています。 mysql.service が enabled なので、MySQL は誰もログインしなくても立ち上がっています。
[スクリーンショット: 03_再起動後も残る.png] VMを再起動したあとに curl でデータが返っている画面を撮ってください。再起動したことが分かるように、uptime も一緒に写すと良いです。
つまずいたところ
| 症状 | 原因 |
|---|---|
mysql> で Enter を押しても何も起きない | ; を忘れている。 ; を打って Enter |
Access denied for user ''@'localhost' | --env-file=.env を付け忘れた(ユーザー名が空) |
Access denied for user 'appuser'@'localhost' | パスワードが違う / .env の綴り違い |
ER_NOT_SUPPORTED_AUTH_MODE | 古い接続ライブラリ。mysql ではなく mysql2 を使う |
日本語が ????? になる | utf8mb4 で作っていない。 CREATE DATABASE からやり直す |
| ホストのブラウザから 3306 に繋がらない | 正常です。 データベースは 127.0.0.1 でしか待っていません |
サービスとして常駐させている人は、ユニットを直す
サーバーとは何かの回で myserver を systemd に登録した人は、このままだと落ちます。
active と返ったら、直してください。理由は、.env を読ませていないからです。
Error: Access denied for user ''@'localhost'
ユーザー名が空になっています。手で動かすときは node --env-file=.env app.js と打っていましたが、systemd はその --env-file を知りません。
ExecStart に --env-file=.env を足します。
ExecStart=/home/ユーザー名/.nvm/versions/node/v22.14.0/bin/node --env-file=.env /home/ユーザー名/server/app.js
WorkingDirectoryが/home/ユーザー名/serverになっているのが効いています。--env-file=.envは相対パスなので、そこを起点に探します。 systemd はあなたのシェルの設定を何も引き継ぎません。PATHも環境変数も、必要なものは全部ユニットに書く、が原則です。
後片づけ
全部消してやり直したいとき。
DROP DATABASE appdb;
MySQL ごと消すとき。
~/server/とappdbは残しておいてください。 次回、テーブルを増やして関連づけ(リレーション)を扱います。
まとめ
- データベースは「保存する場所」ではなく「保存を専門にしているプログラム」。 同時に来ても壊れず、落ちても壊れず、大量でも速く探せる
- ファイルに書くだけでは、同時書き込みで壊れる。 後から書いたほうが勝ち、途中で落ちれば読めなくなる
MySQL= 建物、データベース= 部屋、テーブル= 棚utf8mb4を必ず指定する。 MySQL のutf8は3バイトまでで、絵文字が入らない- SQLは4つ。
INSERT/SELECT/UPDATE/DELETE WHEREを忘れたUPDATEは全行を書き換える。 打つ前に同じWHEREでSELECTする- データベースは
127.0.0.1でしか待っていない。 Webサーバーと逆で、外に出さないのが正しい。 ufw で開けない - アプリは
rootで繋がない。appdbに対する4つの操作だけを持つ専用ユーザーを作る。絞ったら一度ぶつけて確かめる ?を使う。 文字列を繋げて組み立てると SQLインジェクションになる。innerHTMLの XSS とまったく同じ形- パスワードは
.envに置いて.gitignore。node --env-file=.envで読む - プロセスを止めても、VMを再起動しても、データは残る。 これがこの回のゴール
参考リンク
- roadmap.sh — Backend(Databases / Relational Databases の項目)
- roadmap.sh — SQL
- MySQL 8.0 リファレンスマニュアル(日本語)
- mysql2(Node.js のドライバ)
次に読む
この記事は 【第5段階】バックエンドとデータベース の 3 / 29 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Relational Databases — MySQL
- Learn about Databases(なぜファイルでは駄目なのか)
- SQL(INSERT / SELECT / UPDATE / DELETE)
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント