プロセスを止めても消えない場所 — MySQLとSQLの基本

MySQLとSQLの基本。データベースと保存するデータカード、再起動を示す矢印。

プロセスを止めるとデータが消えるのは、メモリにしか置いていないからです。MySQLを入れて表を作り、保存して取り出すところまでやります。

前回: APIの正体はJSONを返すHTTP — Node.jsで作る 作業場所はVMの中(Ubuntu)です。前回作った ~/server/app.js を、そのまま育てます。

前回の最後で、こういうことをしました。

bash
$ curl -s -X POST http://localhost:3000/api/tasks -H "Content-Type: application/json" -d '{"title":"消えるか試す"}'

追加できました。 そして Ctrl + C で止めて、立て直したら。

消えていました。

tasks はただの変数なので、プロセスが死ねば一緒に消えます。 それはそうです。

この回で、消えない場所を用意します。

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

目次

この記事でわかること

  • ファイルに書くだけでは駄目な理由(そして、それがデータベースの存在理由であること)
  • SQLは4つ覚えれば動かせるということ
  • WHERE を忘れた UPDATE で、全行が書き換わるという事故と、その防ぎ方
  • データベースを外に出してはいけない理由と、それを確認する方法

この記事でやること

  1. MySQL を入れて、動いていることを確認する
  2. テーブルを作り、SQLの4つ(INSERT / SELECT / UPDATE / DELETE)を打つ
  3. アプリ専用のユーザーを作る(root で繋がない)
  4. 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 を入れる

bash
$ sudo apt update
$ sudo apt install -y mysql-server

数百MBあるので、少し待ちます。

動いているか確認する

プロセスとサービスの回でやったとおりに確認します。

bash
$ systemctl status mysql
● mysql.service - MySQL Community Server
     Loaded: loaded (/usr/lib/systemd/system/mysql.service; enabled; preset: enabled)
     Active: active (running) since ...

active (running) と enabled。 入れた時点で起動しているし、次回の起動時にも自動で立ち上がる状態になっています。

バージョンも見ておきます。

bash
$ mysql --version
mysql  Ver 8.0.x for Linux on x86_64 ((Ubuntu))

どこで待ち受けているかを、必ず見る

ここは飛ばさないでください。

bash
$ sudo ss -tlnp | grep 3306
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 の両方が読めることが条件です。

② 中に入る

bash
$ sudo mysql
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, DELETE4つの操作だけ許す
ON appdb.*appdb の中だけ。 他のデータベースには触れない
FLUSH PRIVILEGES権限を読み直す

CREATE TABLE や DROP は与えていません。 アプリが表を消す必要はないからです。

これは権限の回でやった「余計な権限を使わない」と、まったく同じ話です。 sudo を毎回付けないのと同じ理由で、root で繋ぎません。 万一アプリに穴があっても、壊せる範囲がこの部屋の中に収まります。

パスワードは、その場で作って控えてください。

bash
$ openssl rand -base64 18

exit で MySQL を抜けて、確認します。

bash
$ mysql -u appuser -p appdb

パスワードを聞かれ、入れれば mysql> が出ます。 これで専用ユーザーで入れました。

権限が絞れていることも確かめられます。

DROP TABLE tasks;
ERROR 1142 (42000): DROP command denied to user 'appuser'@'localhost' for table 'tasks'

拒否されれば成功です。 exit で抜けてください。

「拒否されること」を確認するのが大事です。 権限を絞ったつもりで絞れていない、はよくあります。絞ったら、必ず一度ぶつけて確かめてください。

⑥ Node.js から繋ぐ

ここで前回のAPIと繋がります。

bash
$ cd ~/server
$ npm install mysql2

パスワードをコードに書かない

app.js にパスワードを直接書かないでください。 Docker Compose の回と同じで、共有した瞬間に漏れます。

bash
$ nano ~/server/.env
DB_USER=appuser
DB_PASSWORD=さっき作ったパスワード
DB_NAME=appdb

Git を使っているなら、必ず除外します。

bash
$ echo ".env" >> ~/server/.gitignore

つなぎ替える

~/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/ で待っています");
});

動かします。

bash
$ node --env-file=.env app.js

--env-file=.env は Node.js が用意している読み込み方です。これで process.env.DB_USER に入ります。 付け忘れると undefined になり、「Access denied for user ''@'localhost'」というエラーになります。ユーザー名が空、という意味です。

bash
$ curl -s http://localhost:3000/api/tasks | jq
$ curl -s -X POST http://localhost:3000/api/tasks \
    -H "Content-Type: application/json" -d '{"title":"MySQLから読めた"}' | jq

? を使う理由 — 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枚では足りません。

⑦ 本当に消えないか確かめる

前回の実験の、反対側をやります。

bash
$ curl -s http://localhost:3000/api/tasks | jq 'length'

Ctrl + C でサーバーを止めて、立て直します。

bash
$ node --env-file=.env app.js
$ curl -s http://localhost:3000/api/tasks | jq 'length'

同じ件数です。

VMごと再起動しても確かめられます。

bash
$ sudo reboot

繋ぎ直して、MySQL が勝手に起動していることを確認します。

bash
$ systemctl is-active mysql
$ cd ~/server && node --env-file=.env app.js

データは残っています。 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 に登録した人は、このままだと落ちます。

bash
$ systemctl is-active myserver

active と返ったら、直してください。理由は、.env を読ませていないからです。

bash
$ sudo systemctl status myserver --no-pager -l | tail -n 5
Error: Access denied for user ''@'localhost'

ユーザー名が空になっています。手で動かすときは node --env-file=.env app.js と打っていましたが、systemd はその --env-file を知りません。

bash
$ sudo nano /etc/systemd/system/myserver.service

ExecStart に --env-file=.env を足します。

ExecStart=/home/ユーザー名/.nvm/versions/node/v22.14.0/bin/node --env-file=.env /home/ユーザー名/server/app.js
bash
$ sudo systemctl daemon-reload
$ sudo systemctl restart myserver
$ systemctl is-active myserver

WorkingDirectory が /home/ユーザー名/server になっているのが効いています。 --env-file=.env は相対パスなので、そこを起点に探します。 systemd はあなたのシェルの設定を何も引き継ぎません。 PATH も環境変数も、必要なものは全部ユニットに書く、が原則です。

後片づけ

全部消してやり直したいとき。

DROP DATABASE appdb;

MySQL ごと消すとき。

bash
$ sudo apt purge -y mysql-server
$ sudo apt autoremove -y

~/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を再起動しても、データは残る。 これがこの回のゴール

参考リンク


次に読む

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

記事
← 前の記事APIの正体はJSONを返すHTTP — Node.jsで作る
→ 次の記事SQLのJOINと集計 — 行が消える・増える理由とGROUP BYの基本

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

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

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

Backend›Databases
  • Relational Databases — MySQL
  • Learn about Databases(なぜファイルでは駄目なのか)
  • SQL(INSERT / SELECT / UPDATE / DELETE)

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

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

コメント

コメントする

目次