// Referencia de errores de PostgreSQL

PostgreSQL 42501: permiso denegado

El rol actual carece de un privilegio que la instrucción necesita: en una tabla, esquema, secuencia, función o base de datos. Concédele el privilegio, o conéctate como un rol que lo tenga.

SQLSTATE
42501
Nombre
insufficient_privilege
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
permission denied for table orders

Qué significa

PostgreSQL verifica los privilegios en cada objeto que toca una instrucción. 42501 (insufficient_privilege) indica el tipo y el nombre del objeto, por ejemplo permission denied for table orders, permission denied for schema app o permission denied for sequence orders_id_seq. Las versiones anteriores dicen relation en lugar de table.

Se necesitan privilegios en cada nivel: USAGE en el esquema, luego SELECT, INSERT, UPDATE o DELETE en la tabla, y USAGE en la secuencia que hay detrás de una serial para inserciones.

Causas comunes

  • Al rol nunca se le otorgó el privilegio, o la concesión afectaba a otras tablas distintas de la que se está usando.
  • Tablas creadas después de un GRANT ... ON ALL TABLES IN SCHEMA, que solo cubre las tablas que existían en ese momento.
  • No USAGE en el esquema, o desde PostgreSQL 15 no CREATE en el public esquema para roles normales.
  • Insertar en una tabla con una serial columna sin USAGE en su secuencia.
  • Alterar o eliminar un objeto del que no eres propietario (must be owner of table orders, mismo código).

Cómo solucionarlo

  1. Concede los privilegios de tabla y de esquema que necesita el rol.

    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. Cubre las tablas creadas posteriormente con privilegios predeterminados (establecidos por el rol que crea las tablas).

    ALTER DEFAULT PRIVILEGES IN SCHEMA app
        GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;
  3. Comprueba qué tiene un rol.

    SELECT has_table_privilege('app_user', 'app.orders', 'INSERT'),
           has_schema_privilege('app_user', 'app', 'USAGE');
  4. En PostgreSQL 15 y posteriores, concede CREATE en public explícitamente si un rol debe crear objetos allí.

    GRANT CREATE ON SCHEMA public TO app_user;

Errores relacionados

Más errores de sintaxis o de violación de reglas de acceso

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.