MySQLのPREPAREステートメントでテーブル名にユーザー定義変数を設定する方法

はじめに

MySQLのPREPAREステートメント（プリペアドステートメント）では、「?」プレースホルダはデータ値にのみ使用でき、テーブル名やカラム名を直接指定することはできません。しかし、ユーザー定義変数とCONCAT関数を組み合わせることで、テーブル名を動的に組み込んだクエリを準備・実行できます。この記事では、その具体的な手順をサンプルコード付きで解説します。

サンプルテーブルの作成

まず、テーブルを作成します。

mysql> create table DemoTable
(
    StudentId int NOT NULL AUTO_INCREMENT PRIMARY KEY,
    StudentName varchar(20)
);
Query OK, 0 rows affected (0.71 sec)

レコードの挿入

次に、INSERTコマンドを使っていくつかのレコードを挿入します。

mysql> insert into DemoTable(StudentName) values('Chris');
Query OK, 1 row affected (0.21 sec)
mysql> insert into DemoTable(StudentName) values('David');
Query OK, 1 row affected (0.06 sec)
mysql> insert into DemoTable(StudentName) values('Sam');
Query OK, 1 row affected (0.13 sec)
mysql> insert into DemoTable(StudentName) values('Mike');
Query OK, 1 row affected (0.12 sec)

レコードの確認

SELECTステートメントでテーブル内のすべてのレコードを表示してみましょう。

mysql> select * from DemoTable;

実行すると、以下のような結果が出力されます。

+-----------+-------------+
| StudentId | StudentName |
+-----------+-------------+
|         1 | Chris       |
|         2 | David       |
|         3 | Sam         |
|         4 | Mike        |
+-----------+-------------+
4 rows in set (0.00 sec)

ユーザー定義変数でテーブル名を設定してPREPAREステートメントを使う手順

それでは本題です。以下の手順で、テーブル名をユーザー定義変数として設定し、PREPAREステートメントで動的にクエリを実行できます。

1. SET文でテーブル名をユーザー定義変数に格納する
2. CONCAT関数でSQL文全体を文字列として組み立てる
3. PREPAREでそのSQL文をプリペアドステートメントとして準備する
4. EXECUTEで実行する

実際のコード例は以下の通りです。

mysql> set @tableName = 'DemoTable';
Query OK, 0 rows affected (0.04 sec)

mysql> set @queryToSelectStudentName := concat('select StudentName from ', @tableName);
Query OK, 0 rows affected (0.28 sec)

mysql> prepare executeQuery from @queryToSelectStudentName;
Query OK, 0 rows affected (0.04 sec)
Statement prepared

mysql> execute executeQuery;

実行すると、次のような結果が出力されます。

+-------------+
| StudentName |
+-------------+
| Chris       |
| David       |
| Sam         |
| Mike        |
+-------------+
4 rows in set (0.00 sec)

処理の流れを解説

• set @tableName = 'DemoTable'; … テーブル名をユーザー定義変数 @tableName に格納します。
• concat('select StudentName from ', @tableName) … 変数を連結して完全なSELECT文の文字列を生成し、@queryToSelectStudentName に代入します。
• prepare executeQuery from @queryToSelectStudentName; … 組み立てたSQL文字列を元に、executeQuery という名前のプリペアドステートメントを作成します。
• execute executeQuery; … 準備したステートメントを実行し、結果を取得します。

注意点

• PREPAREステートメントの「?」プレースホルダはWHERE句の値などデータ部分にしか使えないため、テーブル名を可変にしたい場合はこの記事のようにSQL文自体を文字列として構築する必要があります。
• テーブル名を外部入力から直接連結する場合、SQLインジェクションのリスクがあるため、事前に許可されたテーブル名かどうかを検証することを推奨します。
• 使い終わったプリペアドステートメントは DEALLOCATE PREPARE executeQuery; で明示的に解放するとよいでしょう。