// Referência de erro do PostgreSQL

PostgreSQL 22001: valor muito longo para o tipo

Uma string é mais longa do que o limite varchar(n) ou char(n) da coluna. O PostgreSQL a rejeita em vez de truncá-la silenciosamente.

SQLSTATE
22001
Nome
string_data_right_truncation
Categoria
Exceção de dados
Mensagem de erro
value too long for type character varying(20)

O que significa

A varchar(n) ou char(n) A coluna suporta no máximo n caracteres. Inserir ou atualizar um valor mais longo resulta em falha com 22001 (string_data_right_truncation). O PostgreSQL só trunca silenciosamente quando você faz um cast explícito, como em 'abcdef'::varchar(3), como exigido pelo padrão SQL.

A mensagem informa o tipo, mas não a coluna, então com várias colunas limitadas você precisa verificar qual valor é muito longo.

Causas comuns

  • Entrada do usuário ou dados importados maiores que a definição da coluna.
  • Uma tabela de várias colunas INSERT onde os valores estão em uma ordem diferente da lista de colunas, colocando um valor longo em uma coluna curta.
  • Um esquema migrado de outro banco de dados com limites rígidos.

Como corrigir

  1. Encontre qual coluna estourou comparando o tamanho dos valores com os limites.

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. Alargue a coluna, ou use text, que não tem limite de comprimento e executa da mesma forma que varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. Se o truncamento for aceitável, faça-o explicitamente.

    INSERT INTO customers (name) VALUES (left('a very long name ...', 20));

Reproduza com segurança

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)

Perguntas

O tipo text é mais lento que varchar no PostgreSQL?

Não. text e varchar usam o mesmo armazenamento. Um limite de comprimento é uma restrição sobre os dados, não um recurso de desempenho.

Erros relacionados

Mais erros de exceção de dados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

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

Trabalhe com PostgreSQL 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 PostgreSQL e os outros bancos de dados que você usa.