Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit732457b

Browse files
committed
Doc: improve docs about pg_statistic_ext_data.
Commitaa087ec was a bit over-hasty about the doc changes neededwhile splitting pg_statistic_ext_data off from pg_statistic_ext.It duplicated one para and inserted another in what seems to meto be the wrong section. Fix that up, and in passing do some minorcopy-editing.Per report from noborusai.Discussion:https://postgr.es/m/CAAM3qnLXLUz4mOBkqa8jxigpKhKNxzSuvwpjvCRPvO5EqWjxSg@mail.gmail.com
1 parentac12ab0 commit732457b

File tree

1 file changed

+21
-27
lines changed

1 file changed

+21
-27
lines changed

‎doc/src/sgml/catalogs.sgml

Lines changed: 21 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -6376,28 +6376,6 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
63766376
about those tables that are readable by the current user.
63776377
</para>
63786378

6379-
<para>
6380-
<structname>pg_statistic</structname> should not be readable by the
6381-
public, since even statistical information about a table's contents
6382-
might be considered sensitive. (Example: minimum and maximum values
6383-
of a salary column might be quite interesting.)
6384-
<link linkend="view-pg-stats"><structname>pg_stats</structname></link>
6385-
is a publicly readable view on
6386-
<structname>pg_statistic</structname> that only exposes information
6387-
about those tables that are readable by the current user.
6388-
</para>
6389-
6390-
<para>
6391-
Similarly, <structname>pg_statistic_ext_data</structname> should not be
6392-
readable by the public, since the contents might be considered sensitive.
6393-
(Example: most common combination of values in columns might be quite
6394-
interesting.)
6395-
<link linkend="view-pg-stats-ext"><structname>pg_stats_ext</structname></link>
6396-
is a publicly readable view on <structname>pg_statistic_ext_data</structname>
6397-
(after joining with <structname>pg_statistic_ext</structname>) that only exposes
6398-
information about those tables and columns that are readable by the current user.
6399-
</para>
6400-
64016379
<table>
64026380
<title><structname>pg_statistic</structname> Columns</title>
64036381

@@ -6616,9 +6594,11 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
66166594
</table>
66176595

66186596
<para>
6619-
The <structfield>stxkind</structfield> field is filled at creation of the
6620-
statistics object, indicating which statistic type(s) are desired. The
6621-
statistics (once computed by <command>ANALYZE</command>) are stored in
6597+
The <structname>pg_statistic_ext</structname> entry is filled in
6598+
completely during <command>CREATE STATISTICS</command>, but the actual
6599+
statistical values are not computed then.
6600+
Subsequent <command>ANALYZE</command> commands compute the desired values
6601+
and populate an entry in the
66226602
<link linkend="catalog-pg-statistic-ext-data"><structname>pg_statistic_ext_data</structname></link>
66236603
catalog.
66246604
</para>
@@ -6638,6 +6618,20 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
66386618
created with <xref linkend="sql-createstatistics"/>.
66396619
</para>
66406620

6621+
<para>
6622+
Like <structname>pg_statistic</structname>,
6623+
<structname>pg_statistic_ext_data</structname> should not be
6624+
readable by the public, since the contents might be considered sensitive.
6625+
(Example: most common combinations of values in columns might be quite
6626+
interesting.)
6627+
<link linkend="view-pg-stats-ext"><structname>pg_stats_ext</structname></link>
6628+
is a publicly readable view
6629+
on <structname>pg_statistic_ext_data</structname> (after joining
6630+
with <structname>pg_statistic_ext</structname>) that only exposes
6631+
information about those tables and columns that are readable by the
6632+
current user.
6633+
</para>
6634+
66416635
<table>
66426636
<title><structname>pg_statistic_ext_data</structname> Columns</title>
66436637

@@ -6657,7 +6651,7 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
66576651
<entry><structfield>stxoid</structfield></entry>
66586652
<entry><type>oid</type></entry>
66596653
<entry><literal><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.oid</literal></entry>
6660-
<entry>Extended statistic containing the definition for this data.</entry>
6654+
<entry>Extended statisticobjectcontaining the definition for this data</entry>
66616655
</row>
66626656

66636657
<row>
@@ -6685,7 +6679,7 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
66856679
<entry></entry>
66866680
<entry>
66876681
MCV (most-common values) list statistics, serialized as
6688-
<structname>pg_mcv_list</structname> type.
6682+
<structname>pg_mcv_list</structname> type
66896683
</entry>
66906684
</row>
66916685

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp