mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Doc: document cases where queryid is stable

Browse Source 
The documents were clear that queryid should not be assumed to be stable
between major versions but said nothing about minor versions and left
the reader to guess if that was implied by the mention of the
instability of queryid between major versions.

Here we give minor versions an explicit mention to indicate queryid can
generally be assumed stable between minor versions.

Reviewed-by: Michael Paquier
Discussion: https://postgr.es/m/CAApHDvpYGE6h0cD9UO-eHySPynPj1L3J%3DHxT%2BA7Ud8_Yo6AuzA%40mail.gmail.com
Backpatch-through: 12
This commit is contained in:
David Rowley 2024-04-20 13:55:07 +12:00
parent 41c0c493ad
commit c6e229d5f7
1 changed files with 15 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
doc/src/sgml/pgstatstatements.sgml
View File

@ -460,15 +460,21 @@
</para> </para>
<para> <para>
As a rule of thumb, <structfield>queryid</structfield> values can be assumed to be Two servers participating in replication based on physical WAL replay can
stable and comparable only so long as the underlying server version and be expected to have identical <structfield>queryid</structfield> values for
catalog metadata details stay exactly the same. Two servers the same query. However, logical replication schemes do not promise to
participating in replication based on physical WAL replay can be expected keep replicas identical in all relevant details, so
to have identical <structfield>queryid</structfield> values for the same query. <structfield>queryid</structfield> will not be a useful identifier for
However, logical replication schemes do not promise to keep replicas accumulating costs across a set of logical replicas.
identical in all relevant details, so <structfield>queryid</structfield> will If in doubt, direct testing is recommended.
not be a useful identifier for accumulating costs across a set of logical </para>
replicas. If in doubt, direct testing is recommended.
<para>
Generally, it can be assumed that <structfield>queryid</structfield> values
are stable between minor version releases of <productname>PostgreSQL</productname>,
providing that instances are running on the same machine architecture and
the catalog metadata details match. Compatibility will only be broken
between minor versions as a last resort.
</para> </para>
<para> <para>