3.6 Inheritance Documentation

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: watermelonmania79(at)gmail(dot)com
Subject: 3.6 Inheritance Documentation
Date: 2023-08-02 19:54:08
Message-ID: 169100604868.635.1178692927881377748@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/15/tutorial-inheritance.html
Description:

The documentation for inheritance in PostgreSQL is not entirely accurate in
the given example.

In the provided example, the cities table and the capitals table have a
parent-child relationship through inheritance. However, querying the cities
table directly (e.g., SELECT name, elevation FROM cities WHERE elevation >
500;) will not automatically include data from the child table, capitals.
Inheritance in PostgreSQL does not implicitly combine data from parent and
child tables in a single query.

To include data from both the parent and child tables, a UNION or other join
operations must be used, as I previously explained.

The documentation should be corrected to clarify that inheritance does not
automatically combine data from parent and child tables when querying the
parent table directly. It might be updated to provide a better example
demonstrating the use of UNION or JOIN operations to retrieve data from both
parent and child tables.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2023-08-02 21:02:55 With recusive miss syntax definition
Previous Message David G. Johnston 2023-08-01 20:56:27 Re: word incorrectly on document