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

Commitd7ee431

Browse files
committed
Fix alphabetization in catalogs.sgml.
Some recent patches seem not to have grasped the concept that the catalogsare described in alphabetical order.
1 parentf7fbf4b commitd7ee431

File tree

1 file changed

+147
-146
lines changed

1 file changed

+147
-146
lines changed

‎doc/src/sgml/catalogs.sgml

Lines changed: 147 additions & 146 deletions
Original file line numberDiff line numberDiff line change
@@ -99,13 +99,13 @@
9999
</row>
100100

101101
<row>
102-
<entry><link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link></entry>
103-
<entry>check constraints, unique constraints, primary key constraints, foreign key constraints</entry>
102+
<entry><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link></entry>
103+
<entry>collations (locale information)</entry>
104104
</row>
105105

106106
<row>
107-
<entry><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link></entry>
108-
<entry>collations (locale information)</entry>
107+
<entry><link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link></entry>
108+
<entry>check constraints, unique constraints, primary key constraints, foreign key constraints</entry>
109109
</row>
110110

111111
<row>
@@ -1965,20 +1965,22 @@
19651965
</para>
19661966
</sect1>
19671967

1968-
<sect1 id="catalog-pg-event-trigger">
1969-
<title><structname>pg_event_trigger</structname></title>
1968+
<sect1 id="catalog-pg-collation">
1969+
<title><structname>pg_collation</structname></title>
19701970

1971-
<indexterm zone="catalog-pg-event-trigger">
1972-
<primary>pg_event_trigger</primary>
1971+
<indexterm zone="catalog-pg-collation">
1972+
<primary>pg_collation</primary>
19731973
</indexterm>
19741974

19751975
<para>
1976-
The catalog <structname>pg_event_trigger</structname> stores event triggers.
1977-
See <xref linkend="event-triggers"> for more information.
1976+
The catalog <structname>pg_collation</structname> describes the
1977+
available collations, which are essentially mappings from an SQL
1978+
name to operating system locale categories.
1979+
See <xref linkend="collation"> for more information.
19781980
</para>
19791981

19801982
<table>
1981-
<title><structname>pg_event_trigger</> Columns</title>
1983+
<title><structname>pg_collation</> Columns</title>
19821984

19831985
<tgroup cols="4">
19841986
<thead>
@@ -1992,59 +1994,83 @@
19921994

19931995
<tbody>
19941996
<row>
1995-
<entry><structfield>evtname</structfield></entry>
1996-
<entry><type>name</type></entry>
1997+
<entry><structfield>oid</structfield></entry>
1998+
<entry><type>oid</type></entry>
19971999
<entry></entry>
1998-
<entry>Trigger name (must beunique)</entry>
2000+
<entry>Row identifier (hidden attribute;must beexplicitly selected)</entry>
19992001
</row>
20002002

20012003
<row>
2002-
<entry><structfield>evtevent</structfield></entry>
2004+
<entry><structfield>collname</structfield></entry>
20032005
<entry><type>name</type></entry>
20042006
<entry></entry>
2005-
<entry>Identifies the event for which this trigger fires</entry>
2007+
<entry>Collation name (unique per namespace and encoding)</entry>
20062008
</row>
20072009

20082010
<row>
2009-
<entry><structfield>evtowner</structfield></entry>
2011+
<entry><structfield>collnamespace</structfield></entry>
20102012
<entry><type>oid</type></entry>
2011-
<entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry>
2012-
<entry>Owner of the event trigger</entry>
2013+
<entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry>
2014+
<entry>
2015+
The OID of the namespace that contains this collation
2016+
</entry>
20132017
</row>
20142018

20152019
<row>
2016-
<entry><structfield>evtfoid</structfield></entry>
2020+
<entry><structfield>collowner</structfield></entry>
20172021
<entry><type>oid</type></entry>
2018-
<entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry>
2019-
<entry>The function to be called</entry>
2022+
<entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry>
2023+
<entry>Owner of the collation</entry>
20202024
</row>
20212025

20222026
<row>
2023-
<entry><structfield>evtenabled</structfield></entry>
2024-
<entry><type>char</type></entry>
2027+
<entry><structfield>collencoding</structfield></entry>
2028+
<entry><type>int4</type></entry>
20252029
<entry></entry>
2026-
<entry>
2027-
Controls in which <xref linkend="guc-session-replication-role"> modes
2028-
the event trigger fires.
2029-
<literal>O</> = trigger fires in <quote>origin</> and <quote>local</> modes,
2030-
<literal>D</> = trigger is disabled,
2031-
<literal>R</> = trigger fires in <quote>replica</> mode,
2032-
<literal>A</> = trigger fires always.
2033-
</entry>
2030+
<entry>Encoding in which the collation is applicable, or -1 if it
2031+
works for any encoding</entry>
20342032
</row>
20352033

20362034
<row>
2037-
<entry><structfield>evttags</structfield></entry>
2038-
<entry><type>text[]</type></entry>
2035+
<entry><structfield>collcollate</structfield></entry>
2036+
<entry><type>name</type></entry>
20392037
<entry></entry>
2040-
<entry>
2041-
Command tags for which this trigger will fire. If NULL, the firing
2042-
of this trigger is not restricted on the basis of the command tag.
2043-
</entry>
2038+
<entry><symbol>LC_COLLATE</> for this collation object</entry>
2039+
</row>
2040+
2041+
<row>
2042+
<entry><structfield>collctype</structfield></entry>
2043+
<entry><type>name</type></entry>
2044+
<entry></entry>
2045+
<entry><symbol>LC_CTYPE</> for this collation object</entry>
20442046
</row>
20452047
</tbody>
20462048
</tgroup>
20472049
</table>
2050+
2051+
<para>
2052+
Note that the unique key on this catalog is (<structfield>collname</>,
2053+
<structfield>collencoding</>, <structfield>collnamespace</>) not just
2054+
(<structfield>collname</>, <structfield>collnamespace</>).
2055+
<productname>PostgreSQL</productname> generally ignores all
2056+
collations that do not have <structfield>collencoding</> equal to
2057+
either the current database's encoding or -1, and creation of new entries
2058+
with the same name as an entry with <structfield>collencoding</> = -1
2059+
is forbidden. Therefore it is sufficient to use a qualified SQL name
2060+
(<replaceable>schema</>.<replaceable>name</>) to identify a collation,
2061+
even though this is not unique according to the catalog definition.
2062+
The reason for defining the catalog this way is that
2063+
<application>initdb</> fills it in at cluster initialization time with
2064+
entries for all locales available on the system, so it must be able to
2065+
hold entries for all encodings that might ever be used in the cluster.
2066+
</para>
2067+
2068+
<para>
2069+
In the <literal>template0</> database, it could be useful to create
2070+
collations whose encoding does not match the database encoding,
2071+
since they could match the encodings of databases later cloned from
2072+
<literal>template0</>. This would currently have to be done manually.
2073+
</para>
20482074
</sect1>
20492075

20502076
<sect1 id="catalog-pg-constraint">
@@ -2328,116 +2354,8 @@
23282354
relation.
23292355
</para>
23302356
</note>
2331-
23322357
</sect1>
23332358

2334-
<sect1 id="catalog-pg-collation">
2335-
<title><structname>pg_collation</structname></title>
2336-
2337-
<indexterm zone="catalog-pg-collation">
2338-
<primary>pg_collation</primary>
2339-
</indexterm>
2340-
2341-
<para>
2342-
The catalog <structname>pg_collation</structname> describes the
2343-
available collations, which are essentially mappings from an SQL
2344-
name to operating system locale categories.
2345-
See <xref linkend="collation"> for more information.
2346-
</para>
2347-
2348-
<table>
2349-
<title><structname>pg_collation</> Columns</title>
2350-
2351-
<tgroup cols="4">
2352-
<thead>
2353-
<row>
2354-
<entry>Name</entry>
2355-
<entry>Type</entry>
2356-
<entry>References</entry>
2357-
<entry>Description</entry>
2358-
</row>
2359-
</thead>
2360-
2361-
<tbody>
2362-
<row>
2363-
<entry><structfield>oid</structfield></entry>
2364-
<entry><type>oid</type></entry>
2365-
<entry></entry>
2366-
<entry>Row identifier (hidden attribute; must be explicitly selected)</entry>
2367-
</row>
2368-
2369-
<row>
2370-
<entry><structfield>collname</structfield></entry>
2371-
<entry><type>name</type></entry>
2372-
<entry></entry>
2373-
<entry>Collation name (unique per namespace and encoding)</entry>
2374-
</row>
2375-
2376-
<row>
2377-
<entry><structfield>collnamespace</structfield></entry>
2378-
<entry><type>oid</type></entry>
2379-
<entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry>
2380-
<entry>
2381-
The OID of the namespace that contains this collation
2382-
</entry>
2383-
</row>
2384-
2385-
<row>
2386-
<entry><structfield>collowner</structfield></entry>
2387-
<entry><type>oid</type></entry>
2388-
<entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry>
2389-
<entry>Owner of the collation</entry>
2390-
</row>
2391-
2392-
<row>
2393-
<entry><structfield>collencoding</structfield></entry>
2394-
<entry><type>int4</type></entry>
2395-
<entry></entry>
2396-
<entry>Encoding in which the collation is applicable, or -1 if it
2397-
works for any encoding</entry>
2398-
</row>
2399-
2400-
<row>
2401-
<entry><structfield>collcollate</structfield></entry>
2402-
<entry><type>name</type></entry>
2403-
<entry></entry>
2404-
<entry><symbol>LC_COLLATE</> for this collation object</entry>
2405-
</row>
2406-
2407-
<row>
2408-
<entry><structfield>collctype</structfield></entry>
2409-
<entry><type>name</type></entry>
2410-
<entry></entry>
2411-
<entry><symbol>LC_CTYPE</> for this collation object</entry>
2412-
</row>
2413-
</tbody>
2414-
</tgroup>
2415-
</table>
2416-
2417-
<para>
2418-
Note that the unique key on this catalog is (<structfield>collname</>,
2419-
<structfield>collencoding</>, <structfield>collnamespace</>) not just
2420-
(<structfield>collname</>, <structfield>collnamespace</>).
2421-
<productname>PostgreSQL</productname> generally ignores all
2422-
collations that do not have <structfield>collencoding</> equal to
2423-
either the current database's encoding or -1, and creation of new entries
2424-
with the same name as an entry with <structfield>collencoding</> = -1
2425-
is forbidden. Therefore it is sufficient to use a qualified SQL name
2426-
(<replaceable>schema</>.<replaceable>name</>) to identify a collation,
2427-
even though this is not unique according to the catalog definition.
2428-
The reason for defining the catalog this way is that
2429-
<application>initdb</> fills it in at cluster initialization time with
2430-
entries for all locales available on the system, so it must be able to
2431-
hold entries for all encodings that might ever be used in the cluster.
2432-
</para>
2433-
2434-
<para>
2435-
In the <literal>template0</> database, it could be useful to create
2436-
collations whose encoding does not match the database encoding,
2437-
since they could match the encodings of databases later cloned from
2438-
<literal>template0</>. This would currently have to be done manually.
2439-
</para>
2440-
</sect1>
24412359

24422360
<sect1 id="catalog-pg-conversion">
24432361
<title><structname>pg_conversion</structname></title>
@@ -3210,6 +3128,89 @@
32103128
</sect1>
32113129

32123130

3131+
<sect1 id="catalog-pg-event-trigger">
3132+
<title><structname>pg_event_trigger</structname></title>
3133+
3134+
<indexterm zone="catalog-pg-event-trigger">
3135+
<primary>pg_event_trigger</primary>
3136+
</indexterm>
3137+
3138+
<para>
3139+
The catalog <structname>pg_event_trigger</structname> stores event triggers.
3140+
See <xref linkend="event-triggers"> for more information.
3141+
</para>
3142+
3143+
<table>
3144+
<title><structname>pg_event_trigger</> Columns</title>
3145+
3146+
<tgroup cols="4">
3147+
<thead>
3148+
<row>
3149+
<entry>Name</entry>
3150+
<entry>Type</entry>
3151+
<entry>References</entry>
3152+
<entry>Description</entry>
3153+
</row>
3154+
</thead>
3155+
3156+
<tbody>
3157+
<row>
3158+
<entry><structfield>evtname</structfield></entry>
3159+
<entry><type>name</type></entry>
3160+
<entry></entry>
3161+
<entry>Trigger name (must be unique)</entry>
3162+
</row>
3163+
3164+
<row>
3165+
<entry><structfield>evtevent</structfield></entry>
3166+
<entry><type>name</type></entry>
3167+
<entry></entry>
3168+
<entry>Identifies the event for which this trigger fires</entry>
3169+
</row>
3170+
3171+
<row>
3172+
<entry><structfield>evtowner</structfield></entry>
3173+
<entry><type>oid</type></entry>
3174+
<entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry>
3175+
<entry>Owner of the event trigger</entry>
3176+
</row>
3177+
3178+
<row>
3179+
<entry><structfield>evtfoid</structfield></entry>
3180+
<entry><type>oid</type></entry>
3181+
<entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry>
3182+
<entry>The function to be called</entry>
3183+
</row>
3184+
3185+
<row>
3186+
<entry><structfield>evtenabled</structfield></entry>
3187+
<entry><type>char</type></entry>
3188+
<entry></entry>
3189+
<entry>
3190+
Controls in which <xref linkend="guc-session-replication-role"> modes
3191+
the event trigger fires.
3192+
<literal>O</> = trigger fires in <quote>origin</> and <quote>local</> modes,
3193+
<literal>D</> = trigger is disabled,
3194+
<literal>R</> = trigger fires in <quote>replica</> mode,
3195+
<literal>A</> = trigger fires always.
3196+
</entry>
3197+
</row>
3198+
3199+
<row>
3200+
<entry><structfield>evttags</structfield></entry>
3201+
<entry><type>text[]</type></entry>
3202+
<entry></entry>
3203+
<entry>
3204+
Command tags for which this trigger will fire. If NULL, the firing
3205+
of this trigger is not restricted on the basis of the command tag.
3206+
</entry>
3207+
</row>
3208+
</tbody>
3209+
</tgroup>
3210+
</table>
3211+
</sect1>
3212+
3213+
32133214
<sect1 id="catalog-pg-extension">
32143215
<title><structname>pg_extension</structname></title>
32153216

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp