From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | pgsql-committers(at)lists(dot)postgresql(dot)org |
Subject: | pgsql: Doc: update the "Using EXPLAIN" examples to match current code. |
Date: | 2024-05-09 22:56:56 |
Message-ID: | E1s5Ch5-000E4n-I5@gemulon.postgresql.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-committers |
Doc: update the "Using EXPLAIN" examples to match current code.
A lot of the examples in this section are quite ancient and no
longer match the system's current behavior. I ran through them
and updated the sample output to match what I get today.
Notably, it seems that the tenk1 table got a few pages smaller back
around v12, so that a lot of the cost estimates for queries on that
table are a little different now. (This also caused some examples
to surprisingly not match others, depending on when they were made.)
One mergejoin-based example no longer produces the same plan at all,
so I had to work around that, including switching to a different
example of using an enable_xxx setting.
I also changed a couple of examples that were relying on nonexistent
tables or indexes. IMO the premise of this section is that the
examples should be more-or-less reproducible against the regression
database, so that these examples were unhelpful as given. It's not
that hard to find a corresponding example with the tables we do have.
Some of the EXPLAIN ANALYZE examples were out of date in that we show
more numbers than we did at the time.
Possibly chapter 68 could use similar review, but I'm out of
energy for today.
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/5caa0574963c75cfe7745b1b05f1fd51e3fdf16e
Modified Files
--------------
doc/src/sgml/perform.sgml | 280 +++++++++++++++++++++++++---------------------
1 file changed, 150 insertions(+), 130 deletions(-)
From | Date | Subject | |
---|---|---|---|
Next Message | Alvaro Herrera | 2024-05-10 11:59:39 | Re: pgsql: Fix overread in JSON parsing errors for incomplete byte sequence |
Previous Message | Bruce Momjian | 2024-05-09 20:38:14 | pgsql: doc PG 17 relnotes: fix author of LLVM item |