SQLiteのエラーコード

SQLITE_INTERRUPT 結果コードは、操作が sqlite3_interrupt() インターフェイスによって中断されたことを示します。 SQLITE_ABORT も参照してください。

SQLITE_IOERR 結果コードは、オペレーティング システムが I/O エラーを報告したため、操作を完了できなかったことを示しています。 ディスクドライブがいっぱいになると、通常は SQLITE_IOERR エラーではなく SQLITE_FULL エラーが発生します。 I/O エラーには、失敗した特定の I/O 操作を識別するさまざまな拡張結果コードが多数あります。

SQLITE_IOERR_ACCESS エラー コードは、sqlite3_vfs オブジェクトの xAccess メソッド内の I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_AUTH エラー コードは、拡張機能で使用するために予約されているコードです。 SQLite コアでは使用されません。

SQLITE_IOERR_BEGIN_ATOMIC エラー コードは、基礎となるオペレーティング システムが SQLITE_FCNTL_BEGIN_ATOMIC_WRITE ファイル コントロールでエラーを報告したことを示します。これは、SQLITE_ENABLE_ATOMIC_WRITE が有効であり、データベースがアトミック書き込みをサポートするファイルシステムでホストされている場合にのみ発生します。

SQLITE_IOERR_BLOCKED エラー コードは使用されなくなりました。

SQLITE_IOERR_CHECKRESERVEDLOCK エラー コードは、sqlite3_io_methods オブジェクトの xCheckReservedLock メソッド内の I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_CLOSE エラー コードは、sqlite3_io_methods オブジェクトの xClose メソッド内の I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_COMMIT_ATOMIC エラー コードは、基礎となるオペレーティング システムが SQLITE_FCNTL_COMMIT_ATOMIC_WRITE ファイル コントロールでエラーを報告したことを示します。これは、SQLITE_ENABLE_ATOMIC_WRITE が有効であり、データベースがアトミック書き込みをサポートするファイルシステムでホストされている場合にのみ発生します。

SQLITE_IOERR_CONVPATH エラー コードは、Cygwin VFS によってのみ使用される SQLITE_IOERR の拡張エラー コードであり、cygwin_conv_path() システム コールが失敗したことを示します。 SQLITE_CANTOPEN_CONVPATH も参照してください。

SQLITE_IOERR_CORRUPTFS エラー コードは、SQLITE_IOERR の拡張エラー コードであり、シークまたは読み取りの失敗が通常のデバイスの障害ではなく、リクエストがファイルの境界内に収まらないことが原因であることを示すために VFS によってのみ使用されます。これは多くの場合、ファイルシステムが破損していることを示します。 このページの最終更新日は 2026-02-18 11:56:50Z です。

SQLITE_IOERR_DATA エラー コードは、データベース ファイルのページのチェックサムが正しくないことを示すために、チェックサム VFS シムによってのみ使用される SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_DELETE エラー コードは、sqlite3_vfs オブジェクトの xDelete メソッド内の I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_DELETE_NOENT エラー コードは、削除されるファイルが存在しないために sqlite3_vfs オブジェクトの xDelete メソッドが失敗したことを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_DIR_CLOSE エラー コードは使用されなくなりました。

SQLITE_IOERR_DIR_FSYNC エラー コードは、ディレクトリ上で fsync() を呼び出そうとしているときに VFS 層での I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。 Unix VFS は、特定のファイルを作成または削除した後、電源喪失またはシステム クラッシュの後でもそれらのファイルがファイル システムに引き続き表示されることを確認するために、ディレクトリを fsync() しようとします。このエラー コードは、fsync() の実行中に問題が発生したことを示します。

SQLITE_IOERR_FSTAT エラー コードは、ファイル サイズやアクセス許可などの情報を確認するためにファイルに対して fstat() (または同等のもの) を呼び出そうとしているときに、VFS 層での I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_FSYNC エラー コードは、以前に書き込まれたコンテンツを OS および/またはディスク制御バッファから永続ストレージにフラッシュしようとした際に、VFS 層での I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。つまり、このコードは、UNIX の fsync() システム コール、または Windows の FlushFileBuffers() システム コールに問題があることを示しています。

SQLITE_IOERR_GETTEMPPATH エラー コードは、VFS が一時ファイルを配置する適切なディレクトリを決定できないことを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_LOCK エラー コードは、アドバイザリ ファイル ロック ロジックの I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。通常、SQLITE_IOERR_LOCK エラーは、PENDING ロックの取得に問題があることを示します。ただし、Mac で使用される一部の特殊な VFS でのさまざまなロック エラーを示すこともあります。

SQLITE_IOERR_MMAP エラー コードは、データベース ファイルの一部をプロセス アドレス空間にマップまたはマップ解除しようとしたときに、sqlite3_io_methods オブジェクトの xFetch メソッドまたは xUnfetch メソッド内で I/O エラーが発生したことを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_NOMEM エラー コードは、十分なメモリを割り当てることができないために操作を完了できなかったことを示すために、VFS レイヤーによって返されることがあります。このエラー コードは通常、アプリケーションに返される前に SQLite の上位層によって SQLITE_NOMEM に変換されます。

SQLITE_IOERR_RDLOCK エラー コードは、読み取りロックを取得しようとしたときに sqlite3_io_methods オブジェクトの xLock メソッド内で I/O エラーが発生したことを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_READ エラー コードは、ディスク上のファイルから読み取りを試行中に VFS 層での I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。このエラーは、ハードウェアの誤動作、またはファイルが開いている間にファイルシステムがアンマウントされたことが原因で発生する可能性があります。

SQLITE_IOERR_ROLLBACK_ATOMIC エラー コードは、基礎となるオペレーティング システムが SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE ファイル コントロールでエラーを報告したことを示します。これは、SQLITE_ENABLE_ATOMIC_WRITE が有効であり、データベースがアトミック書き込みをサポートするファイルシステムでホストされている場合にのみ発生します。

SQLITE_IOERR_SEEK エラー コードは、読み取りまたは書き込みが行われるファイルの開始点までファイル記述子をシークしようとしたときに、sqlite3_io_methods オブジェクトの xRead または xWrite メソッド内での I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_SHMLOCK エラー コードは使用されなくなりました。

SQLITE_IOERR_SHMMAP エラー コードは、共有メモリ セグメントをプロセス アドレス空間にマップしようとしたときに、sqlite3_io_methods オブジェクトの xShmMap メソッド内で I/O エラーが発生したことを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_SHMOPEN エラー コードは、新しい共有メモリ セグメントを開こうとしたときに、sqlite3_io_methods オブジェクトの xShmMap メソッド内で I/O エラーが発生したことを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_SHMSIZE エラー コードは、WAL モード トランザクション処理の一部として "shm" ファイルを拡大しようとした際に、sqlite3_io_methods オブジェクトの xShmMap メソッド内で I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。このエラーは、基礎となるファイル システム ボリュームのスペースが不足していることを示している可能性があります。

SQLITE_IOERR_SHORT_READ エラー コードは、VFS レイヤーでの読み取り試行が要求されたバイト数を取得できなかったことを示す SQLITE_IOERR の拡張エラー コードです。これは、ファイルが切り詰められていることが原因である可能性があります。

SQLITE_IOERR_TRUNCATE エラー コードは、sqlite3_io_methods オブジェクトの xTruncate メソッドを使用してファイルのサイズを変更しようとしたときに、VFS レイヤーでの I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_UNLOCK エラー コードは、sqlite3_io_methods オブジェクトの xUnlock メソッド内の I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。

SQLITE_IOERR_VNODE エラー コードは、拡張機能で使用するために予約されているコードです。 SQLite コアでは使用されません。

SQLITE_IOERR_WRITE エラー コードは、ディスク上のファイルに書き込もうとしているときに VFS 層での I/O エラーを示す SQLITE_IOERR の拡張エラー コードです。このエラーは、ハードウェアの誤動作、またはファイルが開いている間にファイルシステムがアンマウントされたことが原因で発生する可能性があります。ファイルシステムがいっぱいの場合は、その目的のための別のエラー コード (SQLITE_FULL) があるため、このエラーは発生しません。

SQLITE_LOCKED 結果コードは、同じデータベース接続内の競合、または共有キャッシュを使用する別のデータベース接続との競合のため、書き込み操作を続行できなかったことを示します。 たとえば、別のスレッドが同じデータベース接続上でそのテーブルから読み取りを行っている間は、DROP TABLE ステートメントを実行できません。テーブルを削除すると、テーブルが同時リーダーの下から削除されるためです。 SQLITE_LOCKED 結果コードは、SQLITE_LOCKED が同じデータベース接続 (または共有キャッシュとの接続) での競合を示すのに対し、SQLITE_BUSY は別のデータベース接続 (おそらく別のプロセスで) との競合を示すという点で SQLITE_BUSY とは異なります。

SQLITE_LOCKED_SHAREDCACHE 結果コードは、SQLite データ レコードへのアクセスが、共有キャッシュ モードで同じレコードを使用している別のデータベース接続によってブロックされていることを示します。 2 つ以上のデータベース接続が同じキャッシュを共有し、そのうちの 1 つの接続がそのキャッシュ内のレコードを変更中の場合、壊れた変更や部分的に完了した変更が読み取り者に表示されないように、変更の進行中は他の接続がそのデータにアクセスすることをブロックされます。

SQLITE_LOCKED_VTAB 結果コードは SQLite コアでは使用されませんが、拡張機能では使用できます。仮想テーブルの実装は、他のスレッドまたはプロセスによってロックが保持されているために現在の操作を完了できないことを示すために、この結果コードを返すことができます。 R ツリー拡張機能は、別のプリペアド ステートメントが R ツリーをアクティブに読み取っているときに R ツリーを更新しようとすると、この結果コードを返します。 R ツリーへの変更にはノードの再シャッフルと再バランスが含まれる可能性があり、読み取りカーソルが中断され、一部の行が繰り返され、他の行が省略されるため、更新を続行できません。

SQLITE_MISMATCH エラー コードは、データ型の不一致を示します。 SQLite は通常、値の型と、その値が格納されるコンテナーの宣言された型との間の不一致を非常に許容します。たとえば、SQLite を使用すると、アプリケーションは宣言された型 BOOLEAN を持つ列に大きな BLOB を格納できます。ただし、場合によっては、SQLite は型について厳密です。 SQLITE_MISMATCH エラーは、型が一致しない場合に返されます。 テーブルの ROWID は整数である必要があります。 rowid を整数 (または、次に使用可能な整数 rowid に自動的に変換される NULL) 以外に設定しようとすると、SQLITE_MISMATCH エラーが発生します。

アプリケーションが未定義またはサポートされていない方法で SQLite インターフェイスを使用している場合、SQLITE_MISUSE リターン コードが返されることがあります。たとえば、準備されたステートメントがファイナライズされた後にその準備されたステートメントを使用すると、SQLITE_MISUSE エラーが発生する可能性があります。 SQLite は、この結果コードを使用して誤用を検出し、誤用を報告しようとします。ただし、悪用の検出が成功するという保証はありません。不正使用の検出は確率的です。アプリケーションは SQLITE_MISUSE 戻り値に依存しないでください。 SQLite がいずれかのインターフェイスから SQLITE_MISUSE を返した場合、それはアプリケーションが正しくコーディングされていないため、修正する必要があることを意味します。標準 SQLite インターフェイスから SQLITE_MISUSE を返すことがあるアプリケーションは出荷しないでください。そのアプリケーションには重大なバグが含まれる可能性があります。