3.6 Inheritance Documentation - Mailing list pgsql-docs

From PG Doc comments form
Subject 3.6 Inheritance Documentation
Date
Msg-id 169100604868.635.1178692927881377748@wrigleys.postgresql.org
Whole thread Raw
Responses Re: 3.6 Inheritance Documentation
List 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.

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: word incorrectly on document
Next
From: PG Doc comments form
Date:
Subject: With recusive miss syntax definition