// Referencia de errores de SQL Server

Error 8152 de SQL Server: datos de cadena o binarios truncados

El valor es más largo que la columna en la que va a entrar, así que SQL Server detiene el INSERT o el UPDATE en vez de recortarlo. Las versiones recientes nombran la columna (2628).

Número de error
8152
Gravedad
16
Categoría
Conversión y truncamiento de datos
Mensaje de error
String or binary data would be truncated.

Qué significa

SQL Server no acorta los datos en silencio. Si un valor de cadena o binario es más largo que la columna de destino, por ejemplo 60 caracteres en una varchar(50), la instrucción falla. El error 8152 no dice qué columna o fila; eso lo hacía difícil de depurar, así que SQL Server 2019 lo reemplazó con el error 2628, que indica la tabla, la columna y el valor truncado.

Causas comunes

  • Datos más largos que la longitud declarada de la columna, normalmente por entrada del usuario o una importación.
  • Una columna que es demasiado estrecha para los datos reales, como nvarchar(50) para direcciones de correo electrónico o nombres.
  • Una INSERT ... SELECT cuyas columnas están en un orden diferente al de la lista de columnas del destino, por lo que una columna larga termina en una corta.
  • Una variable o una variable de tabla declarada demasiado corta en un procedimiento, que se trunca en silencio en SET pero falla en INSERT.

Cómo solucionarlo

  1. En SQL Server 2019 y versiones posteriores, se obtiene el error 2628 con la columna y el valor en su lugar. Viene activado por defecto con nivel de compatibilidad de base de datos 150 o superior; también puedes activarlo explícitamente.

    ALTER DATABASE SCOPED CONFIGURATION SET VERBOSE_TRUNCATION_WARNINGS = ON;
  2. Compara las longitudes de origen con las columnas de destino para encontrar al culpable.

    SELECT MAX(LEN(Email)) AS max_email, MAX(LEN(Name)) AS max_name FROM staging.Customers;
    SELECT name, max_length, TYPE_NAME(user_type_id) AS type_name
    FROM sys.columns WHERE object_id = OBJECT_ID(N'dbo.Customers');
  3. Amplía la columna si los datos son legítimos.

    ALTER TABLE dbo.Customers ALTER COLUMN Email nvarchar(320) NOT NULL;
  4. O acorta a propósito donde la truncación sea aceptable.

    INSERT INTO dbo.Notes (Summary) SELECT LEFT(Body, 200) FROM staging.Notes;
  5. Siempre nombra las columnas de destino en INSERT ... SELECT para que el orden no se altere.

Reprodúcelo de forma segura

CREATE TABLE #t (code varchar(3));
INSERT INTO #t VALUES ('ABCD');  -- 8152, or 2628 on SQL Server 2019+
DROP TABLE #t;

Preguntas

¿Cómo averiguo qué columna se está truncando?

En SQL Server 2019 o posterior con nivel de compatibilidad 150, el error se convierte en 2628 e indica la tabla, la columna y el valor. En versiones anteriores, compara MAX(LEN(...)) de cada columna de origen con las longitudes de las columnas de destino.

¿Puedo hacer que SQL Server trunque en silencio?

SET ANSI_WARNINGS OFF hace que las inserciones se trunquen sin error, pero también cambia otros comportamientos y no está permitido con vistas indexadas ni índices de columnas calculadas. Mejor usa un LEFT() explícito cuando quieras truncar.

Errores relacionados

Más errores de conversión y truncamiento de datos

El código y el texto del mensaje son de Referencia de eventos y errores del motor de base de datos de Microsoft. Explora la lista completa de Lista de errores de SQL Server o buscar cada error de base de datos.

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

Trabajar con SQL Server 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 SQL Server y las demás bases de datos que uses.