// Referência de erro do PostgreSQL

PostgreSQL 42501: permissão negada

A função atual não tem um privilégio de que a instrução precisa: em uma tabela, esquema, sequência, função ou banco de dados. Conceda o privilégio, ou conecte-se como uma função que o tenha.

SQLSTATE
42501
Nome
insufficient_privilege
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
permission denied for table orders

O que significa

O PostgreSQL verifica privilégios em cada objeto que uma instrução acessa. 42501 (insufficient_privilege) indica o tipo e o nome do objeto, por exemplo permission denied for table orders, permission denied for schema app ou permission denied for sequence orders_id_seq. Versões mais antigas dizem relation em vez de table.

Privilégios são necessários em cada nível: USAGE no esquema, depois SELECT, INSERT, UPDATE ou DELETE na tabela, e USAGE na sequência por trás de uma serial coluna para inserções.

Causas comuns

  • O papel nunca recebeu o privilégio, ou a concessão foi feita em outras tabelas, e não na que está em uso.
  • Tabelas criadas após um GRANT ... ON ALL TABLES IN SCHEMA, o que cobre apenas tabelas que existiam na época.
  • Não USAGE no esquema, ou desde o PostgreSQL 15 não CREATE no public esquema para funções ordinárias.
  • Inserindo em uma tabela com uma serial coluna sem USAGE em sua sequência.
  • Alterando ou excluindo um objeto que você não possui (must be owner of table orders, mesmo código).

Como corrigir

  1. Conceda os privilégios de tabela e de esquema de que a função precisa.

    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. Para cobrir tabelas criadas depois, use privilégios padrão (definidos pela função que cria as tabelas).

    ALTER DEFAULT PRIVILEGES IN SCHEMA app
        GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;
  3. Verifique o que uma função possui.

    SELECT has_table_privilege('app_user', 'app.orders', 'INSERT'),
           has_schema_privilege('app_user', 'app', 'USAGE');
  4. No PostgreSQL 15 e posteriores, conceda CREATE em public explicitamente se uma função precisar criar objetos lá.

    GRANT CREATE ON SCHEMA public TO app_user;

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.