パラメータ化クエリ
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,)のようにカンマをつけてタプルにしてください。 |