C言語+MySQL入門|DELETEで商品を削除する

C言語+MySQL入門|DELETEで商品を削除する
前の記事では、C言語からUPDATEを実行し、商品の名前と価格を変更しました。今回は、DELETEを使って商品を削除してみましょう。
DELETEでは、削除する商品を正しく指定することが大切です。また、商品に入出庫履歴が残っている場合は、その履歴との関係も確認する必要があります。
この記事では、前の記事で変更した商品を例に、次の内容を解説します。
- DELETEで商品を削除するSQLの書き方
- 商品IDと在庫数で削除対象を限定する方法
- 入出庫履歴がある商品を削除できない理由
- C言語からDELETEを実行するプログラム
- MySQLクライアントで削除結果を確認する方法
- SQLの実行成功と、実際に削除された行数の違い
今回のサンプルでは、在庫数が0で、入出庫履歴のない学習用の商品を削除します。
DELETEは商品情報の行を削除する
INSERTは新しい行を追加し、UPDATEは既存の行の内容を変更します。DELETEは、条件に一致する行をテーブルから削除します。
| SQL | 商品情報に対する操作 |
|---|---|
| INSERT | 新しい商品を登録する |
| UPDATE | 登録済みの商品情報を変更する |
| DELETE | 登録済みの商品情報の行を削除する |
DELETEで商品を削除すると、商品名だけでなく、その行に含まれる商品ID、価格、在庫数、登録日時もまとめて削除されます。productsテーブルそのものは残ります。
たとえば、商品IDが4の商品を削除した場合、商品IDが4の行がなくなります。ほかの商品が自動的に繰り上がって、商品IDが4になるわけではありません。
図1:DELETEで条件に一致する商品だけを削除する

この図から分かること
DELETEでは、条件に一致した商品の行が削除されます。
商品IDを指定すれば、どの商品を削除するのかを明確にできます。削除後も、ほかの商品情報や商品IDはそのまま残ります。
商品IDと在庫数で削除対象を限定する
今回実行するSQLは、次のとおりです。
DELETE FROM products
WHERE product_id = 4
AND stock = 0;このSQLは、次の2つの条件を両方満たす商品を削除します。
- 商品IDが4である
- 在庫数が0である
各部分の役割を確認しましょう。
| SQLの部分 | 役割 |
|---|---|
| DELETE FROM products | productsテーブルから行を削除する |
| WHERE product_id = 4 | 商品IDが4の行を対象にする |
| AND stock = 0 | 在庫数が0の行に限定する |
ANDは、複数の条件をすべて満たす場合に対象とするための指定です。
productsテーブルのproduct_idは主キーなので、同じ商品IDを持つ行は複数存在しません。そのため、このSQLで削除される行数は最大1行です。
なお、商品IDの4は説明用の例です。 前の記事で登録・変更した商品のIDが別の番号だった場合は、この記事のSQLとCプログラムにある商品IDを、実際の番号に置き換えてください。
WHEREを省略すると全商品が削除対象になる
DELETEのWHEREは、削除対象を限定するための条件です。WHEREを省略すると、テーブル内のすべての行が削除対象になります。
今回のサンプルでは、商品IDと在庫数を指定したSQLを使います。実行前に、次の点を確認しましょう。
- 削除対象のテーブルがproductsになっている
- WHEREに実際の商品IDが指定されている
- stock = 0が指定されている
- 削除する商品が、今回の学習用の商品である
在庫数が0という条件だけでは、複数の商品が対象になる可能性があります。商品IDと組み合わせることで、対象の商品を限定できます。
在庫数が0でも、入出庫履歴がある商品は削除しない
第3章では、商品情報を保存するproductsテーブルと、入出庫履歴を保存するstock_historyテーブルを作成しました。
stock_historyのproduct_idは、productsのproduct_idを参照しています。この関係を守るために、外部キー制約が設定されています。
今回のデータベースでは、ON DELETE RESTRICTを指定しています。参照する履歴が存在する場合、MySQLは商品側の行の削除を拒否します。
たとえば、ある商品を10個入庫し、その後10個出庫すると、在庫数は0になります。しかし、入庫と出庫の履歴は残っています。
つまり、次の2つは別の条件です。
| 確認すること | 意味 |
|---|---|
| 在庫数が0である | 現在、その商品の在庫がない |
| 入出庫履歴がない | その商品を参照する履歴の行がない |
今回の削除では、WHEREに指定したstock = 0で在庫数を確認し、外部キー制約で履歴との関係を守ります。
在庫数の確認はSQLの条件、履歴との関係の確認は外部キー制約が担当すると考えると、役割を整理しやすくなります。
図2:在庫数と入出庫履歴の両方を確認する

この図から分かること
在庫数が0でも、入出庫履歴が残っている商品はあります。
履歴がある商品の削除を拒否することで、履歴が参照している商品情報を保護できます。削除エラーになった場合は、商品の状態と履歴を確認しましょう。
この記事では、実際の入出庫履歴がある商品は残す扱いにします。削除を通すために履歴を消したり、外部キー制約を外したりする必要はありません。
MySQLクライアントで削除前の状態を確認する
Cプログラムを実行する前に、MySQLクライアントで対象の商品と履歴を確認します。
前の記事からMySQLクライアントを開いたままなら、その画面を使えます。新しく接続する場合は、Windowsのコマンドプロンプトで次のコマンドを実行してください。
chcp 65001
cd /d "C:\Program Files\MySQL\MySQL Server 8.4\bin"
mysql --protocol=TCP --default-character-set=utf8mb4 -h 127.0.0.1 -P 3306 -u inventory_user -pMySQLのインストール先が異なる場合は、binフォルダーのパスを実際の場所に合わせてください。パスワードの入力を求められたら、inventory_userに設定したパスワードを入力します。
接続後、次のSQLを実行します。
USE inventory_db;
SELECT product_id, product_name, price, stock
FROM products
WHERE product_id = 4;
SELECT COUNT(*) AS history_count
FROM stock_history
WHERE product_id = 4;削除前の実行結果の例
前の記事で商品IDが4の商品を変更した場合、最初のSELECTでは次の行が表示されます。ここでは、クライアントの表示内容を表に整理しています。
+------------+--------------------------+--------+-------+
| product_id | product_name | price | stock |
+------------+--------------------------+--------+-------+
| 4 | 蛍光ペン(黄色) | 180.00 | 0 |
+------------+--------------------------+--------+-------+
1 row in set (0.00 sec)続くSELECTでは、その商品を参照する履歴の件数が表示されます。
+---------------+
| history_count |
+---------------+
| 0 |
+---------------+
1 row in set (0.00 sec)この例では、次の状態を確認できました。
- 商品IDが4の商品が存在する
- 商品名は蛍光ペン(黄色)である
- 在庫数は0である
- 入出庫履歴は0件である
商品が表示されない場合は、指定したIDが正しいか確認してください。在庫が残っている場合や履歴がある場合は、今回の削除例の対象にはしません。
なお、この確認結果は確認した時点の状態です。確認後に別のプログラムがデータを変更する可能性もあります。そのため、DELETEにもstock = 0を指定し、履歴との関係は削除時にも外部キー制約で確認されるようにしています。
C言語からDELETEを実行する
削除前の状態を確認できたら、Cプログラムを作成しましょう。
前の記事と同じように、MySQLへの接続、SQLの実行、エラーの確認、接続の終了という順序で処理します。
在庫数が0の商品を商品IDで指定して削除するプログラム
ファイル名: delete_product.c
#include <stdio.h>
#include <stdlib.h>
#include <mysql.h>
int main(void)
{
/* 第3章で設定した接続情報を指定する */
const char *host = "127.0.0.1";
const char *user = "inventory_user";
/* 実際に設定したパスワードに合わせる */
const char *password = "InventoryPass_2026";
const char *database = "inventory_db";
unsigned int port = 3306;
/* 接続を管理するための領域を初期化する */
MYSQL *conn = mysql_init(NULL);
if (conn == NULL) {
fprintf(stderr, "mysql_init() failed.\n");
return EXIT_FAILURE;
}
/* MySQLサーバーに接続する */
if (mysql_real_connect(
conn,
host,
user,
password,
database,
port,
NULL,
0
) == NULL) {
fprintf(
stderr,
"Connection failed: %s\n",
mysql_error(conn)
);
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
puts("Connected to MySQL Server.");
/* 前の記事と同じ接続文字セットを設定する */
if (mysql_set_character_set(conn, "utf8mb4") != 0) {
fprintf(
stderr,
"Character set setup failed: %s\n",
mysql_error(conn)
);
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
puts("Connection character set: utf8mb4");
/*
* 商品IDが4で、在庫数が0の商品を削除する。
* 商品IDは、実際に登録した商品の番号に合わせる。
* 入出庫履歴がある商品の削除は、外部キー制約で拒否される。
*/
const char *sql =
"DELETE FROM products "
"WHERE product_id = 4 "
"AND stock = 0";
puts("Executing DELETE...");
/* DELETEをサーバーに送って、実行結果を確認する */
int query_result = mysql_query(conn, sql);
if (query_result != 0) {
/* 接続を閉じる前にエラー内容を表示する */
fprintf(
stderr,
"DELETE failed: %s\n",
mysql_error(conn)
);
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
/*
* 戻り値が0でも、実際に1行削除されたとは限らない。
* この記事では、MySQLクライアントで削除結果を確認する。
*/
printf("mysql_query() returned: %d\n", query_result);
puts("DELETE executed successfully.");
puts("Check the product with the MySQL client.");
/* 接続を終了する */
mysql_close(conn);
conn = NULL;
puts("Connection closed.");
return EXIT_SUCCESS;
}delete_product.cは、C:\c-mysql\chap05にUTF-8で保存してください。
接続情報と商品IDは、自分の環境に合わせて変更します。特に、商品IDの4はそのまま使えるとは限らないため、削除前に確認した番号を指定しましょう。
プログラムの処理を確認する
接続後に固定したDELETEを用意する
sqlには、実行するDELETEをC言語の文字列として格納しています。
C言語では、隣り合う文字列リテラルが1つの文字列として扱われます。そのため、プログラム中で3行に分けて書いたSQLは、次のSQLとして送信されます。
DELETE FROM products WHERE product_id = 4 AND stock = 0各文字列の境目には、SQLの単語がつながらないように空白を入れています。
今回は固定したSQLを使っているため、利用者に商品IDを入力してもらう処理はありません。入力値を伴うSQLの扱いは、第7章で学習します。
また、今回のDELETEには日本語の文字列が含まれていませんが、前の記事と設定をそろえるために、接続文字セットをutf8mb4にしています。
mysql_query()の戻り値で実行エラーを確認する
mysql_query()は、SQLの実行に成功すると0、失敗すると0以外を返します。
| query_result | プログラムの処理 |
|---|---|
| 0 | SQLの実行成功を表示し、接続を閉じる |
| 0以外 | エラー内容を表示し、接続を閉じて異常終了する |
ここで確認しているのは、SQLの実行にエラーがあったかどうかです。
たとえば、商品IDが存在しない場合も、DELETE自体は正常に実行できます。その場合は、削除された行数が0になります。
mysql_query()の戻り値と、削除された行数は別の情報です。
そのため、このプログラムでは、1件削除したと断定するメッセージは表示していません。実際の削除結果は、MySQLクライアントで確認します。
エラー内容を表示してから接続を閉じる
DELETEに失敗した場合は、mysql_error()でエラー内容を表示します。
その後、mysql_close()で接続を終了し、EXIT_FAILUREでプログラムを終了します。
エラー内容の表示を先に行うのは、接続を管理するconnが有効なうちに情報を取得するためです。
コンパイルして実行する
MSYS2 UCRT64のターミナルで、次のコマンドを実行してください。
cd /c/c-mysql/chap05
gcc -std=c17 -Wall -Wextra -Wpedantic delete_product.c -o delete_product.exe \
$(pkg-config --cflags --libs mysqlclient)
./delete_product.exepkg-configから、MariaDB Connector/Cのヘッダーファイルとライブラリに必要な設定を取得しています。
商品IDなどを変更した場合は、ファイルを保存してから、もう一度コンパイルしてください。
実行結果の例
接続とDELETEの実行に成功した場合は、次のように表示されます。
Connected to MySQL Server.
Connection character set: utf8mb4
Executing DELETE...
mysql_query() returned: 0
DELETE executed successfully.
Check the product with the MySQL client.
Connection closed.mysql_query() returned: 0は、SQLの実行が成功したことを示しています。
削除前に確認した商品が実際になくなったか、続けて確認しましょう。
MySQLクライアントで削除後の状態を確認する
MySQLクライアントで、次のSQLを実行します。
USE inventory_db;
SELECT product_id, product_name, price, stock
FROM products
WHERE product_id = 4;
SELECT COUNT(*) AS remaining_count
FROM products
WHERE product_id = 4;削除後の実行結果の例
商品IDが4の行が削除されていれば、最初のSELECTでは次のように表示されます。
Empty set (0.00 sec)これは、条件に一致する行がないという意味です。
続くSELECTの結果は、次のようになります。
+-----------------+
| remaining_count |
+-----------------+
| 0 |
+-----------------+
1 row in set (0.00 sec)削除前には商品IDが4の行が存在し、削除後には存在しなくなったことを確認できました。
通常のautocommitが有効な接続では、成功したDELETEによる変更は自動的に確定します。この記事のプログラムは、その通常の設定を前提にしています。接続を閉じても削除結果は残り、後からROLLBACKを実行しても、すでに確定した削除は取り消せません。トランザクションによる確定と取り消しは、第8章で扱います。
商品が削除されなかった場合を読み分ける
DELETEを実行しても、必ず1行削除されるわけではありません。
今回のSQLでは、商品の状態によって次のような結果になります。
| 商品の状態 | SQLの実行結果 | 商品の行 |
|---|---|---|
| 指定した商品が存在し、在庫数0、履歴なし | 成功 | 削除される |
| 指定した商品が存在し、在庫数が0以外 | 成功 | WHEREの条件に一致せず残る |
| 指定した商品が存在し、在庫数0、履歴あり | 外部キー制約によるエラー | 残る |
| 指定した商品IDが存在しない | 成功 | 削除対象がない |
在庫数が0以外の場合は、WHEREの条件に一致しないため、削除処理の対象になりません。これはSQLエラーではありません。
一方、在庫数が0で削除条件に一致していても、入出庫履歴がある場合は、外部キー制約によって削除が拒否されます。
この違いを押さえると、実行結果を落ち着いて読み取れるようになります。
図3:DELETEの実行成功と削除件数を読み分ける

この図から分かること
SQLの実行に成功しても、削除対象がなければ削除件数は0です。
また、外部キー制約によって削除が拒否された場合は、SQLの実行エラーとして扱われます。実行の成否と、削除された行数を分けて確認することが大切です。
同じプログラムをもう一度実行するとどうなるか
商品IDが4の行を削除した後に、同じプログラムをもう一度実行してみると、通常はmysql_query()の戻り値が再び0になります。
ただし、商品IDが4の行はすでに存在しないため、新たに削除される行はありません。
このDELETEでは商品IDを固定しているので、同じ名前の商品がほかにあっても、別の商品IDの行は削除対象になりません。
Cプログラムの中でも削除件数を確認できれば、SQLは成功したものの対象がなかった場合を、メッセージで伝えられるようになります。
次の記事では、mysql_affected_rows()を使って、INSERT、UPDATE、DELETEが何行に影響したのかを確認していきましょう。










