// Referencia de errores de PostgreSQL

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
Mensaje de error
value too long for type character varying(20)

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 INSERT donde 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

  1. 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;
  2. Amplía la columna o usa text, que no tiene límite de longitud y funciona igual que varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. 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

Más errores de excepción de datos

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.

// menos errores, correcciones más rápidas

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.