Python Cursor.execute()とは?SQLを実行する方法
PythonのCursor.execute()は、SQL文を1つ実行するメソッドです。
テーブル作成・データ登録・検索——すべてこのメソッドから行います。同時に、SQLインジェクションを防ぐ書き方を身につける場所でもあります。
Cursor.execute()の基本的な使い方
import sqlite3
conn = sqlite3.connect(":memory:")
cur = conn.cursor()
cur.execute("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)")
cur.execute("INSERT INTO users (name, age) VALUES (?, ?)", ("佐藤", 28))
conn.commit()
print(cur.execute("SELECT * FROM users").fetchall())
conn.close()
実行結果:
[(1, '佐藤', 28)]
第1引数にSQL文、第2引数に値のタプルを渡します。
戻り値はカーソル自身
r = cur.execute("SELECT * FROM users")
print(type(r).__name__, "/ cur と同一:", r is cur)
実行結果:
Cursor / cur と同一: True
自分自身が返るため、そのまま.fetchall()をつなげられます。
rows = cur.execute("SELECT * FROM users").fetchall()
値は必ずプレースホルダで渡す
ここがexecute()で最も重要な部分です。
name = "O'Brien"
cur.execute(f"SELECT * FROM users WHERE name = '{name}'")
実行結果:
OperationalError: near "Brien": syntax error
値に含まれる'がSQLの引用符と解釈され、文が壊れました。
プレースホルダ?を使えば正しく動きます。
print(cur.execute("SELECT * FROM users WHERE name = ?", (name,)).fetchall())
実行結果:
[]
該当がないので空ですが、エラーにはなりません。値はSQL文の一部としてではなく、あくまで「値」としてデータベースに渡されるためです。
この例では構文エラーで済みましたが、入力が外部から来る場合は「SQLインジェクション」という脆弱性になります。データを盗まれたり消されたりする原因です。
値を文字列連結でSQLに埋め込まない——例外のない原則です。詳しくは「SQLインジェクション対策完全ガイド – 仕組みと防止方法を徹底解説」で解説しています。
1つでもタプルで渡す
初心者が必ず引っかかる点です。
cur.execute("SELECT * FROM users WHERE id = ?", 1)
実行結果:
ValueError: parameters are of unsupported type
数値をそのまま渡すとエラーです。タプルにしてください。
cur.execute("SELECT * FROM users WHERE id = ?", (1,))
(1,)のカンマを忘れるとただの括弧になり、別のエラーが出ます。
cur.execute("SELECT * FROM t WHERE a = ?", ("AB"))
実行結果:
ProgrammingError: Incorrect number of bindings supplied. The current statement uses 1, and there are 2 supplied.
「1つのはずが2つ来た」と言われました。("AB")は文字列"AB"と同じで、2文字=2個の値と解釈されたためです。
文字列を渡すと1文字ずつ入る
これはエラーにならないぶん危険な落とし穴です。
import sqlite3
conn = sqlite3.connect(":memory:")
cur = conn.cursor()
cur.execute("CREATE TABLE t (a TEXT, b TEXT)")
cur.execute("INSERT INTO t VALUES (?, ?)", "AB")
print(cur.execute("SELECT * FROM t").fetchall())
conn.close()
実行結果:
[('A', 'B')]
"AB"という1つの値を入れたつもりが、'A'と'B'の2つに分かれて保存されました。
プレースホルダの数とたまたま文字数が一致すると、エラーも警告も出ずに壊れたデータが入ります。「なぜか1文字しか入っていない」という不具合の正体はこれです。
第2引数は必ずタプルかリストで渡してください。
名前付きプレースホルダ
cur.execute(
"INSERT INTO users (name, age) VALUES (:n, :a)",
{"n": "鈴木", "a": 34},
)
辞書で渡せます。列が多いときは順番を気にしなくてよいぶん間違えにくくなります。
| 書き方 | 渡すもの | 向いている場面 |
|---|---|---|
? |
タプル | 列が少ない |
:名前 |
辞書 | 列が多い・順番が変わりうる |
テーブル名や列名には使えない
cur.execute("SELECT * FROM ?", ("users",))
実行結果:
OperationalError: near "?": syntax error
プレースホルダが使えるのは値の位置だけです。テーブル名を動的に変えたいなら、あらかじめ決めた候補の中から選ぶ形にしてください。
ALLOWED = {"users", "orders"}
if table not in ALLOWED:
raise ValueError(f"許可されていないテーブル: {table}")
cur.execute(f"SELECT * FROM {table}")
外部からの値をそのまま埋め込んではいけません。
実行結果の情報を取る
cur.execute("INSERT INTO users (name, age) VALUES (?, ?)", ("高橋", 22))
print("lastrowid:", cur.lastrowid)
print("rowcount:", cur.rowcount)
実行結果:
lastrowid: 1
rowcount: 1
| 属性 | 意味 |
|---|---|
lastrowid |
最後に挿入した行のID |
rowcount |
影響を受けた行数(INSERT/UPDATE/DELETE) |
rowcountはSELECTでは当てになりません(-1になります)。件数を知りたいならlen(cur.fetchall())かSELECT COUNT(*)を使ってください。
1文ずつしか実行できない
execute()に複数のSQLをまとめて渡すことはできません。複数まとめて流すならexecutescript()を使います。
conn.executescript("""
CREATE TABLE a (x);
CREATE TABLE b (y);
""")
ただしexecutescript()はプレースホルダが使えません。外部の値を含むSQLには使わないでください。
Cursor.execute()のまとめ
execute()はSQLを1文実行し、カーソル自身を返す- 値は必ずプレースホルダで渡す(文字列連結は禁止)
- 1つでもタプルで渡す。
(1,)のカンマを忘れない - 文字列を渡すと1文字ずつ入る——エラーが出ないので要注意
- 列が多いなら
:名前と辞書 - テーブル名・列名にはプレースホルダが使えない
lastrowid・rowcountで結果を確認できる



