// 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또는 한 행이 숫자 열에 텍스트를 담고 있는 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 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.