Commit 2ebb8416 authored by John Naylor's avatar John Naylor

Clarify that pg_dump takes ACCESS SHARE lock

Add link to the description of lock levels to avoid confusing "shared locks"
with SHARE locks.

Florin Irion

Reviewed-by: Álvaro Herrera, Tom Lane, and Nathan Bossart
Discussion: https://www.postgresql.org/message-id/flat/d0f30cc2-3c76-1d43-f291-7c4b2872d653@gmail.com

This is a backpatch of 4e2e8d71f, applied through version 14
parent e1d5ac31
...@@ -372,8 +372,8 @@ PostgreSQL documentation ...@@ -372,8 +372,8 @@ PostgreSQL documentation
<para> <para>
Requesting exclusive locks on database objects while running a parallel dump could Requesting exclusive locks on database objects while running a parallel dump could
cause the dump to fail. The reason is that the <application>pg_dump</application> leader process cause the dump to fail. The reason is that the <application>pg_dump</application> leader process
requests shared locks on the objects that the worker processes are going to dump later requests shared locks (<link linkend="locking-tables">ACCESS SHARE</link>) on the
in order to objects that the worker processes are going to dump later in order to
make sure that nobody deletes them and makes them go away while the dump is running. make sure that nobody deletes them and makes them go away while the dump is running.
If another client then requests an exclusive lock on a table, that lock will not be If another client then requests an exclusive lock on a table, that lock will not be
granted but will be queued waiting for the shared lock of the leader process to be granted but will be queued waiting for the shared lock of the leader process to be
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment