できない.dev

SQLite「no such table」の原因と直し方

SQLite の no such table は、テーブルを作ったデータベースファイルを絶対パスで開けば直ることが多い。
相対パスで開くと実行場所に空のファイルが新しく作られ、そこにはテーブルが無い。

公開: 更新:

症状できない · exit 1
python data/app.py
Traceback (most recent call last):
  File "/tmp/tmp.meZ4tKcprC/proj/data/app.py", line 10, in <module>
    print(con.execute("SELECT id, name FROM users").fetchall())
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
sqlite3.OperationalError: no such table: users
解決後できた · exit 0
python data/app.py
[(1, 'user')]

2026-11-03 に python:3.12(Python 3.12.16 / Git 2.47.3) で実際に打って取った出力。検証環境の詳細

要約

テーブルは作ってあるのに、SELECT を実行すると無いと言われる。
Python の sqlite3 と sqlite3 コマンドでは次のように出た(Python 3.12・SQLite 3.46.1)。

sqlite3.OperationalError: no such table: users
Error: in prepare, no such table: users

no such table は、いま開いているデータベースにそのテーブルが無いという意味だ。
テーブルを作ったファイルとは別のファイルを開いていることが多い。
SQLite は、開こうとしたファイルが無いと新しい空のデータベースを作る(sqlite3_open(新しいタブで開く) の既定の動き)。
そのため、パスを間違えてもエラーにならず、最初のクエリで no such table になる。

実行例

プロジェクトのルートから python data/app.py を実行すると、sqlite3.OperationalError: no such table: users で終了コード 1 になり、ルートには 0 バイトの app.db ができた。
Path(__file__) から組み立てた絶対パスにすると、ルートからでも data の中からでも [(1, 'user')] が返った。
file:missing.db?mode=rw で開くと unable to open database file で止まり、空のファイルは作られなかった。

$ python data/app.py
Traceback (most recent call last):
  File "/tmp/tmp.meZ4tKcprC/proj/data/app.py", line 10, in <module>
    print(con.execute("SELECT id, name FROM users").fetchall())
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
sqlite3.OperationalError: no such table: users
$ echo $?
1
$ ls -l app.db data/app.db
-rw-r--r-- 1 root root    0 Nov  3 23:09 app.db
-rw-r--r-- 1 root root 8192 Nov  3 23:09 data/app.db
$ sqlite3 app.db "PRAGMA database_list;"
0|main|/tmp/tmp.meZ4tKcprC/proj/app.db
$ sqlite3 app.db .tables
$ sqlite3 app.db "SELECT * FROM users;"
Error: in prepare, no such table: users
$ echo $?
1
$ sqlite3 data/app.db "PRAGMA database_list;"
0|main|/tmp/tmp.meZ4tKcprC/proj/data/app.db
$ sqlite3 data/app.db .tables
users
$ sqlite3 data/app.db "SELECT * FROM user;"
Error: in prepare, no such table: user
$ echo $?
1
$ python data/app.py
[(1, 'user')]
$ echo $?
0
$ ls
data
$ python app.py
[(1, 'user')]
$ echo $?
0
$ python open_rw.py
Traceback (most recent call last):
  File "/tmp/tmp.meZ4tKcprC/proj/open_rw.py", line 3, in <module>
    con = sqlite3.connect("file:missing.db?mode=rw", uri=True)
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
sqlite3.OperationalError: unable to open database file
$ echo $?
1
$ ls
data
open_rw.py
$ python memory_bad.py
Traceback (most recent call last):
  File "/tmp/tmp.meZ4tKcprC/proj/memory_bad.py", line 6, in <module>
    con2.execute("SELECT * FROM t")
sqlite3.OperationalError: no such table: t
$ echo $?
1
$ python memory_shared.py
[(1,)]
$ echo $?
0

— 2026-11-03 時点の出力

検証環境Python 3.12.16 / Git 2.47.3 / 2026-11-03 検証
検証日
実行環境
python:3.12 Debian GNU/Linux 13 (trixie)
バージョン
  • Python 3.12.16
  • Git 2.47.3

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 絶対パスで開く

import sqlite3
from pathlib import Path
 
DB = Path(__file__).resolve().parent / "app.db"
con = sqlite3.connect(DB)

スクリプトの場所を基準にしたところ、どこから実行しても data/app.db が開かれ、[(1, 'user')] が返った。

2. 開いているファイルを確かめる

sqlite3 data/app.db "PRAGMA database_list;"
sqlite3 data/app.db ".tables"

PRAGMA database_list は 0|main|/proj/data/app.db のように実際のパスを返す。
.tables か SELECT name FROM sqlite_schema WHERE type='table'(The Schema Table(新しいタブで開く))で、そのファイルにあるテーブル名を確かめる。

3. 無いファイルは作らせない

con = sqlite3.connect("file:app.db?mode=rw", uri=True)

mode=rw ではファイルが無いと unable to open database file で止まり、空のファイルは作られなかった。
パスの誤りをその場で見つけられる。

4. インメモリは共有キャッシュの URI で開く

con = sqlite3.connect("file:shared?mode=memory&cache=shared", uri=True)

同じ URI で開いた 2 つ目の接続から、1 つ目の接続で作ったテーブルを参照できた。
データベースは、最後の接続を閉じた時点で消える。

よくある原因

  1. 相対パスが、実行した場所を基準に解決された。
    data/app.py の中で sqlite3.connect("app.db") と書き、プロジェクトのルートから python data/app.py で実行した。
    開かれたのは data/app.db ではなく、ルートに新しくできた 0 バイトの app.db だった。
  2. :memory: を接続ごとに開いた。
    :memory: は接続ごとに別のデータベースになるので、別の接続で作ったテーブルは見えない。
  3. テーブル名が違うか、テーブルを作る前に参照している。
    users で作ったテーブルを user で参照すると、同じく no such table: user になる。