// PostgreSQL 오류 참조

PostgreSQL 22021: 인코딩에 대한 잘못된 바이트 시퀀스

텍스트에 데이터베이스나 클라이언트 인코딩에서 유효하지 않은 바이트가 포함되어 있습니다: UTF-8로 로드된 Latin-1 또는 Windows-1252 파일, 또는 텍스트에 있는 NUL 바이트입니다.

SQLSTATE
22021
이름
character_not_in_repertoire
카테고리
데이터 예외
오류 메시지
invalid byte sequence for encoding "UTF8": 0xff

의미

PostgreSQL은 모든 텍스트 값이 도착한 인코딩에서 유효한지 검사합니다. 22021 (character_not_in_repertoire)은 바이트 시퀀스가 그곳에서 유효한 문자가 아니란 것을 의미합니다. UTF-8 데이터베이스의 경우, 이는 일반적으로 데이터가 실제로 Latin-1 또는 Windows-1252와 같은 다른 인코딩에 있었음을 의미하며, 여기서 0xe9 (é) 같은 바이트는 자체적으로 UTF-8에서 유효하지 않은 단일 바이트입니다.

PostgreSQL 텍스트 타입은 NUL 바이트를 절대 담을 수 없으므로 invalid byte sequence for encoding "UTF8": 0x00 이는 바이너리 또는 C 문자열 데이터가 텍스트 열에 들어왔음을 의미합니다.

일반적인 원인

  • Windows-1252 또는 Latin-1로 작성한 도구가 내보낸 CSV를 불러올 때는 COPY 또는 \copy UTF-8로 가정합니다.
  • client_encoding 설정됨 UTF8 클라이언트가 실제로 다른 인코딩을 보낼 때.
  • 이진 데이터나 NUL 바이트가 포함된 문자열이 text 또는 varchar 열.
  • 애플리케이션에 의해 멀티바이트 문자의 중간에서 데이터가 잘렸습니다.

해결 방법

  1. 말씀해 주세요 COPY 파일의 실제 인코딩; PostgreSQL이 이를 변환합니다.

    \copy customers FROM 'customers.csv' WITH (FORMAT csv, HEADER true, ENCODING 'WIN1252')
  2. 또는 세션의 클라이언트 인코딩을 클라이언트가 보내는 값에 맞추세요.

    SET client_encoding = 'LATIN1';
  3. 로드하기 전에 파일을 변환합니다. 예를 들어 iconv -f WINDOWS-1252 -t UTF-8 in.csv > out.csv.

  4. 바이너리 데이터를 저장할 위치 bytea, 그리고 삽입하기 전에 애플리케이션에서 텍스트의 NUL 바이트를 제거합니다.

관련 오류

그 밖의 데이터 예외 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

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