From: Nathan Bossart <nathan@postgresql.org>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Improve privilege documentation for maintenance commands.
Date: Thu, 22 Jun 2023 22:49:28 +0000
Message-ID: <E1qCT7H-0038ej-VH@gemulon.postgresql.org> (raw)
Improve privilege documentation for maintenance commands.
The documentation of the required privileges for maintenance
commands (i.e., VACUUM, ANALYZE, CLUSTER, LOCK TABLE, REFRESH
MATERIALIZED VIEW, and REINDEX) is redundant, inaccurate, and
difficult to read. This commit fixes and simplifies this
documentation by removing references to ownership, superuser, and
the pg_maintain role. In addition, this removes notes about
database-wide VACUUM and ANALYZE, clarifies matters for REINDEX on
partitioned indexes and tables, and strengthens the description of
the pg_maintain role.
Reviewed-by: Michael Paquier, Jeff Davis
Discussion: https://postgr.es/m/20230615041044.GA736001%40nathanxps13
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/c2122aae636d7121d5cdb64ad1444e1df7f69257
Modified Files
--------------
doc/src/sgml/ref/analyze.sgml | 8 +-------
doc/src/sgml/ref/cluster.sgml | 6 +-----
doc/src/sgml/ref/lock.sgml | 6 ++----
doc/src/sgml/ref/refresh_materialized_view.sgml | 6 ++----
doc/src/sgml/ref/reindex.sgml | 26 ++++++++++++-------------
doc/src/sgml/ref/vacuum.sgml | 8 +-------
doc/src/sgml/user-manag.sgml | 3 ++-
7 files changed, 22 insertions(+), 41 deletions(-)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-committers@postgresql.org
Cc: nathan@postgresql.org, pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: Improve privilege documentation for maintenance commands.
In-Reply-To: <E1qCT7H-0038ej-VH@gemulon.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox