// Referência de erro do SQL Server

Erro do SQL Server 8152: Dados de string ou binários truncados

Um valor é mais longo do que a coluna na qual está sendo inserido, então o SQL Server interrompe o INSERT ou UPDATE em vez de cortá-lo. Versões mais recentes nomeiam a coluna (2628).

Número do erro
8152
Gravidade
16
Categoria
Conversão e truncamento de dados
Mensagem de erro
String or binary data would be truncated.

O que significa

O SQL Server não encurta os dados sem aviso. Se um valor de string ou binário for mais longo do que a coluna de destino, por exemplo, 60 caracteres em uma varchar(50), a instrução falha. O erro 8152 não diz qual coluna ou linha; isso dificultava a depuração, então o SQL Server 2019 o substituiu pelo erro 2628, que informa a tabela, a coluna e o valor truncado.

Causas comuns

  • Dados mais longos do que o comprimento declarado da coluna, frequentemente provenientes de entrada de usuário ou de uma importação.
  • Uma coluna que é estreita demais para os dados reais, como nvarchar(50) para endereços de e-mail ou nomes.
  • Uma INSERT ... SELECT cujas colunas estão em uma ordem diferente da lista de colunas do destino, de modo que uma coluna longa acaba em uma curta.
  • Uma variável ou variável de tabela declarada curta demais em um procedimento, que trunca silenciosamente em SET mas falha em INSERT.

Como corrigir

  1. No SQL Server 2019 e posteriores, o erro passa a ser o 2628, com a coluna e o valor. Vem ativado por padrão no nível de compatibilidade de banco de dados 150 ou superior; você também pode ativá-lo explicitamente.

    ALTER DATABASE SCOPED CONFIGURATION SET VERBOSE_TRUNCATION_WARNINGS = ON;
  2. Compare os comprimentos da fonte com as colunas do destino para encontrar o culpado.

    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. Alargue a coluna se os dados forem legítimos.

    ALTER TABLE dbo.Customers ALTER COLUMN Email nvarchar(320) NOT NULL;
  4. Ou encurte de propósito onde o truncamento for aceitável.

    INSERT INTO dbo.Notes (Summary) SELECT LEFT(Body, 200) FROM staging.Notes;
  5. Sempre nomeie as colunas de destino em INSERT ... SELECT para que a ordem não mude.

Reproduza com segurança

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

Perguntas

Como descobrir qual coluna está sendo truncada?

No SQL Server 2019 ou posterior, com nível de compatibilidade 150, o erro se torna 2628 e nomeia a tabela, a coluna e o valor. Em versões anteriores, compare MAX(LEN(...)) de cada coluna de origem com os comprimentos das colunas de destino.

Posso fazer o SQL Server truncar em silêncio em vez disso?

SET ANSI_WARNINGS OFF faz com que os inserts sejam truncados sem erro, mas também altera outros comportamentos e não é permitido com views indexadas ou índices de colunas calculadas. Prefira um LEFT() explícito quando o truncamento for intencional.

Erros relacionados

Mais erros de conversão de dados e truncamento

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQL Server no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQL Server e os outros bancos de dados que você usa.