// 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 또는 한 행이 숫자 열에 텍스트를 담고 있는 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 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.