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で結果を確認できる

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

AIが書いたコードを自分で読めるようになる第一歩

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です