// Referência de erro do PostgreSQL

PostgreSQL 42846: impossível coerção

Um cast explícito entre dois tipos que não têm conversão definida, como inteiro para uuid ou booleano para data.

SQLSTATE
42846
Nome
cannot_coerce
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
cannot cast type integer to uuid

O que significa

O PostgreSQL só faz cast entre tipos quando um cast é definido para aquele par. 42846 (cannot_coerce) significa que você pediu um com ::type ou CAST e nenhum existe, então o PostgreSQL não consegue converter o valor, não importa o que ele contenha.

Isso difere do 22P02, caso em que o cast existe, mas o valor de texto específico é inválido. Normalmente, a solução é converter via texto ou usar uma função que construa o tipo de destino corretamente.

Causas comuns

  • Converter entre tipos não relacionados, como integer para uuid, boolean para date ou jsonb para integer[].
  • Converter um valor composto ou array em um tipo escalar.
  • Código portado de outro banco de dados que permite a conversão.

Como corrigir

  1. Converta via texto quando a forma textual for uma entrada válida para o tipo de destino.

    SELECT 42::text::numeric;
    SELECT ('{"n": 7}'::jsonb ->> 'n')::int;
  2. Use uma função de conversão que constrói o tipo de destino.

    SELECT to_timestamp(1700000000);
    SELECT ARRAY(SELECT jsonb_array_elements_text('[1,2,3]'::jsonb)::int);
  3. Liste os casts que existem a partir de um tipo.

    SELECT castsource::regtype, casttarget::regtype, castcontext
    FROM pg_cast WHERE castsource = 'integer'::regtype;

Reproduza com segurança

SELECT 1::uuid;  -- ERROR: cannot cast type integer to uuid

Erros relacionados

Mais erros de sintaxe ou violação de regra de acesso

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.