// エラーリファレンス

SQLite エラーコード

公式リストにあるすべての SQLite 結果コード(プライマリと拡張の両方)。テキストは各プライマリコードに対して次が返すもの: sqlite3_errstr() 主要なコードごとに何が返されるかを示します。遭遇する可能性の高いものには、原因と対処法を載せた専用ページがあります。

SQLite エラーの読み方

SQLite の関数は整数の結果コードを返します。下位 8 ビットが基本コードで、次のようなものがあります SQLITE_BUSY (5)。拡張コードは上位ビットに詳細を追加します: SQLITE_BUSY_SNAPSHOT は 517 で、5 + 2 × 256 になります。拡張コードは、次の設定で有効にした場合に返されます sqlite3_extended_result_codes() または次で読み取り sqlite3_extended_errcode().

プログラムが表示するメッセージは、通常、次から取得されます sqlite3_errmsg()、汎用のテキストよりも具体的な場合があります。たとえば UNIQUE constraint failed: users.email 代わりに constraint failed.

各言語のバインディングはこれらのコードをラップします: Python の sqlite3 モジュールが発生させる OperationalError または IntegrityError 、そしてPython 3.11以降は sqlite_errorcode そして sqlite_errorname 例外に対して。

このリファレンスのすべての SQLite エラー

105 コードのうち 40 件は詳細な解説付き(リンクあり)。コードとメッセージの出典は、 SQLite の結果コードとエラーコードのドキュメント.

主な結果コード

コード意味
SQLITE_OK 0 エラーではありません
SQLITE_ERROR SQL ロジックエラー 1 SQL ロジックエラー
SQLITE_INTERNAL 2
SQLITE_PERM アクセス権限の拒否 3 アクセス権限の拒否
SQLITE_ABORT クエリが中止されました 4 クエリが中止されました
SQLITE_BUSY データベースかを答え、プロジェクトは 5 データベースかを答え、プロジェクトは
SQLITE_LOCKED データベーステーブルはロックされています 6 データベーステーブルはロックされています
SQLITE_NOMEM メモリ不足 7 メモリ不足
SQLITE_READONLY 読み取り専用データベースに書き込もうとしました 8 読み取り専用データベースに書き込もうとしました
SQLITE_INTERRUPT 中断された 9 中断された
SQLITE_IOERR ディスク I/O エラー 10 ディスク I/O エラー
SQLITE_CORRUPT データベースのディスクイメージが破損しています 11 データベースのディスクイメージが破損しています
SQLITE_NOTFOUND 12 不明な操作
SQLITE_FULL データベースまたはディスクがいっぱいです 13 データベースまたはディスクがいっぱいです
SQLITE_CANTOPEN データベースファイルを開けません 14 データベースファイルを開けません
SQLITE_PROTOCOL ロックプロトコル 15 ロックプロトコル
SQLITE_EMPTY 16
SQLITE_SCHEMA データベーススキーマが変更されました 17 データベーススキーマが変更されました
SQLITE_TOOBIG 文字列または BLOB が大きすぎます 18 文字列または BLOB が大きすぎます
SQLITE_CONSTRAINT 制約に失敗しました 19 制約に失敗しました
SQLITE_MISMATCH データ型の不一致 20 データ型の不一致
SQLITE_MISUSE 不正なパラメーターまたはその他のAPIの誤用 21 不正なパラメーターまたはその他のAPIの誤用
SQLITE_NOLFS 22
SQLITE_AUTH 認可拒否 23 認可拒否
SQLITE_FORMAT 24
SQLITE_RANGE 列インデックスが範囲外です 25 列インデックスが範囲外です
SQLITE_NOTADB ファイルはデータベースではありません 26 ファイルはデータベースではありません
SQLITE_NOTICE 27 通知メッセージ
SQLITE_WARNING 28 警告メッセージ
SQLITE_ROW 100 別の行が利用可能
SQLITE_DONE 101 これ以上取得できる行はありません

拡張結果コード

コード意味
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ そのような照合順序はありません 257 そのような照合順序はありません: unicode_ci
SQLITE_BUSY_RECOVERY 別のプロセスがWALをリカバリー中です 261 データベースかを答え、プロジェクトは
SQLITE_LOCKED_SHAREDCACHE 共有キャッシュ内のレコードがロックされています 262 データベーステーブルはロックされています
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK CHECK 制約に違反しました 275 CHECK 制約に違反しました: price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK ROLLBACK により中止されたステートメント 516 ROLLBACKによる中止
SQLITE_BUSY_SNAPSHOT 古い読み取りが書き込みに変わることはありません 517 データベースかを答え、プロジェクトは
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ 読み取りで返されたバイト数が少なすぎます 522 ディスク I/O エラー
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR パスはディレクトリです 526 データベースファイルを開けません
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT ブロッキングファイルロックがタイムアウトしました 773 データベースかを答え、プロジェクトは
SQLITE_READONLY_ROLLBACK ホットジャーナルはロールバックできません 776 読み取り専用データベースに書き込もうとしました
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX インデックスエントリの欠落 779 データベースのディスクイメージが破損しています
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY FOREIGN KEY 制約に違反しました 787 FOREIGN KEY 制約に違反しました
SQLITE_READONLY_DBMOVED 開いている間にデータベースファイルが移動されました 1032 読み取り専用データベースに書き込もうとしました
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL NOT NULL 制約に違反しました 1299 NOT NULL 制約に違反しました: users.name
SQLITE_READONLY_DIRECTORY ジャーナルファイルを作成できません 1544 読み取り専用データベースに書き込もうとしました
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY PRIMARY KEY 制約に違反しました 1555 UNIQUE 制約に違反しました: orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER トリガー内の RAISE() で中断されました 1811 制約に失敗しました
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE UNIQUE 制約に違反しました 2067 UNIQUE 制約に違反しました: users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE 値が STRICT テーブルの列に適合しない 3091 INTEGER列t.qtyにTEXT値を格納できません
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// 1 つのクライアント、すべてのエンジン

SQLite をより速く扱う方法

SQLly は、macOS、Windows、Linux 向けのネイティブ SQL クライアントで、スキーマ対応の IntelliSense と、危険なステートメントへのガードレールを備えています。