// справочник ошибок PostgreSQL

PostgreSQL 42P01: отношение не существует

PostgreSQL не находит таблицу, представление или последовательность. Обычно это неверная схема в search_path, имя в кавычках со смешанным регистром или другая база данных.

SQLSTATE
42P01
Имя
undefined_table
Категория
Ошибка синтаксиса или нарушение правила доступа
Сообщение об ошибке
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

Что это значит

В PostgreSQL отношение — это любой объект, похожий на таблицу: таблица, представление, материализованное представление, последовательность, индекс или внешняя таблица. 42P01 означает, что имя, которое вы использовали, не указывает ни на один из таких объектов в схемах, перечисленных в вашем search_path (или в явным образом указанной вами схеме).

PostgreSQL приводит имена без кавычек к нижнему регистру. Таблицу, созданную как "Orders" (в кавычках, с заглавной O) можно упоминать только как "Orders", так что SELECT * FROM Orders пытается найти orders и терпит неудачу.

Распространённые причины

  • Таблица находится в схеме, которой нет в search_path, например sales.orders тогда как путь — "$user", public.
  • Таблица была создана с заключённым в кавычки именем в смешанном регистре (так делают ORM и GUI-инструменты), а в запросе оно в кавычки не заключено.
  • Вы подключены к другой базе данных, чем та, в которой находится таблица. PostgreSQL не может выполнять запросы между базами данных по простому имени.
  • Таблица ещё не создана, или миграция не удалась либо была выполнена в другой базе данных.
  • Опечатка в имени таблицы.

Как исправить

  1. Проверьте, где вы находитесь и есть ли там этот объект.

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. Найдите таблицу независимо от её схемы и регистра имени.

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. Уточните имя схемой или добавьте схему в путь поиска.

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. Если таблица создана с заглавными буквами, заключайте её имя в кавычки точно, либо один раз переименуйте её в нижний регистр — и кавычки больше не понадобятся.

    SELECT * FROM "Orders";
    ALTER TABLE "Orders" RENAME TO orders;

Безопасное воспроизведение

SELECT * FROM table_that_does_not_exist;  -- ERROR: relation "table_that_does_not_exist" does not exist

Вопросы

Таблица существует, так почему PostgreSQL говорит, что отношение не существует?

Почти всегда дело в схеме или регистре. Либо схема таблицы не входит в ваш search_path, либо её создали с именем в смешанном регистре в кавычках — и обращаться к ней нужно так же, в кавычках. Запрос к information_schema.tables с lower(table_name) покажет настоящую схему и написание.

Могу ли я выбрать данные из таблицы в другой базе данных?

Не напрямую. Каждое подключение PostgreSQL работает с одной базой данных. Используйте расширения postgres_fdw или dblink либо подключайтесь к другой базе данных.

Связанные ошибки

Больше ошибок синтаксиса или нарушения правил доступа

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.