|
1 | 1 | <!-- |
2 | 2 | Documentation of the system catalogs, directed toward PostgreSQL developers |
3 | | - $Header: /cvsroot/pgsql/doc/src/sgml/catalogs.sgml,v 2.62 2002/09/24 21:26:44 tgl Exp $ |
| 3 | + $Header: /cvsroot/pgsql/doc/src/sgml/catalogs.sgml,v 2.63 2002/10/14 04:29:23 momjian Exp $ |
4 | 4 | --> |
5 | 5 |
|
6 | 6 | <chapter id="catalogs"> |
|
23 | 23 | creates the database on disk.) There are some exceptions for |
24 | 24 | especially esoteric operations, such as adding index access methods. |
25 | 25 | </para> |
| 26 | + <para> |
| 27 | + Most system catalogs are copied from the template database during |
| 28 | + database creation, and are thereafter database-specific. A few |
| 29 | + catalogs are physically shared across all databases in an installation; |
| 30 | + these are marked in the descriptions of the individual catalogs. |
| 31 | + </para> |
26 | 32 |
|
27 | 33 | <table> |
28 | 34 | <title>System Catalogs</title> |
|
37 | 43 |
|
38 | 44 | <tbody> |
39 | 45 | <row> |
40 | | - <entry>pg_aggregate</entry> |
| 46 | + <entry><link linkend="catalog-pg-aggregate"> |
| 47 | + <database class="table">pg_aggregate</database></link></entry> |
41 | 48 | <entry>aggregate functions</entry> |
42 | 49 | </row> |
43 | 50 |
|
|
57 | 64 | </row> |
58 | 65 |
|
59 | 66 | <row> |
60 | | - <entry>pg_attrdef</entry> |
| 67 | + <entry><link linkend="catalog-pg-attrdef"> |
| 68 | + <database class="table">pg_attrdef</database></link></entry> |
61 | 69 | <entry>column default values</entry> |
62 | 70 | </row> |
63 | 71 |
|
64 | 72 | <row> |
65 | | - <entry>pg_attribute</entry> |
| 73 | + <entry><link linkend="catalog-pg-attribute"> |
| 74 | + <database class="table">pg_attribute</database></link></entry> |
66 | 75 | <entry>table columns (<quote>attributes</quote>, <quote>fields</quote>)</entry> |
67 | 76 | </row> |
68 | 77 |
|
69 | 78 | <row> |
70 | | - <entry>pg_cast</entry> |
| 79 | + <entry><link linkend="catalog-pg-cast"> |
| 80 | + <database class="table">pg_cast</database></link></entry> |
71 | 81 | <entry>casts (data type conversions)</entry> |
72 | 82 | </row> |
73 | 83 |
|
74 | 84 | <row> |
75 | | - <entry>pg_class</entry> |
| 85 | + <entry><link linkend="catalog-pg-class"> |
| 86 | + <database class="table">pg_class</database></link></entry> |
76 | 87 | <entry>tables, indexes, sequences (<quote>relations</quote>)</entry> |
77 | 88 | </row> |
78 | 89 |
|
79 | 90 | <row> |
80 | | - <entry>pg_constraint</entry> |
| 91 | + <entry><link linkend="catalog-pg-constraint"> |
| 92 | + <database class="table">pg_constraint</database></link></entry> |
81 | 93 | <entry>check constraints, unique / primary key constraints, foreign key constraints</entry> |
82 | 94 | </row> |
83 | 95 |
|
84 | 96 | <row> |
85 | | - <entry>pg_conversion</entry> |
| 97 | + <entry><link linkend="catalog-pg-conversion"> |
| 98 | + <database class="table">pg_conversion</database></link></entry> |
86 | 99 | <entry>encoding conversion information</entry> |
87 | 100 | </row> |
88 | 101 |
|
89 | 102 | <row> |
90 | | - <entry>pg_database</entry> |
| 103 | + <entry><link linkend="catalog-pg-database"> |
| 104 | + <database class="table">pg_database</database></link></entry> |
91 | 105 | <entry>databases within this database cluster</entry> |
92 | 106 | </row> |
93 | 107 |
|
94 | 108 | <row> |
95 | | - <entry>pg_depend</entry> |
| 109 | + <entry><link linkend="catalog-pg-depend"> |
| 110 | + <database class="table">pg_depend</database></link></entry> |
96 | 111 | <entry>dependencies between database objects</entry> |
97 | 112 | </row> |
98 | 113 |
|
99 | 114 | <row> |
100 | | - <entry>pg_description</entry> |
| 115 | + <entry><link linkend="catalog-pg-description"> |
| 116 | + <database class="table">pg_description</database></link></entry> |
101 | 117 | <entry>descriptions or comments on database objects</entry> |
102 | 118 | </row> |
103 | 119 |
|
104 | 120 | <row> |
105 | | - <entry>pg_group</entry> |
| 121 | + <entry><link linkend="catalog-pg-group"> |
| 122 | + <database class="table">pg_group</database></link></entry> |
106 | 123 | <entry>groups of database users</entry> |
107 | 124 | </row> |
108 | 125 |
|
109 | 126 | <row> |
110 | | - <entry>pg_index</entry> |
| 127 | + <entry><link linkend="catalog-pg-index"> |
| 128 | + <database class="table">pg_index</database></link></entry> |
111 | 129 | <entry>additional index information</entry> |
112 | 130 | </row> |
113 | 131 |
|
114 | 132 | <row> |
115 | | - <entry>pg_inherits</entry> |
| 133 | + <entry><link linkend="catalog-pg-inherits"> |
| 134 | + <database class="table">pg_inherits</database></link></entry> |
116 | 135 | <entry>table inheritance hierarchy</entry> |
117 | 136 | </row> |
118 | 137 |
|
119 | 138 | <row> |
120 | | - <entry>pg_language</entry> |
| 139 | + <entry><link linkend="catalog-pg-language"> |
| 140 | + <database class="table">pg_language</database></link></entry> |
121 | 141 | <entry>languages for writing functions</entry> |
122 | 142 | </row> |
123 | 143 |
|
124 | 144 | <row> |
125 | | - <entry>pg_largeobject</entry> |
| 145 | + <entry><link linkend="catalog-pg-largeobject"> |
| 146 | + <database class="table">pg_largeobject</database></link></entry> |
126 | 147 | <entry>large objects</entry> |
127 | 148 | </row> |
128 | 149 |
|
129 | 150 | <row> |
130 | | - <entry>pg_listener</entry> |
| 151 | + <entry><link linkend="catalog-pg-listener"> |
| 152 | + <database class="table">pg_listener</database></link></entry> |
131 | 153 | <entry>asynchronous notification</entry> |
132 | 154 | </row> |
133 | 155 |
|
134 | 156 | <row> |
135 | | - <entry>pg_namespace</entry> |
| 157 | + <entry><link linkend="catalog-pg-namespace"> |
| 158 | + <database class="table">pg_namespace</database></link></entry> |
136 | 159 | <entry>namespaces (schemas)</entry> |
137 | 160 | </row> |
138 | 161 |
|
139 | 162 | <row> |
140 | | - <entry>pg_opclass</entry> |
| 163 | + <entry><link linkend="catalog-pg-opclass"> |
| 164 | + <database class="table">pg_opclass</database></link></entry> |
141 | 165 | <entry>index access method operator classes</entry> |
142 | 166 | </row> |
143 | 167 |
|
144 | 168 | <row> |
145 | | - <entry>pg_operator</entry> |
| 169 | + <entry><link linkend="catalog-pg-operator"> |
| 170 | + <database class="table">pg_operator</database></link></entry> |
146 | 171 | <entry>operators</entry> |
147 | 172 | </row> |
148 | 173 |
|
149 | 174 | <row> |
150 | | - <entry>pg_proc</entry> |
| 175 | + <entry><link linkend="catalog-pg-proc"> |
| 176 | + <database class="table">pg_proc</database></link></entry> |
151 | 177 | <entry>functions and procedures</entry> |
152 | 178 | </row> |
153 | 179 |
|
154 | 180 | <row> |
155 | | - <entry>pg_rewrite</entry> |
| 181 | + <entry><link linkend="catalog-pg-rewrite"> |
| 182 | + <database class="table">pg_rewrite</database></link></entry> |
156 | 183 | <entry>query rewriter rules</entry> |
157 | 184 | </row> |
158 | 185 |
|
159 | 186 | <row> |
160 | | - <entry>pg_shadow</entry> |
| 187 | + <entry><link linkend="catalog-pg-shadow"> |
| 188 | + <database class="table">pg_shadow</database></link></entry> |
161 | 189 | <entry>database users</entry> |
162 | 190 | </row> |
163 | 191 |
|
164 | 192 | <row> |
165 | | - <entry>pg_statistic</entry> |
| 193 | + <entry><link linkend="catalog-pg-statistic"> |
| 194 | + <database class="table">pg_statistic</database></link></entry> |
166 | 195 | <entry>optimizer statistics</entry> |
167 | 196 | </row> |
168 | 197 |
|
169 | 198 | <row> |
170 | | - <entry>pg_trigger</entry> |
| 199 | + <entry><link linkend="catalog-pg-trigger"> |
| 200 | + <database class="table">pg_trigger</database></link></entry> |
171 | 201 | <entry>triggers</entry> |
172 | 202 | </row> |
173 | 203 |
|
174 | 204 | <row> |
175 | | - <entry>pg_type</entry> |
| 205 | + <entry><link linkend="catalog-pg-type"> |
| 206 | + <database class="table">pg_type</database></link></entry> |
176 | 207 | <entry>data types</entry> |
177 | 208 | </row> |
178 | 209 | </tbody> |
|