PostgreSQL 22001: valor demasiado largo para el tipo
Una cadena es más larga que el límite de varchar(n) o char(n) de la columna. PostgreSQL la rechaza en lugar de truncarla silenciosamente.
- SQLSTATE
22001- Nombre
string_data_right_truncation- Categoría
- Excepción de datos
Qué significa
A varchar(n) o char(n) columna admite como máximo n caracteres. Insertar o actualizar un valor más largo falla con 22001 (string_data_right_truncation). PostgreSQL solo trunca en silencio cuando haces un cast explícito, como en 'abcdef'::varchar(3), que es lo que exige el estándar SQL.
El mensaje indica el tipo pero no la columna, así que si hay varias columnas con límite tienes que comprobar qué valor es demasiado largo.
Causas comunes
- Entrada del usuario o datos importados más largos que la definición de la columna.
- Una tabla de varias columnas
INSERTdonde los valores están en un orden diferente al de la lista de columnas, poniendo un valor largo en una columna corta. - Un esquema migrado desde otra base de datos con límites estrictos.
Cómo solucionarlo
-
Encuentra qué columna se desbordó comparando la longitud de los valores con los límites.
SELECT column_name, character_maximum_length FROM information_schema.columns WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
-
Amplía la columna o usa
text, que no tiene límite de longitud y funciona igual quevarchar.ALTER TABLE customers ALTER COLUMN name TYPE varchar(200); -- or ALTER TABLE customers ALTER COLUMN name TYPE text;
-
Si el truncado es aceptable, hazlo explícitamente.
INSERT INTO customers (name) VALUES (left('a very long name ...', 20));
Reprodúcelo de forma segura
SELECT CAST('abc' AS varchar(2)) AS silently_truncated;
CREATE TEMP TABLE t (code varchar(2));
INSERT INTO t VALUES ('abc'); -- ERROR: value too long for type character varying(2)
Preguntas
¿Es text más lento que varchar en PostgreSQL?
No. text y varchar usan el mismo almacenamiento. Un límite de longitud es una restricción sobre los datos, no una característica de rendimiento.
Errores relacionados
22003valor numérico fuera de rango22P02sintaxis de entrada no válida para el tipo8152SQL Server: Datos de cadena o binarios truncados2628SQL Server: Se truncó en la tabla, columna1406MySQL: datos demasiado largos para la columnaORA-12899Oracle: valor demasiado grande para la columna
Más errores de excepción de datos
22021secuencia de bytes no válida para la codificación22008valor del campo fecha/hora fuera de rango22012división por cero22007formato de fecha/hora no válido22023valor de parámetro no válido
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.