PostgreSQL 22P02: sintaxe de entrada inválida para o tipo
Um valor de texto não pôde ser convertido para o tipo de destino: letras em um inteiro, um UUID malformado, JSON inválido, uma string vazia para um número.
- SQLSTATE
22P02- Nome
invalid_text_representation- Categoria
- Exceção de dados
O que significa
O PostgreSQL converte literais e textos em valores tipados usando a função de entrada de cada tipo. Quando o texto não é uma representação válida do tipo, a conversão falha com 22P02 e a mensagem mostra o valor culpado.
O valor pode vir de um literal na consulta, um parâmetro vinculado, um CAST, ou uma coluna de texto sendo comparada com ou inserida em uma coluna tipada.
Causas comuns
- Comparando uma coluna numérica ou UUID com uma string que não é um número nem um UUID, por exemplo
WHERE id = 'abc'ou uma string vazia''. - Passar uma string vazia onde se espera um número. O PostgreSQL não converte
''emNULLou 0. - Entrada malformada para
uuid,json/jsonb,boolean,inetou um literal de array. - Em massa
COPYou cargas CSV onde uma linha tem texto em uma coluna numérica.
Como corrigir
-
Encontre linhas que não seriam convertidas antes de fazer o cast delas (o PostgreSQL 16 e posteriores têm
pg_input_is_valid).SELECT raw_value FROM staging WHERE NOT pg_input_is_valid(raw_value, 'integer');
-
Em versões mais antigas, filtre com um padrão antes de fazer o cast.
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
Transforme strings vazias em
NULLexplicitamente.SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
No código de aplicação, vincule parâmetros com o tipo correto em vez de construir strings SQL, e valide a entrada antes que ela chegue ao banco de dados.
Reproduza com segurança
SELECT 'abc'::int; -- ERROR: invalid input syntax for type integer: "abc"
Erros relacionados
22003valor numérico fora do intervalo22007formato de data/hora inválido42804incompatibilidade de tipo de dado22021sequência de bytes inválida para a codificação245SQL Server: Falha ao converter um valor1366MySQL: valor incorreto para a colunaORA-01722Oracle: número inválido
Mais erros de exceção de dados
22008valor do campo data/hora fora do intervalo22012divisão por zero22023valor de parâmetro inválido22001valor muito longo para o tipo
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.
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.