PostgreSQL 22021: secuencia de bytes no válida para la codificación
El texto contiene bytes que no son válidos en la codificación de la base de datos o del cliente: un archivo Latin-1 o Windows-1252 cargado como UTF-8, o un byte NUL en el texto.
- SQLSTATE
22021- Nombre
character_not_in_repertoire- Categoría
- Excepción de datos
Qué significa
PostgreSQL verifica que cada valor de texto sea válido en la codificación en la que llega. 22021 (character_not_in_repertoire) significa que una secuencia de bytes no es un carácter válido allí. Con una base de datos UTF-8, normalmente significa que los datos estaban en realidad en otra codificación, como Latin-1 o Windows-1252, donde bytes como 0xe9 (é) son bytes individuales que por sí solos no son UTF-8 válido.
Los tipos de texto de PostgreSQL nunca pueden contener el byte NUL, así que invalid byte sequence for encoding "UTF8": 0x00 significa que datos binarios o de tipo C-string llegaron a una columna de texto.
Causas comunes
- Cargando un CSV exportado por una herramienta que escribió en Windows-1252 o Latin-1, con
COPYo\copyasumiendo UTF-8. client_encodingestablecido enUTF8mientras que el cliente en realidad envía otra codificación.- Datos binarios, o cadenas con bytes NUL incrustados, insertados en un
textovarcharcolumna. - Datos truncados en medio de un carácter de varios bytes por una aplicación.
Cómo solucionarlo
-
Indica
COPYla codificación real del archivo; PostgreSQL la convierte.\copy customers FROM 'customers.csv' WITH (FORMAT csv, HEADER true, ENCODING 'WIN1252')
-
O establece la codificación de cliente de la sesión para que coincida con lo que envía el cliente.
SET client_encoding = 'LATIN1';
-
Convierte el archivo antes de cargarlo, por ejemplo
iconv -f WINDOWS-1252 -t UTF-8 in.csv > out.csv. -
Guarda datos binarios en
bytea, y eliminar bytes NUL del texto en la aplicación antes de insertar.
Errores relacionados
22P02sintaxis de entrada no válida para el tipo22001valor demasiado largo para el tipo58P01archivo indefinido1366MySQL: valor incorrecto para la columna
Más errores de excepción de datos
22008valor del campo fecha/hora fuera de rango22012división por cero22007formato de fecha/hora no válido22023valor de parámetro no válido22003valor numérico fuera de rango
El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.
Trabajar con PostgreSQL en SQLly
Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.