MySQLで警告メッセージを抑制する方法｜sql_notes変数の使い方を解説

MySQLでは、存在しないテーブルへの操作など、実行結果に問題がなくても「警告（Warning）」が表示されることがあります。ログを整形したい、不要なメッセージを出力させたくないといった場合は、システム変数 sql_notes をオフにすることで、これらの警告を抑制できます。

この記事では、実際のコマンド例とともに、警告の表示・非表示を切り替える手順をわかりやすく解説します。

1. sql_notes を有効にした状態（デフォルト）

まず、sql_notes を 1（有効） に設定します。MySQLのデフォルト設定でもあるため、通常は明示的に実行する必要はありません。

mysql> SET sql_notes = 1;
Query OK, 0 rows affected (0.00 sec)

2. 警告が発生する操作を試す

次に、存在しないテーブルに対して DROP TABLE IF EXISTS を実行してみましょう。IF EXISTS を付けているため処理自体は正常に完了しますが、警告が1件発生していることがわかります。

mysql> DROP TABLE IF EXISTS web.DemoTable;
Query OK, 0 rows affected, 1 warning (0.07 sec)

3. SHOW WARNINGS で警告内容を確認する

発生した警告の詳細を確認するには、SHOW WARNINGS コマンドを使用します。

mysql> SHOW WARNINGS;

実行すると、以下のように警告のレベル・コード・メッセージが表示されます。

+-------+------+-----------------------------------+
| Level | Code | Message                           |
+-------+------+-----------------------------------+
| Note  | 1051 | Unknown table 'web.DemoTable'     |
+-------+------+-----------------------------------+
1 row in set (0.00 sec)

この例では、「テーブル 'web.DemoTable' は存在しない」という内容の Note レベルの警告（エラーコード1051）が出力されています。

4. sql_notes をオフにして警告を抑制する

警告を表示させたくない場合は、sql_notes を 0（無効） に設定します。

mysql> SET sql_notes = 0;
Query OK, 0 rows affected (0.00 sec)

この状態で、先ほどと同じように存在しないテーブルに対して DROP TABLE IF EXISTS を実行してみます。

mysql> DROP TABLE IF EXISTS web.DemoTable;
Query OK, 0 rows affected (0.07 sec)

今度は「1 warning」の表示が消え、警告なしで正常に完了しました。これがMySQLにおける警告の抑制（サプレス）です。

5. 抑制後の SHOW WARNINGS の結果

警告を抑制した後に再度 SHOW WARNINGS を実行すると、以下のように「Empty set（空の結果セット）」が返されます。

mysql> SHOW WARNINGS;
Empty set (0.00 sec)

まとめ

• MySQLでNoteレベルの警告を抑制するには、SET sql_notes = 0; を実行する。
• 再度警告を表示させたい場合は、SET sql_notes = 1; に戻せばOK。
• 警告の内容は SHOW WARNINGS コマンドでいつでも確認できる。

なお、sql_notes の設定は現在のセッションにのみ適用される点に注意してください。接続ごとに必要な場合は、接続時に毎回設定するか、設定ファイル（my.cnf / my.ini）の init_connect などで対応する方法もあります。バッチ処理やスクリプト実行時にログをクリーンに保ちたいケースで、ぜひ活用してみてください。