エラーコード検索

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 を返すことがあるアプリケーションは出荷しないでください。そのアプリケーションには重大なバグが含まれる可能性があります。

SQLITE_NOLFS エラーは、大規模ファイルをサポートしていないシステムで、データベースがファイル システムで処理できるサイズを超えると返されることがあります。 「NOLFS」は「NO Large File Support」の略です。

SQLITE_NOMEM 結果コードは、SQLite が操作を完了するために必要なすべてのメモリを割り当てることができなかったことを示します。つまり、操作を続行するために割り当てられたメモリが必要な場合、sqlite3_malloc() または sqlite3_realloc() への内部呼び出しが失敗しました。

ファイルを開こうとすると、SQLITE_NOTADB エラーは、開かれているファイルが SQLite データベース ファイルではないようであることを示します。

SQLITE_NOTFOUND 結果コードは、次の 3 つの方法で公開されます。 SQLITE_NOTFOUND 結果コードは SQLite 実装によって内部でも使用されますが、それらの内部使用はアプリケーションには公開されません。

SQLITE_NOTICE 結果コードは、どの C/C++ インターフェイスからも返されません。ただし、SQLITE_NOTICE (またはその拡張エラー コードの 1 つ) は、異常な操作が発生していることを示すために sqlite3_log() コールバックの最初の引数として使用されることがあります。

SQLITE_NOTICE_RECOVER_ROLLBACK 結果コードは、ホット ジャーナルがロールバックされるときに sqlite3_log() のコールバックに渡されます。

WAL モードのデータベース ファイルがリカバリされると、SQLITE_NOTICE_RECOVER_WAL 結果コードが sqlite3_log() のコールバックに渡されます。

SQLITE_PERM 結果コードは、新しく作成されたデータベースに対して要求されたアクセス モードを提供できなかったことを示します。

SQLITE_PROTOCOL 結果コードは、SQLite で使用されるファイル ロック プロトコルに問題があることを示します。 SQLITE_PROTOCOL エラーは現在、WAL モードを使用し、新しいトランザクションを開始しようとした場合にのみ返されます。 2 つの別々のデータベース接続の両方が WAL モードで同時にトランザクションを開始しようとすると、競合状態が発生する可能性があります。レースの敗者は後退し、少し遅れて再挑戦します。同じ接続が数秒間にわたって何十回もロック競合に負けた場合、最終的には諦めて SQLITE_PROTOCOL を返します。 SQLITE_PROTOCOL エラーが実際に発生するのは、非常にまれであり、多くの個別のプロセスがすべて同じデータベースに書き込むために激しく競合している場合にのみ発生します。

SQLITE_RANGE エラーは、sqlite3_bind ルーチンの 1 つに対するパラメータ番号引数、または sqlite3_column ルーチンの 1 つの列番号が範囲外であることを示します。

現在のデータベース接続に書き込み権限がないデータを変更しようとすると、SQLITE_READONLY 結果コードが返されます。

SQLITE_READONLY_CANTINIT 結果コードは、VFS の xShmMap メソッドに由来し、WAL モードで使用される共有メモリ領域が存在するが、現在のプロセスが共有メモリ領域に対する書き込み権限を持っていないため、その内容が信頼できず、現在のプロセスで使用できないことを示します。 (WAL モードの共有メモリ領域は、通常、プロセス空間に mmap される「-wal」接尾辞が付いたファイルです。現在のプロセスにそのファイルに対する書き込み権限がない場合、共有メモリに書き込むことはできません。) SQLite 内の上位レベルのロジックは通常、エラー コードをインターセプトし、一時的なメモリ内共有メモリ領域を作成して、現在のプロセスが少なくともデータベースの内容を読み取れるようにします。この結果コードはアプリケーション インターフェイス層に到達すべきではありません。

SQLITE_READONLY_CANTLOCK エラー コードは、SQLITE_READONLY の拡張エラー コードです。 SQLITE_READONLY_CANTLOCK エラー コードは、データベースに関連付けられた共有メモリ ファイルが読み取り専用であるため、SQLite が WAL モード データベースの読み取りロックを取得できないことを示します。

SQLITE_READONLY_DBMOVED エラー コードは、SQLITE_READONLY の拡張エラー コードです。 SQLITE_READONLY_DBMOVED エラー コードは、データベース ファイルが開かれてから移動されているためデータベースを変更できないことを示します。そのため、データベースを変更しようとすると、ロールバック ジャーナルの名前が正しく付けられずにプロセスがクラッシュすると、データベースが破損する可能性があります。

SQLITE_READONLY_DIRECTORY 結果コードは、プロセスがデータベースと同じディレクトリにジャーナル ファイルを作成する権限を持たず、ジャーナル ファイルの作成が書き込みの前提条件であるため、データベースが読み取り専用であることを示します。

SQLITE_READONLY_RECOVERY エラー コードは、SQLITE_READONLY の拡張エラー コードです。 SQLITE_READONLY_RECOVERY エラー コードは、データベース ファイルをリカバリする必要があり、リカバリには書き込みアクセスが必要だが、使用できるのは読み取りアクセスのみであるため、WAL モード データベースを開けないことを示します。

SQLITE_READONLY_ROLLBACK エラー コードは、SQLITE_READONLY の拡張エラー コードです。 SQLITE_READONLY_ROLLBACK エラー コードは、ロールバックする必要があるホット ジャーナルがあるデータベースがオープンできないが、データベースが読み取り専用であるためにオープンできないことを示します。

SQLITE_SCHEMA 結果コードは、データベース スキーマが変更されたことを示します。この結果コードは、sqlite3_prepare() または sqlite3_prepare16() を使用して生成された準備済みステートメントの sqlite3_step() から返されます。ステートメントが準備されてからステートメントが実行されるまでの間に、データベース スキーマが他のプロセスによって変更された場合、このエラーが発生する可能性があります。 準備されたステートメントが sqlite3_prepare_v2() から生成される場合、スキーマが変更されるとステートメントは SQLITE_MAX_SCHEMA_RETRY 回 (デフォルト: 50) まで自動的に再準備されます。 sqlite3_step() インターフェイスは、この回数の再試行後も失敗が続く場合にのみ SQLITE_SCHEMA をアプリケーションに返します。

SQLITE_TOOBIG エラー コードは、文字列または BLOB が大きすぎることを示します。 SQLite の文字列または BLOB のデフォルトの最大長は 1,000,000,000 バイトです。この最大長は、SQLITE_MAX_LENGTH コンパイル時オプションを使用してコンパイル時に変更することも、sqlite3_limit(db,SQLITE_LIMIT_LENGTH,...) インターフェイスを使用して実行時に変更することもできます。 SQLITE_TOOBIG エラーは、SQLite がコンパイル時または実行時の制限を超える文字列または BLOB を検出した場合に発生します。 SQLITE_TOOBIG エラー コードは、サイズが大きい SQL ステートメントが sqlite3_prepare_v2() インターフェイスの 1 つに渡された場合にも発生する可能性があります。 SQL ステートメントの最大長のデフォルトは、同様の値の 1,000,000,000 バイトです。 SQL ステートメントの最大長は、SQLITE_MAX_SQL_LENGTH を使用してコンパイル時に、または sqlite3_limit(db,SQLITE_LIMIT_SQL_LENGTH,...) を使用して実行時に設定できます。

SQLITE_WARNING 結果コードは、どの C/C++ インターフェイスからも返されません。ただし、SQLITE_WARNING (またはその拡張エラー コードの 1 つ) は、異常でおそらく不適切な操作が行われていることを示すために、sqlite3_log() コールバックの最初の引数として使用されることがあります。

SQLITE_WARNING_AUTOINDEX 結果コードは、自動インデックス作成が使用されるたびに sqlite3_log() のコールバックに渡されます。これは、データベースにインデックスを追加するとメリットが得られる可能性があるというアプリケーション設計者への警告として機能します。