パラメータ化クエリ

SQLを実行する際に、変数の値をSQLに埋め込みたい場合があります。このとき、文字列の結合でSQLを組み立てるのは非常に危険です。

1. SQLインジェクションとは

例えば、以下のように文字列結合でSQLを組み立てるコードを考えます。

# 危険な例(絶対にやってはいけない)
user_input = "'; DROP TABLE users; --"
sql = "SELECT * FROM users WHERE name = '" + user_input + "'"
cursor.execute(sql)

この場合、user_inputに悪意のある文字列が入ると、意図しないSQLが実行されてしまいます。この攻撃手法をSQLインジェクションと呼びます。上記の例では、usersテーブルが削除されてしまう可能性があります。

2. パラメータ化クエリによる対策

パラメータ化クエリ(プレースホルダ)を使用することで、SQLインジェクションを防止できます。基本的な構文は以下のとおりです。

cursor.execute("SELECT * FROM テーブル名 WHERE カラム名 = %s", (値,))

%sの部分がプレースホルダで、2つ目の引数で指定した値が安全に埋め込まれます。ライブラリが適切なエスケープ処理を行うため、SQLインジェクションのリスクを排除できます。

実際に試してみましょう。

# 安全な例(パラメータ化クエリ)
name = "Suzuki"
cursor.execute("SELECT * FROM users WHERE name = %s", (name,))
📝 パラメータ化クエリの注意点
プレースホルダには必ず%sを使用してください(データ型に関係なく%sです)。Pythonの文字列フォーマット(f"...{変数}"や"...%s" % 変数)とは異なる仕組みです。また、2つ目の引数はタプルで渡す必要があります。パラメータが1つの場合でも(name,)のようにカンマをつけてタプルにしてください。