// Referência de erro do PostgreSQL

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
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

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 exemplo sales.orders enquanto 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

  1. Verifique onde você está e qual é o seu caminho de pesquisa.

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. 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';
  3. 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;
  4. 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

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.