Documentation incorrect pg_partition_root function description.

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: udv(dot)mail(at)gmail(dot)com
Subject: Documentation incorrect pg_partition_root function description.
Date: 2026-02-28 08:36:30
Message-ID: 177226779035.3161255.9286174854079010253@wrigleys.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/functions-admin.html
Description:

https://www.postgresql.org/docs/current/functions-admin.html

pg_partition_root ( regclass ) → regclass
Returns the top-most parent of the partition tree to which the given
relation belongs. Returns NULL if the relation does not exist or is not a
partition or partitioned table.

"does not exist" is not correct description, if table does not exist, we'll
get an error, not NULL:

EXAMPLE:
SELECT * FROM pg_partition_root( 'nonexisting_table' );

RESULT:
SQL Error [42P01]: ERROR: relation "nonexisting_table" does not exist
Position: 34

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Radoulov, Dimitre 2026-02-28 09:45:40 Re: Documentation clarification request: pg_dumpall and Large Objects
Previous Message David G. Johnston 2026-02-28 01:09:30 Re: A suggestion about the usage manual of \d command