// PostgreSQL エラーリファレンス

PostgreSQL 22P02: 型に対する入力構文が無効です

テキスト値を対象の型に変換できませんでした。整数に文字を渡した、形式が不正な UUID、不正な JSON、空の文字列を数値にした、などです。

SQLSTATE
22P02
名前
invalid_text_representation
カテゴリ
データ例外
エラーメッセージ
invalid input syntax for type integer: "abc"

意味

PostgreSQL は、リテラルとテキストを各型の入力関数で型付きの値に変換します。テキストがその型の有効な表現でない場合、変換は 22P02 で失敗し、メッセージに問題の値が引用符付きで表示されます。

値は、クエリ内のリテラル、バインドパラメータ、 CAST、または型付き列と比較したり型付き列に挿入したりするテキスト列。

よくある原因

  • 数値または UUID の列を、数値でも UUID でもない文字列と比較する場合、たとえば WHERE id = 'abc' または空の文字列 ''.
  • 数値が期待される場所に空文字列を渡した場合。PostgreSQL は '' へ NULL または 0。
  • 次の入力の形式が不正: uuid, json/jsonb, boolean, inet または配列リテラル。
  • 一括 COPY または、1 行の数値列にテキストが入っている CSV の読み込み。

修正方法

  1. キャストする前に、変換できない行を見つけます (PostgreSQL 16 以降には pg_input_is_valid).

    SELECT raw_value
    FROM staging
    WHERE NOT pg_input_is_valid(raw_value, 'integer');
  2. 古いバージョンでは、キャスト前にパターンでフィルタリングします。

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. 空の文字列を次に変換する NULL 明示的に。

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. アプリケーションコードでは、SQL 文字列を組み立てる代わりに、正しい型でパラメーターをバインドし、データベースに届く前に入力を検証してください。

安全に再現する

SELECT 'abc'::int;  -- ERROR: invalid input syntax for type integer: "abc"

関連エラー

その他のデータ例外のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。