// PostgreSQL エラーリファレンス
PostgreSQL 22P02: 型に対する入力構文が無効です
テキスト値を対象の型に変換できませんでした。整数に文字を渡した、形式が不正な UUID、不正な JSON、空の文字列を数値にした、などです。
- SQLSTATE
22P02- 名前
invalid_text_representation- カテゴリ
- データ例外
意味
PostgreSQL は、リテラルとテキストを各型の入力関数で型付きの値に変換します。テキストがその型の有効な表現でない場合、変換は 22P02 で失敗し、メッセージに問題の値が引用符付きで表示されます。
値は、クエリ内のリテラル、バインドパラメータ、 CAST、または型付き列と比較したり型付き列に挿入したりするテキスト列。
よくある原因
- 数値または UUID の列を、数値でも UUID でもない文字列と比較する場合、たとえば
WHERE id = 'abc'または空の文字列''. - 数値が期待される場所に空文字列を渡した場合。PostgreSQL は
''へNULLまたは 0。 - 次の入力の形式が不正:
uuid,json/jsonb,boolean,inetまたは配列リテラル。 - 一括
COPYまたは、1 行の数値列にテキストが入っている CSV の読み込み。
修正方法
-
キャストする前に、変換できない行を見つけます (PostgreSQL 16 以降には
pg_input_is_valid).SELECT raw_value FROM staging WHERE NOT pg_input_is_valid(raw_value, 'integer');
-
古いバージョンでは、キャスト前にパターンでフィルタリングします。
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
空の文字列を次に変換する
NULL明示的に。SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
アプリケーションコードでは、SQL 文字列を組み立てる代わりに、正しい型でパラメーターをバインドし、データベースに届く前に入力を検証してください。
安全に再現する
SELECT 'abc'::int; -- ERROR: invalid input syntax for type integer: "abc"
関連エラー
22003数値が範囲外です22007無効な日時形式42804データ型の不一致22021エンコーディングに対して無効なバイトシーケンス245SQL Server: 値の変換に失敗しました1366MySQL: 列の値が正しくありませんORA-01722Oracle: 無効な数値
その他のデータ例外のエラー
コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.
// エラーが減り、修正も速く
SQLly で PostgreSQL を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。