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 productsproductsテーブルから行を削除する
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 -p

MySQLのインストール先が異なる場合は、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プログラムの処理
0SQLの実行成功を表示し、接続を閉じる
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.exe

pkg-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が何行に影響したのかを確認していきましょう。

Follow me!