Japanese Translation:

SQLite はテキストカラム内に埋め込まれた NUL 文字（ASCII 0x00）を許可していますが、その使用は推奨されていません。SQLite の内部関数は、そのようなデータを最初の NUL までの文字列として扱い、

length()

および

quote()

はその点までの字符数を数え/表示し、CLI 上の

.dump

コマンド（

.mode quote

が設定されていると仮定）は最初の NUL 以降のすべてを省略します。その結果、

SELECT * FROM t1 WHERE b='abc'

といった検索では、カラムの値が

'abc'||char(0)||'xyz'

で、実際に 7 文字保持されていても、行が返却されないことがあります。SQLite は完全な長さを知っていますが、CLI の出力や一部の関数は、ユーザーに文字列が早期で終わっていると誤認させる可能性があります。真の内容を確認するには、カラムを BLOB にキャストします（例：

CAST(b AS BLOB)

）。埋め込まれた NUL を検出するには、

instr(X, char(0))

を使用し、これが最初の NUL の位置を返すか、存在しない場合は 0 を返します。NUL を含む行を特定するには、

SELECT count(*) FROM t1 WHERE instr(b,char(0))>0

を使用します。必要であれば、

UPDATE t1 SET b=substr(b,1,instr(b,char(0))) WHERE instr(b,char(0));

で NUL とその後のすべての文字列を削除できます。これらの手順は、沈黙するロジックエラーを防ぎ、本番環境での信頼性の高いテキスト処理を保証します。（コンテンツは 2022-05-23 に最終更新）

SQLite で NUL 文字を使用した場合の注意点

SQLite では、データベースに格納された文字列値の中央部においても NUL 文字（ASCII

0x00

または Unicode

\u0000

）を使用 technically できます。しかし、以下の通り予期せぬ動作を引き起こす可能性があります。

したがって、SQL テキスト文字列に NUL 文字を含めることは推奨されません。

以下の SQL スクリプトを考慮してください。

CREATE TABLE t1(
  a INTEGER PRIMARY KEY,
  b TEXT
);
INSERT INTO t1(a,b) VALUES(1, 'abc'||char(0)||'xyz');
SELECT a, b, length(b) FROM t1;

出力結果の特性:

クエリ検索による挙動:

SELECT * FROM t1 WHERE b='abc';

文字列を

BLOB

型に変換すると、NUL 文字が正確な位置（第 4 文字）として表示されます。

SELECT a, CAST(b AS BLOB) FROM t1;

特定の文字列が含まれているかどうかを確認する式を作成できます。以下は NUL 文字が埋め込まれている行を検出する例です。

-- 第 4 文字位置に NUL 文字がある場合の検証
SELECT instr(b, char(0)) FROM t1; 
-- 結果：0（発見しない）, 4（第 4 文字で発見）など（非ゼロ=発見）

埋め込まれた NUL 文字を含む行の数を数えるには、以下を実行します。

SELECT count(*) FROM t1 WHERE instr(b,char(0)) > 0;

テーブルのコラムに NUL 文字が含まれている場合、その以降のテキストも取り除く必要があります。データベースファイルからこれらの不具合を修正したい場合は、以下の

UPDATE

ステートメントを実行してください。

-- NUL 文字までの文字列のみを残し、以降を削除する
UPDATE t1 
SET b = substr(b, 1, instr(b, char(0))) 
WHERE instr(b, char(0));

注意点: この操作はデータを破損させるため、バックアップを取ってから実行してください。