1
0
mirror of https://github.com/postgres/postgres.git synced 2025-11-04 20:11:56 +03:00
Files
postgres/doc/src/sgml
David Rowley c3b9e56513 Doc: clarify n_distinct_inherited setting
There was some confusion around how to adjust the n_distinct estimates
for partitioned tables.  Here we try and clarify that
n_distinct_inherited needs to be adjusted rather than n_distinct.

Also fix some slightly misleading text which was talking about table
size rather than table rows, fix a grammatical error, and adjust some
text which indicated that ANALYZE was performing calculations based on
the n_distinct settings.  Really it's the query planner that does this
and ANALYZE only stores the overridden n_distinct estimate value in
pg_statistic.

Author: David Rowley <dgrowleyml@gmail.com>
Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
Reviewed-by: Chao Li <li.evan.chao@gmail.com>
Backpatch-through: 13
Discussion: https://postgr.es/m/CAApHDvrL7a-ZytM1SP8Uk9nEw9bR2CPzVb+uP+bcNj=_q-ZmVw@mail.gmail.com
2025-10-14 09:27:38 +13:00
..
2020-04-11 21:07:20 -07:00
2021-11-24 18:34:25 +02:00
2020-07-05 15:38:14 +02:00
2020-02-26 13:05:30 -08:00
2020-03-29 11:15:11 +02:00
2020-11-25 09:51:00 +01:00
2020-07-18 22:43:41 +09:00
2020-10-19 19:29:52 +03:00
2020-07-18 22:43:41 +09:00
2020-08-25 07:30:22 +02:00
2020-06-07 13:18:36 +02:00
2020-09-09 12:22:38 +02:00
2020-07-18 22:43:41 +09:00
2020-10-19 19:29:52 +03:00
2021-07-05 09:52:05 +05:30
2025-04-07 00:03:18 +02:00
2020-07-18 22:43:41 +09:00
2025-02-05 13:58:40 +01:00
2021-09-19 11:36:53 -04:00
2021-01-05 14:26:37 -05:00
2022-07-08 18:36:27 -04:00
2025-07-17 00:21:18 +02:00
2020-10-19 19:29:52 +03:00
2019-09-08 10:27:29 +02:00
2019-08-13 08:40:17 +02:00
2019-09-08 10:27:29 +02:00
2021-12-08 16:54:31 -05:00
2019-09-08 10:27:29 +02:00

<!-- doc/src/sgml/README.links -->

Linking within DocBook documents can be confusing, so here is a summary:


Intra-document Linking
----------------------

<xref>
	use to get chapter/section number from the title of the target
	link, or xreflabel if defined at the target, or refentrytitle if target
        is a refentry;  has no close tag
	http://www.oasis-open.org/docbook/documentation/reference/html/xref.html

linkend=
	controls the target of the link/xref, required

endterm=
	for <xref>, allows the text of the link/xref to be taken from a
	different link target title

<link>
	use to supply text for the link, only uses linkend, requires </link>
	http://www.oasis-open.org/docbook/documentation/reference/html/link.html


External Linking
----------------

<ulink>
	like <link>, but uses a URL (not a document target);  requires
	</ulink>; if no text is specified, the URL appears as the link
	text
	http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html

url=
	used by <ulink> to specify the URL, required


Guidelines
----------

- For an internal link, if you want to supply text, use <link>, else
  <xref>.

- Specific nouns like GUC variables, SQL commands, and contrib modules
  usually have xreflabels.

- For an external link, use <ulink>, with or without link text.