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

PostgreSQL 42501: отказано в доступе

Текущая роль не имеет привилегии, необходимой для выполнения инструкции: на таблице, схеме, последовательности, функции или базе данных. Предоставьте её или подключитесь под ролью, которая её имеет.

SQLSTATE
42501
Имя
insufficient_privilege
Категория
Ошибка синтаксиса или нарушение правила доступа
Сообщение об ошибке
permission denied for table orders

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

PostgreSQL проверяет права доступа на каждый объект, к которому обращается запрос. 42501 (insufficient_privilege) указывает тип и имя объекта, например permission denied for table orders, permission denied for schema app или permission denied for sequence orders_id_seq. Более старые версии пишут relation вместо table.

Привилегии нужны на каждом уровне: USAGE на схеме, затем SELECT, INSERT, UPDATE или DELETE на таблице, и USAGE на последовательности, стоящей за serial столбца для вставок.

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

  • Роль никогда не получала эту привилегию, или она выдана на другие таблицы, а не на используемую.
  • Таблицы, созданные после GRANT ... ON ALL TABLES IN SCHEMA, что покрывает только таблицы, существовавшие на тот момент.
  • Нет USAGE на схеме, или с PostgreSQL 15 нет CREATE на public схеме для обычных ролей.
  • Вставка в таблицу с serial столбцом без USAGE на его последовательности.
  • Изменение или удаление объекта, который вам не принадлежит (must be owner of table orders, тот же код).

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

  1. Предоставьте роли привилегии на таблицу и схему.

    GRANT USAGE ON SCHEMA app TO app_user;
    GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA app TO app_user;
    GRANT USAGE ON ALL SEQUENCES IN SCHEMA app TO app_user;
  2. Охватите и таблицы, созданные позже, привилегиями по умолчанию (их задаёт роль, создающая таблицы).

    ALTER DEFAULT PRIVILEGES IN SCHEMA app
        GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;
  3. Проверьте, что есть у роли.

    SELECT has_table_privilege('app_user', 'app.orders', 'INSERT'),
           has_schema_privilege('app_user', 'app', 'USAGE');
  4. В PostgreSQL 15 и более поздних версиях предоставьте CREATE on public явно, если роль должна создавать там объекты.

    GRANT CREATE ON SCHEMA public TO app_user;

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

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

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

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

Работа с PostgreSQL в SQLly

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