pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
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(-)



Message-ID: <E1qCT7H-0038ej-VH@gemulon.postgresql.org>
Permalink:  ../E1qCT7H-0038ej-VH@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1qCT7H-0038ej-VH@gemulon.postgresql.org

 · 

reply

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