PostgreSQL 42P01: relação não existe
O PostgreSQL não consegue encontrar a tabela, visão ou sequência. Geralmente é o esquema errado no search_path, um nome entre aspas com letras maiúsculas e minúsculas, ou o banco de dados errado.
- SQLSTATE
42P01- Nome
undefined_table
O que significa
No PostgreSQL, uma relação é qualquer objeto semelhante a uma tabela: uma tabela, visão, visão materializada, sequência, índice ou tabela estrangeira. 42P01 significa que o nome que você usou não corresponde a nenhum deles, nos esquemas listados no seu search_path (ou no esquema que você nomeou explicitamente).
O PostgreSQL converte para minúsculas nomes sem aspas. Uma tabela criada como "Orders" (entre aspas, com O maiúsculo) só pode ser referida como "Orders", então SELECT * FROM Orders procura por orders e falha.
Causas comuns
- A tabela está em um esquema que não está no
search_path, por exemplosales.ordersenquanto o caminho é"$user", public. - A tabela foi criada com um nome entre aspas com maiúsculas e minúsculas (comum em ORMs e ferramentas GUI) e a consulta não o coloca entre aspas.
- Você está conectado a um banco de dados diferente daquele que contém a tabela. O PostgreSQL não pode consultar entre bancos de dados com um nome simples.
- A tabela ainda não foi criada, ou uma migração falhou ou foi executada em outro banco de dados.
- Um erro de digitação no nome da tabela.
Como corrigir
-
Verifique onde você está e qual é o seu caminho de pesquisa.
SELECT current_database(), current_schema(); SHOW search_path;
-
Encontre a tabela, não importando o esquema nem as maiúsculas e minúsculas do nome.
SELECT table_schema, table_name FROM information_schema.tables WHERE lower(table_name) = 'orders';
-
Qualifique o nome com seu esquema, ou adicione o esquema ao caminho de pesquisa.
SELECT * FROM sales.orders; SET search_path TO sales, public; -- permanently for a role: ALTER ROLE app SET search_path TO sales, public;
-
Se a tabela foi criada com letras maiúsculas, coloque-a entre aspas exatamente como foi criada, ou renomeie-a para minúsculas uma única vez para que nunca precise de aspas.
SELECT * FROM "Orders"; ALTER TABLE "Orders" RENAME TO orders;
Reproduza com segurança
SELECT * FROM table_that_does_not_exist; -- ERROR: relation "table_that_does_not_exist" does not exist
Perguntas
A tabela existe, então por que o PostgreSQL diz que a relação não existe?
Quase sempre é o esquema ou a capitalização. Ou o esquema da tabela não está no seu search_path, ou ela foi criada com um nome entre aspas com maiúsculas e minúsculas e precisa ser citada da mesma forma. Consultar information_schema.tables com lower(table_name) mostra o esquema e a grafia reais da tabela.
Posso selecionar de uma tabela em outro banco de dados?
Não diretamente. Cada conexão PostgreSQL é com um banco de dados. Use as extensões postgres_fdw ou dblink, ou conecte-se ao outro banco de dados.
Erros relacionados
42703a coluna não existe3F000o esquema não existe3D000o banco de dados não existe42501permissão negada208SQL Server: Nome de objeto inválido1146MySQL: a tabela não existeORA-00942Oracle: tabela ou view não existe
Mais erros de sintaxe ou violação de regra de acesso
42601erro de sintaxe próximo a42846não é possível converter42803a coluna deve aparecer na cláusula GROUP BY42830chave estrangeira inválida42804incompatibilidade de tipo de dado42P18não foi possível determinar o tipo de dado do parâmetro42883função não existe42P02não há parâmetro
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.