diff options
| -rw-r--r-- | doc/src/sgml/catalogs.sgml | 9810 | ||||
| -rw-r--r-- | doc/src/sgml/information_schema.sgml | 6541 | ||||
| -rw-r--r-- | doc/src/sgml/monitoring.sgml | 4313 | ||||
| -rw-r--r-- | doc/src/sgml/pgbuffercache.sgml | 111 | ||||
| -rw-r--r-- | doc/src/sgml/pgstatstatements.sgml | 351 | ||||
| -rw-r--r-- | doc/src/sgml/stylesheet-fo.xsl | 10 | ||||
| -rw-r--r-- | doc/src/sgml/stylesheet.css | 34 |
7 files changed, 12748 insertions, 8422 deletions
diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index fcadba331db..f4653b190c5 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -388,178 +388,250 @@ <table> <title><structname>pg_aggregate</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>aggfnoid</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry><structname>pg_proc</structname> OID of the aggregate function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggfnoid</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + <structname>pg_proc</structname> OID of the aggregate function + </para></entry> </row> + <row> - <entry><structfield>aggkind</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Aggregate kind: + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggkind</structfield> <type>char</type> + </para> + <para> + Aggregate kind: <literal>n</literal> for <quote>normal</quote> aggregates, <literal>o</literal> for <quote>ordered-set</quote> aggregates, or <literal>h</literal> for <quote>hypothetical-set</quote> aggregates - </entry> + </para></entry> </row> + <row> - <entry><structfield>aggnumdirectargs</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Number of direct (non-aggregated) arguments of an ordered-set or + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggnumdirectargs</structfield> <type>int2</type> + </para> + <para> + Number of direct (non-aggregated) arguments of an ordered-set or hypothetical-set aggregate, counting a variadic array as one argument. If equal to <structfield>pronargs</structfield>, the aggregate must be variadic and the variadic array describes the aggregated arguments as well as the final direct arguments. - Always zero for normal aggregates.</entry> + Always zero for normal aggregates. + </para></entry> </row> + <row> - <entry><structfield>aggtransfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Transition function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggtransfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Transition function + </para></entry> </row> + <row> - <entry><structfield>aggfinalfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Final function (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggfinalfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Final function (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggcombinefn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Combine function (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggcombinefn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Combine function (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggserialfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Serialization function (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggserialfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Serialization function (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggdeserialfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Deserialization function (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggdeserialfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Deserialization function (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggmtransfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Forward transition function for moving-aggregate mode (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggmtransfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Forward transition function for moving-aggregate mode (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggminvtransfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Inverse transition function for moving-aggregate mode (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggminvtransfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Inverse transition function for moving-aggregate mode (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggmfinalfn</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Final function for moving-aggregate mode (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggmfinalfn</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Final function for moving-aggregate mode (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggfinalextra</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True to pass extra dummy arguments to <structfield>aggfinalfn</structfield></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggfinalextra</structfield> <type>bool</type> + </para> + <para> + True to pass extra dummy arguments to <structfield>aggfinalfn</structfield> + </para></entry> </row> + <row> - <entry><structfield>aggmfinalextra</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True to pass extra dummy arguments to <structfield>aggmfinalfn</structfield></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggmfinalextra</structfield> <type>bool</type> + </para> + <para> + True to pass extra dummy arguments to <structfield>aggmfinalfn</structfield> + </para></entry> </row> + <row> - <entry><structfield>aggfinalmodify</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Whether <structfield>aggfinalfn</structfield> modifies the + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggfinalmodify</structfield> <type>char</type> + </para> + <para> + Whether <structfield>aggfinalfn</structfield> modifies the transition state value: <literal>r</literal> if it is read-only, <literal>s</literal> if the <structfield>aggtransfn</structfield> cannot be applied after the <structfield>aggfinalfn</structfield>, or <literal>w</literal> if it writes on the value - </entry> + </para></entry> </row> + <row> - <entry><structfield>aggmfinalmodify</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Like <structfield>aggfinalmodify</structfield>, but for + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggmfinalmodify</structfield> <type>char</type> + </para> + <para> + Like <structfield>aggfinalmodify</structfield>, but for the <structfield>aggmfinalfn</structfield> - </entry> + </para></entry> </row> + <row> - <entry><structfield>aggsortop</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>Associated sort operator (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggsortop</structfield> <type>oid</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Associated sort operator (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggtranstype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type of the aggregate function's internal transition (state) data</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggtranstype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type of the aggregate function's internal transition (state) data + </para></entry> </row> + <row> - <entry><structfield>aggtransspace</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Approximate average size (in bytes) of the transition state - data, or zero to use a default estimate</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggtransspace</structfield> <type>int4</type> + </para> + <para> + Approximate average size (in bytes) of the transition state + data, or zero to use a default estimate + </para></entry> </row> + <row> - <entry><structfield>aggmtranstype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type of the aggregate function's internal transition (state) - data for moving-aggregate mode (zero if none)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggmtranstype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type of the aggregate function's internal transition (state) + data for moving-aggregate mode (zero if none) + </para></entry> </row> + <row> - <entry><structfield>aggmtransspace</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Approximate average size (in bytes) of the transition state data - for moving-aggregate mode, or zero to use a default estimate</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggmtransspace</structfield> <type>int4</type> + </para> + <para> + Approximate average size (in bytes) of the transition state data + for moving-aggregate mode, or zero to use a default estimate + </para></entry> </row> + <row> - <entry><structfield>agginitval</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>agginitval</structfield> <type>text</type> + </para> + <para> The initial value of the transition state. This is a text field containing the initial value in its external string representation. If this field is null, the transition state value starts out null. - </entry> + </para></entry> </row> + <row> - <entry><structfield>aggminitval</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>aggminitval</structfield> <type>text</type> + </para> + <para> The initial value of the transition state for moving-aggregate mode. This is a text field containing the initial value in its external string representation. If this field is null, the transition state value starts out null. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -594,50 +666,56 @@ <table> <title><structname>pg_am</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> + <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>amname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the access method</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amname</structfield> <type>name</type> + </para> + <para> + Name of the access method + </para></entry> </row> <row> - <entry><structfield>amhandler</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amhandler</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> OID of a handler function that is responsible for supplying information about the access method - </entry> + </para></entry> </row> <row> - <entry><structfield>amtype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amtype</structfield> <type>char</type> + </para> + <para> <literal>t</literal> = table (including materialized views), <literal>i</literal> = index. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -678,83 +756,107 @@ <table> <title><structname>pg_amop</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> + <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>amopfamily</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.oid</literal></entry> - <entry>The operator family this entry is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amopfamily</structfield> <type>oid</type> + (references <link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The operator family this entry is for + </para></entry> </row> <row> - <entry><structfield>amoplefttype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Left-hand input data type of operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amoplefttype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Left-hand input data type of operator + </para></entry> </row> <row> - <entry><structfield>amoprighttype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Right-hand input data type of operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amoprighttype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Right-hand input data type of operator + </para></entry> </row> <row> - <entry><structfield>amopstrategy</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Operator strategy number</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amopstrategy</structfield> <type>int2</type> + </para> + <para> + Operator strategy number + </para></entry> </row> <row> - <entry><structfield>amoppurpose</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Operator purpose, either <literal>s</literal> for search or - <literal>o</literal> for ordering</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amoppurpose</structfield> <type>char</type> + </para> + <para> + Operator purpose, either <literal>s</literal> for search or + <literal>o</literal> for ordering + </para></entry> </row> <row> - <entry><structfield>amopopr</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>OID of the operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amopopr</structfield> <type>oid</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the operator + </para></entry> </row> <row> - <entry><structfield>amopmethod</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-am"><structname>pg_am</structname></link>.oid</literal></entry> - <entry>Index access method operator family is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amopmethod</structfield> <type>oid</type> + (references <link linkend="catalog-pg-am"><structname>pg_am</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Index access method operator family is for + </para></entry> </row> <row> - <entry><structfield>amopsortfamily</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.oid</literal></entry> - <entry>The B-tree operator family this entry sorts according to, if an - ordering operator; zero if a search operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amopsortfamily</structfield> <type>oid</type> + (references <link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The B-tree operator family this entry sorts according to, if an + ordering operator; zero if a search operator + </para></entry> </row> - </tbody> </tgroup> </table> @@ -821,60 +923,76 @@ <table> <title><structname>pg_amproc</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> + <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>amprocfamily</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.oid</literal></entry> - <entry>The operator family this entry is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amprocfamily</structfield> <type>oid</type> + (references <link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The operator family this entry is for + </para></entry> </row> <row> - <entry><structfield>amproclefttype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Left-hand input data type of associated operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amproclefttype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Left-hand input data type of associated operator + </para></entry> </row> <row> - <entry><structfield>amprocrighttype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Right-hand input data type of associated operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amprocrighttype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Right-hand input data type of associated operator + </para></entry> </row> <row> - <entry><structfield>amprocnum</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Support function number</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amprocnum</structfield> <type>int2</type> + </para> + <para> + Support function number + </para></entry> </row> <row> - <entry><structfield>amproc</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>amproc</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the function + </para></entry> </row> - </tbody> </tgroup> </table> @@ -911,46 +1029,57 @@ <table> <title><structname>pg_attrdef</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>adrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table this column belongs to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>adrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table this column belongs to + </para></entry> </row> <row> - <entry><structfield>adnum</structfield></entry> - <entry><type>int2</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry>The number of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>adnum</structfield> <type>int2</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> + The number of the column + </para></entry> </row> <row> - <entry><structfield>adbin</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry>The column default value, in <function>nodeToString()</function> - representation. Use <literal>pg_get_expr(adbin, adrelid)</literal> to - convert it to an SQL expression.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>adbin</structfield> <type>pg_node_tree</type> + </para> + <para> + The column default value, in <function>nodeToString()</function> + representation. Use <literal>pg_get_expr(adbin, adrelid)</literal> to + convert it to an SQL expression. + </para></entry> </row> </tbody> </tgroup> @@ -981,44 +1110,53 @@ <table> <title><structname>pg_attribute</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>attrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table this column belongs to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table this column belongs to + </para></entry> </row> <row> - <entry><structfield>attname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>The column name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attname</structfield> <type>name</type> + </para> + <para> + The column name + </para></entry> </row> <row> - <entry><structfield>atttypid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>The data type of this column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>atttypid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The data type of this column + </para></entry> </row> <row> - <entry><structfield>attstattarget</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attstattarget</structfield> <type>int4</type> + </para> + <para> <structfield>attstattarget</structfield> controls the level of detail of statistics accumulated for this column by <xref linkend="sql-analyze"/>. @@ -1028,234 +1166,234 @@ For scalar data types, <structfield>attstattarget</structfield> is both the target number of <quote>most common values</quote> to collect, and the target number of histogram bins to create. - </entry> + </para></entry> </row> <row> - <entry><structfield>attlen</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attlen</structfield> <type>int2</type> + </para> + <para> A copy of <literal>pg_type.typlen</literal> of this column's type - </entry> + </para></entry> </row> <row> - <entry><structfield>attnum</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attnum</structfield> <type>int2</type> + </para> + <para> The number of the column. Ordinary columns are numbered from 1 up. System columns, such as <structfield>ctid</structfield>, have (arbitrary) negative numbers. - </entry> + </para></entry> </row> <row> - <entry><structfield>attndims</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attndims</structfield> <type>int4</type> + </para> + <para> Number of dimensions, if the column is an array type; otherwise 0. (Presently, the number of dimensions of an array is not enforced, so any nonzero value effectively means <quote>it's an array</quote>.) - </entry> + </para></entry> </row> <row> - <entry><structfield>attcacheoff</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attcacheoff</structfield> <type>int4</type> + </para> + <para> Always -1 in storage, but when loaded into a row descriptor in memory this might be updated to cache the offset of the attribute within the row - </entry> + </para></entry> </row> <row> - <entry><structfield>atttypmod</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>atttypmod</structfield> <type>int4</type> + </para> + <para> <structfield>atttypmod</structfield> records type-specific data supplied at table creation time (for example, the maximum length of a <type>varchar</type> column). It is passed to type-specific input functions and length coercion functions. The value will generally be -1 for types that do not need <structfield>atttypmod</structfield>. - </entry> + </para></entry> </row> <row> - <entry><structfield>attbyval</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attbyval</structfield> <type>bool</type> + </para> + <para> A copy of <literal>pg_type.typbyval</literal> of this column's type - </entry> + </para></entry> </row> <row> - <entry><structfield>attstorage</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attstorage</structfield> <type>char</type> + </para> + <para> Normally a copy of <literal>pg_type.typstorage</literal> of this column's type. For TOAST-able data types, this can be altered after column creation to control storage policy. - </entry> + </para></entry> </row> <row> - <entry><structfield>attalign</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attalign</structfield> <type>char</type> + </para> + <para> A copy of <literal>pg_type.typalign</literal> of this column's type - </entry> + </para></entry> </row> <row> - <entry><structfield>attnotnull</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attnotnull</structfield> <type>bool</type> + </para> + <para> This represents a not-null constraint. - </entry> + </para></entry> </row> <row> - <entry><structfield>atthasdef</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>atthasdef</structfield> <type>bool</type> + </para> + <para> This column has a default expression or generation expression, in which case there will be a corresponding entry in the <structname>pg_attrdef</structname> catalog that actually defines the expression. (Check <structfield>attgenerated</structfield> to determine whether this is a default or a generation expression.) - </entry> + </para></entry> </row> <row> - <entry><structfield>atthasmissing</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>atthasmissing</structfield> <type>bool</type> + </para> + <para> This column has a value which is used where the column is entirely missing from the row, as happens when a column is added with a non-volatile <literal>DEFAULT</literal> value after the row is created. The actual value used is stored in the <structfield>attmissingval</structfield> column. - </entry> + </para></entry> </row> <row> - <entry><structfield>attidentity</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attidentity</structfield> <type>char</type> + </para> + <para> If a zero byte (<literal>''</literal>), then not an identity column. Otherwise, <literal>a</literal> = generated always, <literal>d</literal> = generated by default. - </entry> + </para></entry> </row> <row> - <entry><structfield>attgenerated</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attgenerated</structfield> <type>char</type> + </para> + <para> If a zero byte (<literal>''</literal>), then not a generated column. Otherwise, <literal>s</literal> = stored. (Other values might be added in the future.) - </entry> + </para></entry> </row> <row> - <entry><structfield>attisdropped</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attisdropped</structfield> <type>bool</type> + </para> + <para> This column has been dropped and is no longer valid. A dropped column is still physically present in the table, but is ignored by the parser and so cannot be accessed via SQL. - </entry> + </para></entry> </row> <row> - <entry><structfield>attislocal</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attislocal</structfield> <type>bool</type> + </para> + <para> This column is defined locally in the relation. Note that a column can be locally defined and inherited simultaneously. - </entry> + </para></entry> </row> <row> - <entry><structfield>attinhcount</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attinhcount</structfield> <type>int4</type> + </para> + <para> The number of direct ancestors this column has. A column with a nonzero number of ancestors cannot be dropped nor renamed. - </entry> + </para></entry> </row> <row> - <entry><structfield>attcollation</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attcollation</structfield> <type>oid</type> + (references <link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.<structfield>oid</structfield>) + </para> + <para> The defined collation of the column, or zero if the column is not of a collatable data type. - </entry> + </para></entry> </row> <row> - <entry><structfield>attacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attacl</structfield> <type>aclitem[]</type> + </para> + <para> Column-level access privileges, if any have been granted specifically on this column - </entry> + </para></entry> </row> <row> - <entry><structfield>attoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attoptions</structfield> <type>text[]</type> + </para> + <para> Attribute-level options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> <row> - <entry><structfield>attfdwoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attfdwoptions</structfield> <type>text[]</type> + </para> + <para> Attribute-level foreign data wrapper options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> <row> - <entry><structfield>attmissingval</structfield></entry> - <entry><type>anyarray</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attmissingval</structfield> <type>anyarray</type> + </para> + <para> This column has a one element array containing the value used when the column is entirely missing from the row, as happens when the column is added with a non-volatile <literal>DEFAULT</literal> value after the row is created. The value is only used when <structfield>atthasmissing</structfield> is true. If there is no value the column is null. - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -1311,105 +1449,132 @@ <table> <title><structname>pg_authid</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> - <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>rolname</structfield></entry> - <entry><type>name</type></entry> - <entry>Role name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolname</structfield> <type>name</type> + </para> + <para> + Role name + </para></entry> </row> <row> - <entry><structfield>rolsuper</structfield></entry> - <entry><type>bool</type></entry> - <entry>Role has superuser privileges</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolsuper</structfield> <type>bool</type> + </para> + <para> + Role has superuser privileges + </para></entry> </row> <row> - <entry><structfield>rolinherit</structfield></entry> - <entry><type>bool</type></entry> - <entry>Role automatically inherits privileges of roles it is a - member of</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolinherit</structfield> <type>bool</type> + </para> + <para> + Role automatically inherits privileges of roles it is a + member of + </para></entry> </row> <row> - <entry><structfield>rolcreaterole</structfield></entry> - <entry><type>bool</type></entry> - <entry>Role can create more roles</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolcreaterole</structfield> <type>bool</type> + </para> + <para> + Role can create more roles + </para></entry> </row> <row> - <entry><structfield>rolcreatedb</structfield></entry> - <entry><type>bool</type></entry> - <entry>Role can create databases</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolcreatedb</structfield> <type>bool</type> + </para> + <para> + Role can create databases + </para></entry> </row> <row> - <entry><structfield>rolcanlogin</structfield></entry> - <entry><type>bool</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolcanlogin</structfield> <type>bool</type> + </para> + <para> Role can log in. That is, this role can be given as the initial session authorization identifier - </entry> + </para></entry> </row> <row> - <entry><structfield>rolreplication</structfield></entry> - <entry><type>bool</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolreplication</structfield> <type>bool</type> + </para> + <para> Role is a replication role. A replication role can initiate replication connections and create and drop replication slots. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolbypassrls</structfield></entry> - <entry><type>bool</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolbypassrls</structfield> <type>bool</type> + </para> + <para> Role bypasses every row level security policy, see <xref linkend="ddl-rowsecurity"/> for more information. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolconnlimit</structfield></entry> - <entry><type>int4</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolconnlimit</structfield> <type>int4</type> + </para> + <para> For roles that can log in, this sets maximum number of concurrent connections this role can make. -1 means no limit. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolpassword</structfield></entry> - <entry><type>text</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolpassword</structfield> <type>text</type> + </para> + <para> Password (possibly encrypted); null if none. The format depends on the form of encryption used. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolvaliduntil</structfield></entry> - <entry><type>timestamptz</type></entry> - <entry>Password expiry time (only used for password authentication); - null if no expiration</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolvaliduntil</structfield> <type>timestamptz</type> + </para> + <para> + Password expiry time (only used for password authentication); + null if no expiration + </para></entry> </row> </tbody> </tgroup> @@ -1463,45 +1628,57 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_auth_members</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>roleid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>ID of a role that has a member</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>roleid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + ID of a role that has a member + </para></entry> </row> <row> - <entry><structfield>member</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>ID of a role that is a member of <structfield>roleid</structfield></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>member</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + ID of a role that is a member of <structfield>roleid</structfield> + </para></entry> </row> <row> - <entry><structfield>grantor</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>ID of the role that granted this membership</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + ID of the role that granted this membership + </para></entry> </row> <row> - <entry><structfield>admin_option</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if <structfield>member</structfield> can grant membership in - <structfield>roleid</structfield> to others</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>admin_option</structfield> <type>bool</type> + </para> + <para> + True if <structfield>member</structfield> can grant membership in + <structfield>roleid</structfield> to others + </para></entry> </row> </tbody> </tgroup> @@ -1536,54 +1713,64 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_cast</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>castsource</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>OID of the source data type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>castsource</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the source data type + </para></entry> </row> <row> - <entry><structfield>casttarget</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>OID of the target data type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>casttarget</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the target data type + </para></entry> </row> <row> - <entry><structfield>castfunc</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>castfunc</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the function to use to perform this cast. Zero is stored if the cast method doesn't require a function. - </entry> + </para></entry> </row> <row> - <entry><structfield>castcontext</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>castcontext</structfield> <type>char</type> + </para> + <para> Indicates what contexts the cast can be invoked in. <literal>e</literal> means only as an explicit cast (using <literal>CAST</literal> or <literal>::</literal> syntax). @@ -1591,18 +1778,19 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l to a target column, as well as explicitly. <literal>i</literal> means implicitly in expressions, as well as the other cases. - </entry> + </para></entry> </row> + <row> - <entry><structfield>castmethod</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>castmethod</structfield> <type>char</type> + </para> + <para> Indicates how the cast is performed. <literal>f</literal> means that the function specified in the <structfield>castfunc</structfield> field is used. <literal>i</literal> means that the input/output functions are used. <literal>b</literal> means that the types are binary-coercible, thus no conversion is required. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -1659,182 +1847,198 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_class</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>relname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the table, index, view, etc.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relname</structfield> <type>name</type> + </para> + <para> + Name of the table, index, view, etc. + </para></entry> </row> <row> - <entry><structfield>relnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this relation - </entry> + </para></entry> </row> <row> - <entry><structfield>reltype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reltype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the data type that corresponds to this table's row type, if any (zero for indexes, which have no <structname>pg_type</structname> entry) - </entry> + </para></entry> </row> <row> - <entry><structfield>reloftype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reloftype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> For typed tables, the OID of the underlying composite type, zero for all other relations - </entry> + </para></entry> </row> <row> - <entry><structfield>relowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the relation + </para></entry> </row> <row> - <entry><structfield>relam</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-am"><structname>pg_am</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relam</structfield> <type>oid</type> + (references <link linkend="catalog-pg-am"><structname>pg_am</structname></link>.<structfield>oid</structfield>) + </para> + <para> If this is a table or an index, the access method used (heap, B-tree, hash, etc.) - </entry> + </para></entry> </row> <row> - <entry><structfield>relfilenode</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Name of the on-disk file of this relation; zero means this + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relfilenode</structfield> <type>oid</type> + </para> + <para> + Name of the on-disk file of this relation; zero means this is a <quote>mapped</quote> relation whose disk file name is determined - by low-level state</entry> + by low-level state + </para></entry> </row> <row> - <entry><structfield>reltablespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reltablespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The tablespace in which this relation is stored. If zero, the database's default tablespace is implied. (Not meaningful if the relation has no on-disk file.) - </entry> + </para></entry> </row> <row> - <entry><structfield>relpages</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relpages</structfield> <type>int4</type> + </para> + <para> Size of the on-disk representation of this table in pages (of size <symbol>BLCKSZ</symbol>). This is only an estimate used by the planner. It is updated by <command>VACUUM</command>, <command>ANALYZE</command>, and a few DDL commands such as <command>CREATE INDEX</command>. - </entry> + </para></entry> </row> <row> - <entry><structfield>reltuples</structfield></entry> - <entry><type>float4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reltuples</structfield> <type>float4</type> + </para> + <para> Number of live rows in the table. This is only an estimate used by the planner. It is updated by <command>VACUUM</command>, <command>ANALYZE</command>, and a few DDL commands such as <command>CREATE INDEX</command>. - </entry> + </para></entry> </row> <row> - <entry><structfield>relallvisible</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relallvisible</structfield> <type>int4</type> + </para> + <para> Number of pages that are marked all-visible in the table's visibility map. This is only an estimate used by the planner. It is updated by <command>VACUUM</command>, <command>ANALYZE</command>, and a few DDL commands such as <command>CREATE INDEX</command>. - </entry> + </para></entry> </row> <row> - <entry><structfield>reltoastrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reltoastrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> OID of the TOAST table associated with this table, 0 if none. The TOAST table stores large attributes <quote>out of line</quote> in a secondary table. - </entry> + </para></entry> </row> <row> - <entry><structfield>relhasindex</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relhasindex</structfield> <type>bool</type> + </para> + <para> True if this is a table and it has (or recently had) any indexes - </entry> + </para></entry> </row> <row> - <entry><structfield>relisshared</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relisshared</structfield> <type>bool</type> + </para> + <para> True if this table is shared across all databases in the cluster. Only certain system catalogs (such as <structname>pg_database</structname>) are shared. - </entry> + </para></entry> </row> <row> - <entry><structfield>relpersistence</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relpersistence</structfield> <type>char</type> + </para> + <para> <literal>p</literal> = permanent table, <literal>u</literal> = unlogged table, <literal>t</literal> = temporary table - </entry> + </para></entry> </row> <row> - <entry><structfield>relkind</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relkind</structfield> <type>char</type> + </para> + <para> <literal>r</literal> = ordinary table, <literal>i</literal> = index, <literal>S</literal> = sequence, @@ -1845,172 +2049,177 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <literal>f</literal> = foreign table, <literal>p</literal> = partitioned table, <literal>I</literal> = partitioned index - </entry> + </para></entry> </row> <row> - <entry><structfield>relnatts</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relnatts</structfield> <type>int2</type> + </para> + <para> Number of user columns in the relation (system columns not counted). There must be this many corresponding entries in <structname>pg_attribute</structname>. See also <literal>pg_attribute.attnum</literal>. - </entry> + </para></entry> </row> <row> - <entry><structfield>relchecks</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relchecks</structfield> <type>int2</type> + </para> + <para> Number of <literal>CHECK</literal> constraints on the table; see <link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link> catalog - </entry> + </para></entry> </row> <row> - <entry><structfield>relhasrules</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relhasrules</structfield> <type>bool</type> + </para> + <para> True if table has (or once had) rules; see <link linkend="catalog-pg-rewrite"><structname>pg_rewrite</structname></link> catalog - </entry> + </para></entry> </row> <row> - <entry><structfield>relhastriggers</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relhastriggers</structfield> <type>bool</type> + </para> + <para> True if table has (or once had) triggers; see <link linkend="catalog-pg-trigger"><structname>pg_trigger</structname></link> catalog - </entry> + </para></entry> </row> <row> - <entry><structfield>relhassubclass</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relhassubclass</structfield> <type>bool</type> + </para> + <para> True if table or index has (or once had) any inheritance children - </entry> + </para></entry> </row> <row> - <entry><structfield>relrowsecurity</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relrowsecurity</structfield> <type>bool</type> + </para> + <para> True if table has row level security enabled; see <link linkend="catalog-pg-policy"><structname>pg_policy</structname></link> catalog - </entry> + </para></entry> </row> <row> - <entry><structfield>relforcerowsecurity</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relforcerowsecurity</structfield> <type>bool</type> + </para> + <para> True if row level security (when enabled) will also apply to table owner; see <link linkend="catalog-pg-policy"><structname>pg_policy</structname></link> catalog - </entry> + </para></entry> </row> <row> - <entry><structfield>relispopulated</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if relation is populated (this is true for all - relations other than some materialized views)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relispopulated</structfield> <type>bool</type> + </para> + <para> + True if relation is populated (this is true for all + relations other than some materialized views) + </para></entry> </row> <row> - <entry><structfield>relreplident</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relreplident</structfield> <type>char</type> + </para> + <para> Columns used to form <quote>replica identity</quote> for rows: <literal>d</literal> = default (primary key, if any), <literal>n</literal> = nothing, <literal>f</literal> = all columns <literal>i</literal> = index with <structfield>indisreplident</structfield> set, or default - </entry> + </para></entry> </row> <row> - <entry><structfield>relispartition</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if table or index is a partition</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relispartition</structfield> <type>bool</type> + </para> + <para> + True if table or index is a partition + </para></entry> </row> <row> - <entry><structfield>relrewrite</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relrewrite</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> For new relations being written during a DDL operation that requires a table rewrite, this contains the OID of the original relation; otherwise 0. That state is only visible internally; this field should never contain anything other than 0 for a user-visible relation. - </entry> + </para></entry> </row> <row> - <entry><structfield>relfrozenxid</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relfrozenxid</structfield> <type>xid</type> + </para> + <para> All transaction IDs before this one have been replaced with a permanent (<quote>frozen</quote>) transaction ID in this table. This is used to track whether the table needs to be vacuumed in order to prevent transaction ID wraparound or to allow <literal>pg_xact</literal> to be shrunk. Zero (<symbol>InvalidTransactionId</symbol>) if the relation is not a table. - </entry> + </para></entry> </row> <row> - <entry><structfield>relminmxid</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relminmxid</structfield> <type>xid</type> + </para> + <para> All multixact IDs before this one have been replaced by a transaction ID in this table. This is used to track whether the table needs to be vacuumed in order to prevent multixact ID wraparound or to allow <literal>pg_multixact</literal> to be shrunk. Zero (<symbol>InvalidMultiXactId</symbol>) if the relation is not a table. - </entry> + </para></entry> </row> <row> - <entry><structfield>relacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> <row> - <entry><structfield>reloptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reloptions</structfield> <type>text[]</type> + </para> + <para> Access-method-specific options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> <row> - <entry><structfield>relpartbound</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relpartbound</structfield> <type>pg_node_tree</type> + </para> + <para> If table is a partition (see <structfield>relispartition</structfield>), internal representation of the partition bound - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2044,94 +2253,113 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_collation</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>collname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Collation name (unique per namespace and encoding)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collname</structfield> <type>name</type> + </para> + <para> + Collation name (unique per namespace and encoding) + </para></entry> </row> <row> - <entry><structfield>collnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this collation - </entry> + </para></entry> </row> <row> - <entry><structfield>collowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the collation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the collation + </para></entry> </row> <row> - <entry><structfield>collprovider</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Provider of the collation: <literal>d</literal> = database - default, <literal>c</literal> = libc, <literal>i</literal> = icu</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collprovider</structfield> <type>char</type> + </para> + <para> + Provider of the collation: <literal>d</literal> = database + default, <literal>c</literal> = libc, <literal>i</literal> = icu + </para></entry> </row> <row> - <entry><structfield>collisdeterministic</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Is the collation deterministic?</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collisdeterministic</structfield> <type>bool</type> + </para> + <para> + Is the collation deterministic? + </para></entry> </row> <row> - <entry><structfield>collencoding</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Encoding in which the collation is applicable, or -1 if it - works for any encoding</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collencoding</structfield> <type>int4</type> + </para> + <para> + Encoding in which the collation is applicable, or -1 if it + works for any encoding + </para></entry> </row> <row> - <entry><structfield>collcollate</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry><symbol>LC_COLLATE</symbol> for this collation object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collcollate</structfield> <type>name</type> + </para> + <para> + <symbol>LC_COLLATE</symbol> for this collation object + </para></entry> </row> <row> - <entry><structfield>collctype</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry><symbol>LC_CTYPE</symbol> for this collation object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collctype</structfield> <type>name</type> + </para> + <para> + <symbol>LC_CTYPE</symbol> for this collation object + </para></entry> </row> <row> - <entry><structfield>collversion</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collversion</structfield> <type>text</type> + </para> + <para> Provider-specific version of the collation. This is recorded when the collation is created and then checked when it is used, to detect changes in the collation definition that could lead to data corruption. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2189,233 +2417,283 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_constraint</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>conname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Constraint name (not necessarily unique!)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conname</structfield> <type>name</type> + </para> + <para> + Constraint name (not necessarily unique!) + </para></entry> </row> <row> - <entry><structfield>connamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>connamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this constraint - </entry> + </para></entry> </row> <row> - <entry><structfield>contype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> - <literal>c</literal> = check constraint, - <literal>f</literal> = foreign key constraint, - <literal>p</literal> = primary key constraint, - <literal>u</literal> = unique constraint, - <literal>t</literal> = constraint trigger, - <literal>x</literal> = exclusion constraint - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>contype</structfield> <type>char</type> + </para> + <para> + <literal>c</literal> = check constraint, + <literal>f</literal> = foreign key constraint, + <literal>p</literal> = primary key constraint, + <literal>u</literal> = unique constraint, + <literal>t</literal> = constraint trigger, + <literal>x</literal> = exclusion constraint + </para></entry> </row> <row> - <entry><structfield>condeferrable</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Is the constraint deferrable?</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>condeferrable</structfield> <type>bool</type> + </para> + <para> + Is the constraint deferrable? + </para></entry> </row> <row> - <entry><structfield>condeferred</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Is the constraint deferred by default?</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>condeferred</structfield> <type>bool</type> + </para> + <para> + Is the constraint deferred by default? + </para></entry> </row> <row> - <entry><structfield>convalidated</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Has the constraint been validated? - Currently, can only be false for foreign keys and CHECK constraints</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>convalidated</structfield> <type>bool</type> + </para> + <para> + Has the constraint been validated? + Currently, can only be false for foreign keys and CHECK constraints + </para></entry> </row> <row> - <entry><structfield>conrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table this constraint is on; 0 if not a table constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table this constraint is on; 0 if not a table constraint + </para></entry> </row> <row> - <entry><structfield>contypid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>The domain this constraint is on; 0 if not a domain constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>contypid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The domain this constraint is on; 0 if not a domain constraint + </para></entry> </row> <row> - <entry><structfield>conindid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The index supporting this constraint, if it's a unique, primary - key, foreign key, or exclusion constraint; else 0</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conindid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The index supporting this constraint, if it's a unique, primary + key, foreign key, or exclusion constraint; else 0 + </para></entry> </row> <row> - <entry><structfield>conparentid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link>.oid</literal></entry> - <entry>The corresponding constraint in the parent partitioned table, - if this is a constraint in a partition; else 0</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conparentid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The corresponding constraint in the parent partitioned table, + if this is a constraint in a partition; else 0 + </para></entry> </row> <row> - <entry><structfield>confrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>If a foreign key, the referenced table; else 0</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + If a foreign key, the referenced table; else 0 + </para></entry> </row> <row> - <entry><structfield>confupdtype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Foreign key update action code: - <literal>a</literal> = no action, - <literal>r</literal> = restrict, - <literal>c</literal> = cascade, - <literal>n</literal> = set null, - <literal>d</literal> = set default - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confupdtype</structfield> <type>char</type> + </para> + <para> + Foreign key update action code: + <literal>a</literal> = no action, + <literal>r</literal> = restrict, + <literal>c</literal> = cascade, + <literal>n</literal> = set null, + <literal>d</literal> = set default + </para></entry> </row> <row> - <entry><structfield>confdeltype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Foreign key deletion action code: - <literal>a</literal> = no action, - <literal>r</literal> = restrict, - <literal>c</literal> = cascade, - <literal>n</literal> = set null, - <literal>d</literal> = set default - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confdeltype</structfield> <type>char</type> + </para> + <para> + Foreign key deletion action code: + <literal>a</literal> = no action, + <literal>r</literal> = restrict, + <literal>c</literal> = cascade, + <literal>n</literal> = set null, + <literal>d</literal> = set default + </para></entry> </row> <row> - <entry><structfield>confmatchtype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>Foreign key match type: - <literal>f</literal> = full, - <literal>p</literal> = partial, - <literal>s</literal> = simple - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confmatchtype</structfield> <type>char</type> + </para> + <para> + Foreign key match type: + <literal>f</literal> = full, + <literal>p</literal> = partial, + <literal>s</literal> = simple + </para></entry> </row> <row> - <entry><structfield>conislocal</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conislocal</structfield> <type>bool</type> + </para> + <para> This constraint is defined locally for the relation. Note that a constraint can be locally defined and inherited simultaneously. - </entry> + </para></entry> </row> <row> - <entry><structfield>coninhcount</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>coninhcount</structfield> <type>int4</type> + </para> + <para> The number of direct inheritance ancestors this constraint has. A constraint with a nonzero number of ancestors cannot be dropped nor renamed. - </entry> + </para></entry> </row> <row> - <entry><structfield>connoinherit</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>connoinherit</structfield> <type>bool</type> + </para> + <para> This constraint is defined locally for the relation. It is a non-inheritable constraint. - </entry> + </para></entry> </row> <row> - <entry><structfield>conkey</structfield></entry> - <entry><type>int2[]</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry>If a table constraint (including foreign keys, but not constraint - triggers), list of the constrained columns</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conkey</structfield> <type>int2[]</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> + If a table constraint (including foreign keys, but not constraint + triggers), list of the constrained columns + </para></entry> </row> <row> - <entry><structfield>confkey</structfield></entry> - <entry><type>int2[]</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry>If a foreign key, list of the referenced columns</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confkey</structfield> <type>int2[]</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> + If a foreign key, list of the referenced columns + </para></entry> </row> <row> - <entry><structfield>conpfeqop</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>If a foreign key, list of the equality operators for PK = FK comparisons</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conpfeqop</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + If a foreign key, list of the equality operators for PK = FK comparisons + </para></entry> </row> <row> - <entry><structfield>conppeqop</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>If a foreign key, list of the equality operators for PK = PK comparisons</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conppeqop</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + If a foreign key, list of the equality operators for PK = PK comparisons + </para></entry> </row> <row> - <entry><structfield>conffeqop</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>If a foreign key, list of the equality operators for FK = FK comparisons</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conffeqop</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + If a foreign key, list of the equality operators for FK = FK comparisons + </para></entry> </row> <row> - <entry><structfield>conexclop</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>If an exclusion constraint, list of the per-column exclusion operators</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conexclop</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + If an exclusion constraint, list of the per-column exclusion operators + </para></entry> </row> <row> - <entry><structfield>conbin</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry>If a check constraint, an internal representation of the - expression. (It's recommended to use - <function>pg_get_constraintdef()</function> to extract the definition of - a check constraint.)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conbin</structfield> <type>pg_node_tree</type> + </para> + <para> + If a check constraint, an internal representation of the + expression. (It's recommended to use + <function>pg_get_constraintdef()</function> to extract the definition of + a check constraint.) + </para></entry> </row> </tbody> </tgroup> @@ -2456,76 +2734,93 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_conversion</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>conname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Conversion name (unique within a namespace)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conname</structfield> <type>name</type> + </para> + <para> + Conversion name (unique within a namespace) + </para></entry> </row> <row> - <entry><structfield>connamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>connamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this conversion - </entry> + </para></entry> </row> <row> - <entry><structfield>conowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the conversion</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the conversion + </para></entry> </row> <row> - <entry><structfield>conforencoding</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Source encoding ID</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conforencoding</structfield> <type>int4</type> + </para> + <para> + Source encoding ID + </para></entry> </row> <row> - <entry><structfield>contoencoding</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Destination encoding ID</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>contoencoding</structfield> <type>int4</type> + </para> + <para> + Destination encoding ID + </para></entry> </row> <row> - <entry><structfield>conproc</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Conversion function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conproc</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Conversion function + </para></entry> </row> <row> - <entry><structfield>condefault</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if this is the default conversion</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>condefault</structfield> <type>bool</type> + </para> + <para> + True if this is the default conversion + </para></entry> </row> - </tbody> </tgroup> </table> @@ -2556,152 +2851,167 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_database</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Database name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Database name + </para></entry> </row> <row> - <entry><structfield>datdba</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the database, usually the user who created it</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datdba</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the database, usually the user who created it + </para></entry> </row> <row> - <entry><structfield>encoding</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Character encoding for this database - (<function>pg_encoding_to_char()</function> can translate - this number to the encoding name)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>encoding</structfield> <type>int4</type> + </para> + <para> + Character encoding for this database + (<function>pg_encoding_to_char()</function> can translate + this number to the encoding name) + </para></entry> </row> <row> - <entry><structfield>datcollate</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>LC_COLLATE for this database</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datcollate</structfield> <type>name</type> + </para> + <para> + LC_COLLATE for this database + </para></entry> </row> <row> - <entry><structfield>datctype</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>LC_CTYPE for this database</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datctype</structfield> <type>name</type> + </para> + <para> + LC_CTYPE for this database + </para></entry> </row> <row> - <entry><structfield>datistemplate</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datistemplate</structfield> <type>bool</type> + </para> + <para> If true, then this database can be cloned by any user with <literal>CREATEDB</literal> privileges; if false, then only superusers or the owner of the database can clone it. - </entry> + </para></entry> </row> <row> - <entry><structfield>datallowconn</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datallowconn</structfield> <type>bool</type> + </para> + <para> If false then no one can connect to this database. This is used to protect the <literal>template0</literal> database from being altered. - </entry> + </para></entry> </row> <row> - <entry><structfield>datconnlimit</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datconnlimit</structfield> <type>int4</type> + </para> + <para> Sets maximum number of concurrent connections that can be made to this database. -1 means no limit. - </entry> + </para></entry> </row> <row> - <entry><structfield>datlastsysoid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datlastsysoid</structfield> <type>oid</type> + </para> + <para> Last system OID in the database; useful particularly to <application>pg_dump</application> - </entry> + </para></entry> </row> <row> - <entry><structfield>datfrozenxid</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datfrozenxid</structfield> <type>xid</type> + </para> + <para> All transaction IDs before this one have been replaced with a permanent (<quote>frozen</quote>) transaction ID in this database. This is used to track whether the database needs to be vacuumed in order to prevent transaction ID wraparound or to allow <literal>pg_xact</literal> to be shrunk. It is the minimum of the per-table <structname>pg_class</structname>.<structfield>relfrozenxid</structfield> values. - </entry> + </para></entry> </row> <row> - <entry><structfield>datminmxid</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datminmxid</structfield> <type>xid</type> + </para> + <para> All multixact IDs before this one have been replaced with a transaction ID in this database. This is used to track whether the database needs to be vacuumed in order to prevent multixact ID wraparound or to allow <literal>pg_multixact</literal> to be shrunk. It is the minimum of the per-table <structname>pg_class</structname>.<structfield>relminmxid</structfield> values. - </entry> + </para></entry> </row> <row> - <entry><structfield>dattablespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dattablespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The default tablespace for the database. Within this database, all tables for which <structname>pg_class</structname>.<structfield>reltablespace</structfield> is zero will be stored in this tablespace; in particular, all the non-shared system catalogs will be there. - </entry> + </para></entry> </row> <row> - <entry><structfield>datacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2731,37 +3041,46 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_db_role_setting</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>setdatabase</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.oid</literal></entry> - <entry>The OID of the database the setting is applicable to, or zero if not database-specific</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>setdatabase</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the database the setting is applicable to, or zero if not database-specific + </para></entry> </row> <row> - <entry><structfield>setrole</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>The OID of the role the setting is applicable to, or zero if not role-specific</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>setrole</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the role the setting is applicable to, or zero if not role-specific + </para></entry> </row> <row> - <entry><structfield>setconfig</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry>Defaults for run-time configuration variables</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>setconfig</structfield> <type>text[]</type> + </para> + <para> + Defaults for run-time configuration variables + </para></entry> </row> </tbody> </tgroup> @@ -2783,61 +3102,70 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_default_acl</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>defaclrole</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>The OID of the role associated with this entry</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>defaclrole</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the role associated with this entry + </para></entry> </row> <row> - <entry><structfield>defaclnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry>The OID of the namespace associated with this entry, - or 0 if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>defaclnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the namespace associated with this entry, + or 0 if none + </para></entry> </row> <row> - <entry><structfield>defaclobjtype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>defaclobjtype</structfield> <type>char</type> + </para> + <para> Type of object this entry is for: <literal>r</literal> = relation (table, view), <literal>S</literal> = sequence, <literal>f</literal> = function, <literal>T</literal> = type, <literal>n</literal> = schema - </entry> + </para></entry> </row> <row> - <entry><structfield>defaclacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>defaclacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges that this type of object should have on creation - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2888,79 +3216,91 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_depend</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>classid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog the dependent object is in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog the dependent object is in + </para></entry> </row> <row> - <entry><structfield>objid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the specific dependent object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the specific dependent object + </para></entry> </row> <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int4</type> + </para> + <para> For a table column, this is the column number (the <structfield>objid</structfield> and <structfield>classid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> <row> - <entry><structfield>refclassid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog the referenced object is in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>refclassid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog the referenced object is in + </para></entry> </row> <row> - <entry><structfield>refobjid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the specific referenced object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>refobjid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the specific referenced object + </para></entry> </row> <row> - <entry><structfield>refobjsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>refobjsubid</structfield> <type>int4</type> + </para> + <para> For a table column, this is the column number (the <structfield>refobjid</structfield> and <structfield>refclassid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> <row> - <entry><structfield>deptype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>deptype</structfield> <type>char</type> + </para> + <para> A code defining the specific semantics of this dependency relationship; see text - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -3154,49 +3494,58 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_description</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>objoid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the object this description pertains to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objoid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the object this description pertains to + </para></entry> </row> <row> - <entry><structfield>classoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog this object appears in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog this object appears in + </para></entry> </row> <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int4</type> + </para> + <para> For a comment on a table column, this is the column number (the <structfield>objoid</structfield> and <structfield>classoid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> <row> - <entry><structfield>description</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Arbitrary text that serves as the description of this object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>description</structfield> <type>text</type> + </para> + <para> + Arbitrary text that serves as the description of this object + </para></entry> </row> </tbody> </tgroup> @@ -3221,44 +3570,54 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_enum</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>enumtypid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>The OID of the <structname>pg_type</structname> entry owning this enum value</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>enumtypid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the <structname>pg_type</structname> entry owning this enum value + </para></entry> </row> <row> - <entry><structfield>enumsortorder</structfield></entry> - <entry><type>float4</type></entry> - <entry></entry> - <entry>The sort position of this enum value within its enum type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>enumsortorder</structfield> <type>float4</type> + </para> + <para> + The sort position of this enum value within its enum type + </para></entry> </row> <row> - <entry><structfield>enumlabel</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>The textual label for this enum value</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>enumlabel</structfield> <type>name</type> + </para> + <para> + The textual label for this enum value + </para></entry> </row> </tbody> </tgroup> @@ -3300,75 +3659,88 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_event_trigger</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>evtname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Trigger name (must be unique)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>evtname</structfield> <type>name</type> + </para> + <para> + Trigger name (must be unique) + </para></entry> </row> <row> - <entry><structfield>evtevent</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Identifies the event for which this trigger fires</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>evtevent</structfield> <type>name</type> + </para> + <para> + Identifies the event for which this trigger fires + </para></entry> </row> <row> - <entry><structfield>evtowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the event trigger</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>evtowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the event trigger + </para></entry> </row> <row> - <entry><structfield>evtfoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>The function to be called</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>evtfoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The function to be called + </para></entry> </row> <row> - <entry><structfield>evtenabled</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>evtenabled</structfield> <type>char</type> + </para> + <para> Controls in which <xref linkend="guc-session-replication-role"/> modes the event trigger fires. <literal>O</literal> = trigger fires in <quote>origin</quote> and <quote>local</quote> modes, <literal>D</literal> = trigger is disabled, <literal>R</literal> = trigger fires in <quote>replica</quote> mode, <literal>A</literal> = trigger fires always. - </entry> + </para></entry> </row> <row> - <entry><structfield>evttags</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> - Command tags for which this trigger will fire. If NULL, the firing - of this trigger is not restricted on the basis of the command tag. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>evttags</structfield> <type>text[]</type> + </para> + <para> + Command tags for which this trigger will fire. If NULL, the firing + of this trigger is not restricted on the basis of the command tag. + </para></entry> </row> </tbody> </tgroup> @@ -3391,76 +3763,95 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_extension</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>extname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the extension</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extname</structfield> <type>name</type> + </para> + <para> + Name of the extension + </para></entry> </row> <row> - <entry><structfield>extowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the extension</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the extension + </para></entry> </row> <row> - <entry><structfield>extnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry>Schema containing the extension's exported objects</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Schema containing the extension's exported objects + </para></entry> </row> <row> - <entry><structfield>extrelocatable</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if extension can be relocated to another schema</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extrelocatable</structfield> <type>bool</type> + </para> + <para> + True if extension can be relocated to another schema + </para></entry> </row> <row> - <entry><structfield>extversion</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Version name for the extension</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extversion</structfield> <type>text</type> + </para> + <para> + Version name for the extension + </para></entry> </row> <row> - <entry><structfield>extconfig</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>Array of <type>regclass</type> OIDs for the extension's configuration - table(s), or <literal>NULL</literal> if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extconfig</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Array of <type>regclass</type> OIDs for the extension's configuration + table(s), or <literal>NULL</literal> if none + </para></entry> </row> <row> - <entry><structfield>extcondition</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry>Array of <literal>WHERE</literal>-clause filter conditions for the - extension's configuration table(s), or <literal>NULL</literal> if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extcondition</structfield> <type>text[]</type> + </para> + <para> + Array of <literal>WHERE</literal>-clause filter conditions for the + extension's configuration table(s), or <literal>NULL</literal> if none + </para></entry> </row> - </tbody> </tgroup> </table> @@ -3494,79 +3885,89 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_foreign_data_wrapper</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>fdwname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the foreign-data wrapper</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fdwname</structfield> <type>name</type> + </para> + <para> + Name of the foreign-data wrapper + </para></entry> </row> <row> - <entry><structfield>fdwowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the foreign-data wrapper</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fdwowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the foreign-data wrapper + </para></entry> </row> <row> - <entry><structfield>fdwhandler</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fdwhandler</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> References a handler function that is responsible for supplying execution routines for the foreign-data wrapper. Zero if no handler is provided - </entry> + </para></entry> </row> <row> - <entry><structfield>fdwvalidator</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fdwvalidator</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> References a validator function that is responsible for checking the validity of the options given to the foreign-data wrapper, as well as options for foreign servers and user mappings using the foreign-data wrapper. Zero if no validator is provided - </entry> + </para></entry> </row> <row> - <entry><structfield>fdwacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fdwacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> <row> - <entry><structfield>fdwoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fdwoptions</structfield> <type>text[]</type> + </para> + <para> Foreign-data wrapper specific options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3590,76 +3991,91 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_foreign_server</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>srvname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvname</structfield> <type>name</type> + </para> + <para> + Name of the foreign server + </para></entry> </row> <row> - <entry><structfield>srvowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the foreign server + </para></entry> </row> <row> - <entry><structfield>srvfdw</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-foreign-data-wrapper"><structname>pg_foreign_data_wrapper</structname></link>.oid</literal></entry> - <entry>OID of the foreign-data wrapper of this foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvfdw</structfield> <type>oid</type> + (references <link linkend="catalog-pg-foreign-data-wrapper"><structname>pg_foreign_data_wrapper</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the foreign-data wrapper of this foreign server + </para></entry> </row> <row> - <entry><structfield>srvtype</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Type of the server (optional)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvtype</structfield> <type>text</type> + </para> + <para> + Type of the server (optional) + </para></entry> </row> <row> - <entry><structfield>srvversion</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Version of the server (optional)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvversion</structfield> <type>text</type> + </para> + <para> + Version of the server (optional) + </para></entry> </row> <row> - <entry><structfield>srvacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> <row> - <entry><structfield>srvoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvoptions</structfield> <type>text[]</type> + </para> + <para> Foreign server specific options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3685,39 +4101,46 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_foreign_table</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>ftrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>OID of the <structname>pg_class</structname> entry for this foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ftrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the <structname>pg_class</structname> entry for this foreign table + </para></entry> </row> <row> - <entry><structfield>ftserver</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.oid</literal></entry> - <entry>OID of the foreign server for this foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ftserver</structfield> <type>oid</type> + (references <link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the foreign server for this foreign table + </para></entry> </row> <row> - <entry><structfield>ftoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ftoptions</structfield> <type>text[]</type> + </para> + <para> Foreign table options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3740,149 +4163,171 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_index</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>indexrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the <structname>pg_class</structname> entry for this index</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the <structname>pg_class</structname> entry for this index + </para></entry> </row> <row> - <entry><structfield>indrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the <structname>pg_class</structname> entry for the table this index is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the <structname>pg_class</structname> entry for the table this index is for + </para></entry> </row> <row> - <entry><structfield>indnatts</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>The total number of columns in the index (duplicates - <literal>pg_class.relnatts</literal>); this number includes both key and included attributes</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indnatts</structfield> <type>int2</type> + </para> + <para> + The total number of columns in the index (duplicates + <literal>pg_class.relnatts</literal>); this number includes both key and included attributes + </para></entry> </row> - <row> - <entry><structfield>indnkeyatts</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>The number of <firstterm>key columns</firstterm> in the index, + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indnkeyatts</structfield> <type>int2</type> + </para> + <para> + The number of <firstterm>key columns</firstterm> in the index, not counting any <firstterm>included columns</firstterm>, which are - merely stored and do not participate in the index semantics</entry> + merely stored and do not participate in the index semantics + </para></entry> </row> <row> - <entry><structfield>indisunique</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, this is a unique index</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisunique</structfield> <type>bool</type> + </para> + <para> + If true, this is a unique index + </para></entry> </row> <row> - <entry><structfield>indisprimary</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, this index represents the primary key of the table - (<structfield>indisunique</structfield> should always be true when this is true)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisprimary</structfield> <type>bool</type> + </para> + <para> + If true, this index represents the primary key of the table + (<structfield>indisunique</structfield> should always be true when this is true) + </para></entry> </row> <row> - <entry><structfield>indisexclusion</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, this index supports an exclusion constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisexclusion</structfield> <type>bool</type> + </para> + <para> + If true, this index supports an exclusion constraint + </para></entry> </row> <row> - <entry><structfield>indimmediate</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, the uniqueness check is enforced immediately on + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indimmediate</structfield> <type>bool</type> + </para> + <para> + If true, the uniqueness check is enforced immediately on insertion - (irrelevant if <structfield>indisunique</structfield> is not true)</entry> + (irrelevant if <structfield>indisunique</structfield> is not true) + </para></entry> </row> <row> - <entry><structfield>indisclustered</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, the table was last clustered on this index</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisclustered</structfield> <type>bool</type> + </para> + <para> + If true, the table was last clustered on this index + </para></entry> </row> <row> - <entry><structfield>indisvalid</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisvalid</structfield> <type>bool</type> + </para> + <para> If true, the index is currently valid for queries. False means the index is possibly incomplete: it must still be modified by <command>INSERT</command>/<command>UPDATE</command> operations, but it cannot safely be used for queries. If it is unique, the uniqueness property is not guaranteed true either. - </entry> + </para></entry> </row> <row> - <entry><structfield>indcheckxmin</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indcheckxmin</structfield> <type>bool</type> + </para> + <para> If true, queries must not use the index until the <structfield>xmin</structfield> of this <structname>pg_index</structname> row is below their <symbol>TransactionXmin</symbol> event horizon, because the table may contain broken HOT chains with incompatible rows that they can see - </entry> + </para></entry> </row> <row> - <entry><structfield>indisready</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisready</structfield> <type>bool</type> + </para> + <para> If true, the index is currently ready for inserts. False means the index must be ignored by <command>INSERT</command>/<command>UPDATE</command> operations. - </entry> + </para></entry> </row> <row> - <entry><structfield>indislive</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indislive</structfield> <type>bool</type> + </para> + <para> If false, the index is in process of being dropped, and should be ignored for all purposes (including HOT-safety decisions) - </entry> + </para></entry> </row> <row> - <entry><structfield>indisreplident</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indisreplident</structfield> <type>bool</type> + </para> + <para> If true this index has been chosen as <quote>replica identity</quote> using <command>ALTER TABLE ... REPLICA IDENTITY USING INDEX ...</command> - </entry> + </para></entry> </row> <row> - <entry><structfield>indkey</structfield></entry> - <entry><type>int2vector</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indkey</structfield> <type>int2vector</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> This is an array of <structfield>indnatts</structfield> values that indicate which table columns this index indexes. For example a value of <literal>1 3</literal> would mean that the first and the third table @@ -3890,66 +4335,68 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l (included) columns. A zero in this array indicates that the corresponding index attribute is an expression over the table columns, rather than a simple column reference. - </entry> + </para></entry> </row> <row> - <entry><structfield>indcollation</structfield></entry> - <entry><type>oidvector</type></entry> - <entry><literal><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indcollation</structfield> <type>oidvector</type> + (references <link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.<structfield>oid</structfield>) + </para> + <para> For each column in the index key (<structfield>indnkeyatts</structfield> values), this contains the OID of the collation to use for the index, or zero if the column is not of a collatable data type. - </entry> + </para></entry> </row> <row> - <entry><structfield>indclass</structfield></entry> - <entry><type>oidvector</type></entry> - <entry><literal><link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indclass</structfield> <type>oidvector</type> + (references <link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link>.<structfield>oid</structfield>) + </para> + <para> For each column in the index key (<structfield>indnkeyatts</structfield> values), this contains the OID of the operator class to use. See <link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link> for details. - </entry> + </para></entry> </row> <row> - <entry><structfield>indoption</structfield></entry> - <entry><type>int2vector</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indoption</structfield> <type>int2vector</type> + </para> + <para> This is an array of <structfield>indnkeyatts</structfield> values that store per-column flag bits. The meaning of the bits is defined by the index's access method. - </entry> + </para></entry> </row> <row> - <entry><structfield>indexprs</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexprs</structfield> <type>pg_node_tree</type> + </para> + <para> Expression trees (in <function>nodeToString()</function> representation) for index attributes that are not simple column references. This is a list with one element for each zero entry in <structfield>indkey</structfield>. Null if all index attributes are simple references. - </entry> + </para></entry> </row> <row> - <entry><structfield>indpred</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indpred</structfield> <type>pg_node_tree</type> + </para> + <para> Expression tree (in <function>nodeToString()</function> representation) for partial index predicate. Null if not a partial index. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3974,45 +4421,48 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_inherits</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>inhrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>inhrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the child table - </entry> + </para></entry> </row> <row> - <entry><structfield>inhparent</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>inhparent</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the parent table - </entry> + </para></entry> </row> <row> - <entry><structfield>inhseqno</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>inhseqno</structfield> <type>int4</type> + </para> + <para> If there is more than one direct parent for a child table (multiple inheritance), this number tells the order in which the inherited columns are to be arranged. The count starts at 1. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -4058,63 +4508,69 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_init_privs</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>objoid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the specific object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objoid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the specific object + </para></entry> </row> <row> - <entry><structfield>classoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog the object is in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog the object is in + </para></entry> </row> <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int4</type> + </para> + <para> For a table column, this is the column number (the <structfield>objoid</structfield> and <structfield>classoid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> <row> - <entry><structfield>privtype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privtype</structfield> <type>char</type> + </para> + <para> A code defining the type of initial privilege of this object; see text - </entry> + </para></entry> </row> <row> - <entry><structfield>initprivs</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>initprivs</structfield> <type>aclitem[]</type> + </para> + <para> The initial access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -4138,106 +4594,117 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_language</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>lanname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the language</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanname</structfield> <type>name</type> + </para> + <para> + Name of the language + </para></entry> </row> <row> - <entry><structfield>lanowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the language</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the language + </para></entry> </row> <row> - <entry><structfield>lanispl</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanispl</structfield> <type>bool</type> + </para> + <para> This is false for internal languages (such as <acronym>SQL</acronym>) and true for user-defined languages. Currently, <application>pg_dump</application> still uses this to determine which languages need to be dumped, but this might be replaced by a different mechanism in the future. - </entry> + </para></entry> </row> <row> - <entry><structfield>lanpltrusted</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanpltrusted</structfield> <type>bool</type> + </para> + <para> True if this is a trusted language, which means that it is believed not to grant access to anything outside the normal SQL execution environment. Only superusers can create functions in untrusted languages. - </entry> + </para></entry> </row> <row> - <entry><structfield>lanplcallfoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanplcallfoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> For noninternal languages this references the language handler, which is a special function that is responsible for executing all functions that are written in the particular language - </entry> + </para></entry> </row> <row> - <entry><structfield>laninline</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>laninline</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> This references a function that is responsible for executing <quote>inline</quote> anonymous code blocks (<xref linkend="sql-do"/> blocks). Zero if inline blocks are not supported. - </entry> + </para></entry> </row> <row> - <entry><structfield>lanvalidator</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanvalidator</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> This references a language validator function that is responsible for checking the syntax and validity of new functions when they are created. Zero if no validator is provided. - </entry> + </para></entry> </row> <row> - <entry><structfield>lanacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lanacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -4275,41 +4742,47 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_largeobject</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>loid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-largeobject-metadata"><structname>pg_largeobject_metadata</structname></link>.oid</literal></entry> - <entry>Identifier of the large object that includes this page</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>loid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-largeobject-metadata"><structname>pg_largeobject_metadata</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Identifier of the large object that includes this page + </para></entry> </row> <row> - <entry><structfield>pageno</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>Page number of this page within its large object - (counting from zero)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pageno</structfield> <type>int4</type> + </para> + <para> + Page number of this page within its large object + (counting from zero) + </para></entry> </row> <row> - <entry><structfield>data</structfield></entry> - <entry><type>bytea</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data</structfield> <type>bytea</type> + </para> + <para> Actual data stored in the large object. This will never be more than <symbol>LOBLKSIZE</symbol> bytes and might be less. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -4342,41 +4815,46 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_largeobject_metadata</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>lomowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the large object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lomowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the large object + </para></entry> </row> <row> - <entry><structfield>lomacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lomacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -4399,46 +4877,54 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_namespace</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>nspname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the namespace</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>nspname</structfield> <type>name</type> + </para> + <para> + Name of the namespace + </para></entry> </row> <row> - <entry><structfield>nspowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the namespace</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>nspowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the namespace + </para></entry> </row> <row> - <entry><structfield>nspacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>nspacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -4471,81 +4957,105 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_opclass</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> + <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>opcmethod</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-am"><structname>pg_am</structname></link>.oid</literal></entry> - <entry>Index access method operator class is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcmethod</structfield> <type>oid</type> + (references <link linkend="catalog-pg-am"><structname>pg_am</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Index access method operator class is for + </para></entry> </row> <row> - <entry><structfield>opcname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of this operator class</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcname</structfield> <type>name</type> + </para> + <para> + Name of this operator class + </para></entry> </row> <row> - <entry><structfield>opcnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry>Namespace of this operator class</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Namespace of this operator class + </para></entry> </row> <row> - <entry><structfield>opcowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the operator class</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the operator class + </para></entry> </row> <row> - <entry><structfield>opcfamily</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.oid</literal></entry> - <entry>Operator family containing the operator class</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcfamily</structfield> <type>oid</type> + (references <link linkend="catalog-pg-opfamily"><structname>pg_opfamily</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Operator family containing the operator class + </para></entry> </row> <row> - <entry><structfield>opcintype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type that the operator class indexes</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcintype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type that the operator class indexes + </para></entry> </row> <row> - <entry><structfield>opcdefault</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if this operator class is the default for <structfield>opcintype</structfield></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opcdefault</structfield> <type>bool</type> + </para> + <para> + True if this operator class is the default for <structfield>opcintype</structfield> + </para></entry> </row> <row> - <entry><structfield>opckeytype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Type of data stored in index, or zero if same as <structfield>opcintype</structfield></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opckeytype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Type of data stored in index, or zero if same as <structfield>opcintype</structfield> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -4576,126 +5086,163 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_operator</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>oprname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprname</structfield> <type>name</type> + </para> + <para> + Name of the operator + </para></entry> </row> <row> - <entry><structfield>oprnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this operator - </entry> + </para></entry> </row> <row> - <entry><structfield>oprowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the operator + </para></entry> </row> <row> - <entry><structfield>oprkind</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprkind</structfield> <type>char</type> + </para> + <para> <literal>b</literal> = infix (<quote>both</quote>), <literal>l</literal> = prefix (<quote>left</quote>), <literal>r</literal> = postfix (<quote>right</quote>) - </entry> + </para></entry> </row> <row> - <entry><structfield>oprcanmerge</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>This operator supports merge joins</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprcanmerge</structfield> <type>bool</type> + </para> + <para> + This operator supports merge joins + </para></entry> </row> <row> - <entry><structfield>oprcanhash</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>This operator supports hash joins</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprcanhash</structfield> <type>bool</type> + </para> + <para> + This operator supports hash joins + </para></entry> </row> <row> - <entry><structfield>oprleft</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Type of the left operand</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprleft</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Type of the left operand + </para></entry> </row> <row> - <entry><structfield>oprright</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Type of the right operand</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprright</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Type of the right operand + </para></entry> </row> <row> - <entry><structfield>oprresult</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Type of the result</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprresult</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Type of the result + </para></entry> </row> <row> - <entry><structfield>oprcom</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>Commutator of this operator, if any</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprcom</structfield> <type>oid</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Commutator of this operator, if any + </para></entry> </row> <row> - <entry><structfield>oprnegate</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry>Negator of this operator, if any</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprnegate</structfield> <type>oid</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Negator of this operator, if any + </para></entry> </row> <row> - <entry><structfield>oprcode</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Function that implements this operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprcode</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Function that implements this operator + </para></entry> </row> <row> - <entry><structfield>oprrest</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Restriction selectivity estimation function for this operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprrest</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Restriction selectivity estimation function for this operator + </para></entry> </row> <row> - <entry><structfield>oprjoin</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Join selectivity estimation function for this operator</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oprjoin</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Join selectivity estimation function for this operator + </para></entry> </row> </tbody> </tgroup> @@ -4733,53 +5280,66 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_opfamily</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> + <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>opfmethod</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-am"><structname>pg_am</structname></link>.oid</literal></entry> - <entry>Index access method operator family is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opfmethod</structfield> <type>oid</type> + (references <link linkend="catalog-pg-am"><structname>pg_am</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Index access method operator family is for + </para></entry> </row> <row> - <entry><structfield>opfname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of this operator family</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opfname</structfield> <type>name</type> + </para> + <para> + Name of this operator family + </para></entry> </row> <row> - <entry><structfield>opfnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry>Namespace of this operator family</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opfnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Namespace of this operator family + </para></entry> </row> <row> - <entry><structfield>opfowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the operator family</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>opfowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the operator family + </para></entry> </row> - </tbody> </tgroup> </table> @@ -4810,103 +5370,111 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_partitioned_table</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> - <row> - <entry><structfield>partrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the <structname>pg_class</structname> entry for this partitioned table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the <structname>pg_class</structname> entry for this partitioned table + </para></entry> </row> <row> - <entry><structfield>partstrat</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partstrat</structfield> <type>char</type> + </para> + <para> Partitioning strategy; <literal>h</literal> = hash partitioned table, <literal>l</literal> = list partitioned table, <literal>r</literal> = range partitioned table - </entry> + </para></entry> </row> <row> - <entry><structfield>partnatts</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>The number of columns in partition key</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partnatts</structfield> <type>int2</type> + </para> + <para> + The number of columns in partition key + </para></entry> </row> <row> - <entry><structfield>partdefid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partdefid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the <structname>pg_class</structname> entry for the default partition of this partitioned table, or zero if this partitioned table does not have a default partition. - </entry> + </para></entry> </row> <row> - <entry><structfield>partattrs</structfield></entry> - <entry><type>int2vector</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partattrs</structfield> <type>int2vector</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> This is an array of <structfield>partnatts</structfield> values that indicate which table columns are part of the partition key. For example, a value of <literal>1 3</literal> would mean that the first and the third table columns make up the partition key. A zero in this array indicates that the corresponding partition key column is an expression, rather than a simple column reference. - </entry> + </para></entry> </row> <row> - <entry><structfield>partclass</structfield></entry> - <entry><type>oidvector</type></entry> - <entry><literal><link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partclass</structfield> <type>oidvector</type> + (references <link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link>.<structfield>oid</structfield>) + </para> + <para> For each column in the partition key, this contains the OID of the operator class to use. See <link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link> for details. - </entry> + </para></entry> </row> <row> - <entry><structfield>partcollation</structfield></entry> - <entry><type>oidvector</type></entry> - <entry><literal><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partcollation</structfield> <type>oidvector</type> + (references <link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.<structfield>oid</structfield>) + </para> + <para> For each column in the partition key, this contains the OID of the collation to use for partitioning, or zero if the column is not of a collatable data type. - </entry> + </para></entry> </row> <row> - <entry><structfield>partexprs</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partexprs</structfield> <type>pg_node_tree</type> + </para> + <para> Expression trees (in <function>nodeToString()</function> representation) for partition key columns that are not simple column references. This is a list with one element for each zero entry in <structfield>partattrs</structfield>. Null if all partition key columns are simple references. - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -4931,81 +5499,98 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </para> <table> - <title><structname>pg_policy</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>polname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>The name of the policy</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polname</structfield> <type>name</type> + </para> + <para> + The name of the policy + </para></entry> </row> <row> - <entry><structfield>polrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table to which the policy applies</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table to which the policy applies + </para></entry> </row> <row> - <entry><structfield>polcmd</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry>The command type to which the policy is applied: + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polcmd</structfield> <type>char</type> + </para> + <para> + The command type to which the policy is applied: <literal>r</literal> for <command>SELECT</command>, <literal>a</literal> for <command>INSERT</command>, <literal>w</literal> for <command>UPDATE</command>, <literal>d</literal> for <command>DELETE</command>, - or <literal>*</literal> for all</entry> + or <literal>*</literal> for all + </para></entry> </row> <row> - <entry><structfield>polpermissive</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>Is the policy permissive or restrictive?</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polpermissive</structfield> <type>bool</type> + </para> + <para> + Is the policy permissive or restrictive? + </para></entry> </row> <row> - <entry><structfield>polroles</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>The roles to which the policy is applied</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polroles</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The roles to which the policy is applied + </para></entry> </row> <row> - <entry><structfield>polqual</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry>The expression tree to be added to the security barrier qualifications for queries that use the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polqual</structfield> <type>pg_node_tree</type> + </para> + <para> + The expression tree to be added to the security barrier qualifications for queries that use the table + </para></entry> </row> <row> - <entry><structfield>polwithcheck</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry>The expression tree to be added to the WITH CHECK qualifications for queries that attempt to add rows to the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>polwithcheck</structfield> <type>pg_node_tree</type> + </para> + <para> + The expression tree to be added to the WITH CHECK qualifications for queries that attempt to add rows to the table + </para></entry> </row> - </tbody> </tgroup> </table> @@ -5043,141 +5628,169 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_proc</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>proname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proname</structfield> <type>name</type> + </para> + <para> + Name of the function + </para></entry> </row> <row> - <entry><structfield>pronamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pronamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this function - </entry> + </para></entry> </row> <row> - <entry><structfield>proowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the function + </para></entry> </row> <row> - <entry><structfield>prolang</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-language"><structname>pg_language</structname></link>.oid</literal></entry> - <entry>Implementation language or call interface of this function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prolang</structfield> <type>oid</type> + (references <link linkend="catalog-pg-language"><structname>pg_language</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Implementation language or call interface of this function + </para></entry> </row> <row> - <entry><structfield>procost</structfield></entry> - <entry><type>float4</type></entry> - <entry></entry> - <entry>Estimated execution cost (in units of + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>procost</structfield> <type>float4</type> + </para> + <para> + Estimated execution cost (in units of <xref linkend="guc-cpu-operator-cost"/>); if <structfield>proretset</structfield>, - this is cost per row returned</entry> + this is cost per row returned + </para></entry> </row> <row> - <entry><structfield>prorows</structfield></entry> - <entry><type>float4</type></entry> - <entry></entry> - <entry>Estimated number of result rows (zero if not <structfield>proretset</structfield>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prorows</structfield> <type>float4</type> + </para> + <para> + Estimated number of result rows (zero if not <structfield>proretset</structfield>) + </para></entry> </row> <row> - <entry><structfield>provariadic</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type of the variadic array parameter's elements, - or zero if the function does not have a variadic parameter</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>provariadic</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type of the variadic array parameter's elements, + or zero if the function does not have a variadic parameter + </para></entry> </row> <row> - <entry><structfield>prosupport</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Optional planner support function for this function - (see <xref linkend="xfunc-optimization"/>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prosupport</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Optional planner support function for this function + (see <xref linkend="xfunc-optimization"/>) + </para></entry> </row> <row> - <entry><structfield>prokind</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry><literal>f</literal> for a normal function, <literal>p</literal> - for a procedure, <literal>a</literal> for an aggregate function, or - <literal>w</literal> for a window function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prokind</structfield> <type>char</type> + </para> + <para> + <literal>f</literal> for a normal function, <literal>p</literal> + for a procedure, <literal>a</literal> for an aggregate function, or + <literal>w</literal> for a window function + </para></entry> </row> <row> - <entry><structfield>prosecdef</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Function is a security definer (i.e., a <quote>setuid</quote> - function)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prosecdef</structfield> <type>bool</type> + </para> + <para> + Function is a security definer (i.e., a <quote>setuid</quote> + function) + </para></entry> </row> <row> - <entry><structfield>proleakproof</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proleakproof</structfield> <type>bool</type> + </para> + <para> The function has no side effects. No information about the arguments is conveyed except via the return value. Any function that might throw an error depending on the values of its arguments is not leak-proof. - </entry> + </para></entry> </row> <row> - <entry><structfield>proisstrict</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proisstrict</structfield> <type>bool</type> + </para> + <para> Function returns null if any call argument is null. In that case the function won't actually be called at all. Functions that are not <quote>strict</quote> must be prepared to handle null inputs. - </entry> + </para></entry> </row> <row> - <entry><structfield>proretset</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Function returns a set (i.e., multiple values of the specified - data type)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proretset</structfield> <type>bool</type> + </para> + <para> + Function returns a set (i.e., multiple values of the specified + data type) + </para></entry> </row> <row> - <entry><structfield>provolatile</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>provolatile</structfield> <type>char</type> + </para> + <para> <structfield>provolatile</structfield> tells whether the function's result depends only on its input arguments, or is affected by outside factors. @@ -5189,14 +5802,14 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l whose results might change at any time. (Use <literal>v</literal> also for functions with side-effects, so that calls to them cannot get optimized away.) - </entry> + </para></entry> </row> <row> - <entry><structfield>proparallel</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proparallel</structfield> <type>char</type> + </para> + <para> <structfield>proparallel</structfield> tells whether the function can be safely run in parallel mode. It is <literal>s</literal> for functions which are safe to run in @@ -5206,146 +5819,157 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l parallel worker processes cannot invoke these functions. It is <literal>u</literal> for functions which are unsafe in parallel mode; the presence of such a function forces a serial execution plan. - </entry> + </para></entry> </row> <row> - <entry><structfield>pronargs</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Number of input arguments</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pronargs</structfield> <type>int2</type> + </para> + <para> + Number of input arguments + </para></entry> </row> <row> - <entry><structfield>pronargdefaults</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Number of arguments that have defaults</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pronargdefaults</structfield> <type>int2</type> + </para> + <para> + Number of arguments that have defaults + </para></entry> </row> <row> - <entry><structfield>prorettype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type of the return value</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prorettype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type of the return value + </para></entry> </row> <row> - <entry><structfield>proargtypes</structfield></entry> - <entry><type>oidvector</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proargtypes</structfield> <type>oidvector</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> An array with the data types of the function arguments. This includes only input arguments (including <literal>INOUT</literal> and <literal>VARIADIC</literal> arguments), and thus represents the call signature of the function. - </entry> + </para></entry> </row> <row> - <entry><structfield>proallargtypes</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proallargtypes</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> An array with the data types of the function arguments. This includes all arguments (including <literal>OUT</literal> and <literal>INOUT</literal> arguments); however, if all the arguments are <literal>IN</literal> arguments, this field will be null. Note that subscripting is 1-based, whereas for historical reasons <structfield>proargtypes</structfield> is subscripted from 0. - </entry> + </para></entry> </row> <row> - <entry><structfield>proargmodes</structfield></entry> - <entry><type>char[]</type></entry> - <entry></entry> - <entry> - An array with the modes of the function arguments, encoded as - <literal>i</literal> for <literal>IN</literal> arguments, - <literal>o</literal> for <literal>OUT</literal> arguments, - <literal>b</literal> for <literal>INOUT</literal> arguments, - <literal>v</literal> for <literal>VARIADIC</literal> arguments, - <literal>t</literal> for <literal>TABLE</literal> arguments. - If all the arguments are <literal>IN</literal> arguments, - this field will be null. - Note that subscripts correspond to positions of - <structfield>proallargtypes</structfield> not <structfield>proargtypes</structfield>. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proargmodes</structfield> <type>char[]</type> + </para> + <para> + An array with the modes of the function arguments, encoded as + <literal>i</literal> for <literal>IN</literal> arguments, + <literal>o</literal> for <literal>OUT</literal> arguments, + <literal>b</literal> for <literal>INOUT</literal> arguments, + <literal>v</literal> for <literal>VARIADIC</literal> arguments, + <literal>t</literal> for <literal>TABLE</literal> arguments. + If all the arguments are <literal>IN</literal> arguments, + this field will be null. + Note that subscripts correspond to positions of + <structfield>proallargtypes</structfield> not <structfield>proargtypes</structfield>. + </para></entry> </row> <row> - <entry><structfield>proargnames</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> - An array with the names of the function arguments. - Arguments without a name are set to empty strings in the array. - If none of the arguments have a name, this field will be null. - Note that subscripts correspond to positions of - <structfield>proallargtypes</structfield> not <structfield>proargtypes</structfield>. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proargnames</structfield> <type>text[]</type> + </para> + <para> + An array with the names of the function arguments. + Arguments without a name are set to empty strings in the array. + If none of the arguments have a name, this field will be null. + Note that subscripts correspond to positions of + <structfield>proallargtypes</structfield> not <structfield>proargtypes</structfield>. + </para></entry> </row> <row> - <entry><structfield>proargdefaults</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proargdefaults</structfield> <type>pg_node_tree</type> + </para> + <para> Expression trees (in <function>nodeToString()</function> representation) for default values. This is a list with <structfield>pronargdefaults</structfield> elements, corresponding to the last <replaceable>N</replaceable> <emphasis>input</emphasis> arguments (i.e., the last <replaceable>N</replaceable> <structfield>proargtypes</structfield> positions). If none of the arguments have defaults, this field will be null. - </entry> + </para></entry> </row> <row> - <entry><structfield>protrftypes</structfield></entry> - <entry><type>oid[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>protrftypes</structfield> <type>oid[]</type> + </para> + <para> Data type OIDs for which to apply transforms. - </entry> + </para></entry> </row> <row> - <entry><structfield>prosrc</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prosrc</structfield> <type>text</type> + </para> + <para> This tells the function handler how to invoke the function. It might be the actual source code of the function for interpreted languages, a link symbol, a file name, or just about anything else, depending on the implementation language/call convention. - </entry> + </para></entry> </row> <row> - <entry><structfield>probin</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>probin</structfield> <type>text</type> + </para> + <para> Additional information about how to invoke the function. Again, the interpretation is language-specific. - </entry> + </para></entry> </row> <row> - <entry><structfield>proconfig</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry>Function's local settings for run-time configuration variables</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proconfig</structfield> <type>text[]</type> + </para> + <para> + Function's local settings for run-time configuration variables + </para></entry> </row> <row> - <entry><structfield>proacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>proacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -5378,88 +6002,106 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_publication</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>pubname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the publication</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubname</structfield> <type>name</type> + </para> + <para> + Name of the publication + </para></entry> </row> <row> - <entry><structfield>pubowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the publication</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the publication + </para></entry> </row> <row> - <entry><structfield>puballtables</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, this publication automatically includes all tables + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>puballtables</structfield> <type>bool</type> + </para> + <para> + If true, this publication automatically includes all tables in the database, including any that will be created in the future. - </entry> + </para></entry> </row> <row> - <entry><structfield>pubinsert</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, <command>INSERT</command> operations are replicated for - tables in the publication.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubinsert</structfield> <type>bool</type> + </para> + <para> + If true, <command>INSERT</command> operations are replicated for + tables in the publication. + </para></entry> </row> <row> - <entry><structfield>pubupdate</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, <command>UPDATE</command> operations are replicated for - tables in the publication.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubupdate</structfield> <type>bool</type> + </para> + <para> + If true, <command>UPDATE</command> operations are replicated for + tables in the publication. + </para></entry> </row> <row> - <entry><structfield>pubdelete</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, <command>DELETE</command> operations are replicated for - tables in the publication.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubdelete</structfield> <type>bool</type> + </para> + <para> + If true, <command>DELETE</command> operations are replicated for + tables in the publication. + </para></entry> </row> <row> - <entry><structfield>pubtruncate</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, <command>TRUNCATE</command> operations are replicated for - tables in the publication.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubtruncate</structfield> <type>bool</type> + </para> + <para> + If true, <command>TRUNCATE</command> operations are replicated for + tables in the publication. + </para></entry> </row> <row> - <entry><structfield>pubviaroot</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, operations on a leaf partition are replicated using the + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubviaroot</structfield> <type>bool</type> + </para> + <para> + If true, operations on a leaf partition are replicated using the identity and schema of its topmost partitioned ancestor mentioned in the publication instead of its own. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -5482,37 +6124,46 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_publication_rel</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>prpubid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-publication"><structname>pg_publication</structname></link>.oid</literal></entry> - <entry>Reference to publication</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prpubid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-publication"><structname>pg_publication</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Reference to publication + </para></entry> </row> <row> - <entry><structfield>prrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>Reference to relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Reference to relation + </para></entry> </row> </tbody> </tgroup> @@ -5534,60 +6185,79 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_range</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>rngtypid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>OID of the range type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rngtypid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the range type + </para></entry> </row> <row> - <entry><structfield>rngsubtype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>OID of the element type (subtype) of this range type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rngsubtype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the element type (subtype) of this range type + </para></entry> </row> <row> - <entry><structfield>rngcollation</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.oid</literal></entry> - <entry>OID of the collation used for range comparisons, or 0 if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rngcollation</structfield> <type>oid</type> + (references <link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the collation used for range comparisons, or 0 if none + </para></entry> </row> <row> - <entry><structfield>rngsubopc</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link>.oid</literal></entry> - <entry>OID of the subtype's operator class used for range comparisons</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rngsubopc</structfield> <type>oid</type> + (references <link linkend="catalog-pg-opclass"><structname>pg_opclass</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the subtype's operator class used for range comparisons + </para></entry> </row> <row> - <entry><structfield>rngcanonical</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the function to convert a range value into canonical form, - or 0 if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rngcanonical</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the function to convert a range value into canonical form, + or 0 if none + </para></entry> </row> <row> - <entry><structfield>rngsubdiff</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the function to return the difference between two element - values as <type>double precision</type>, or 0 if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rngsubdiff</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the function to return the difference between two element + values as <type>double precision</type>, or 0 if none + </para></entry> </row> </tbody> </tgroup> @@ -5624,34 +6294,38 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </para> <table> - <title><structname>pg_replication_origin</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>roident</structfield></entry> - <entry><type>Oid</type></entry> - <entry></entry> - <entry>A unique, cluster-wide identifier for the replication - origin. Should never leave the system.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>roident</structfield> <type>oid</type> + </para> + <para> + A unique, cluster-wide identifier for the replication + origin. Should never leave the system. + </para></entry> </row> <row> - <entry><structfield>roname</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The external, user defined, name of a replication - origin.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>roname</structfield> <type>text</type> + </para> + <para> + The external, user defined, name of a replication + origin. + </para></entry> </row> </tbody> </tgroup> @@ -5671,91 +6345,101 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_rewrite</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>rulename</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Rule name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rulename</structfield> <type>name</type> + </para> + <para> + Rule name + </para></entry> </row> <row> - <entry><structfield>ev_class</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table this rule is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ev_class</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table this rule is for + </para></entry> </row> <row> - <entry><structfield>ev_type</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ev_type</structfield> <type>char</type> + </para> + <para> Event type that the rule is for: 1 = <command>SELECT</command>, 2 = <command>UPDATE</command>, 3 = <command>INSERT</command>, 4 = <command>DELETE</command> - </entry> + </para></entry> </row> <row> - <entry><structfield>ev_enabled</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ev_enabled</structfield> <type>char</type> + </para> + <para> Controls in which <xref linkend="guc-session-replication-role"/> modes the rule fires. <literal>O</literal> = rule fires in <quote>origin</quote> and <quote>local</quote> modes, <literal>D</literal> = rule is disabled, <literal>R</literal> = rule fires in <quote>replica</quote> mode, <literal>A</literal> = rule fires always. - </entry> + </para></entry> </row> <row> - <entry><structfield>is_instead</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if the rule is an <literal>INSTEAD</literal> rule</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_instead</structfield> <type>bool</type> + </para> + <para> + True if the rule is an <literal>INSTEAD</literal> rule + </para></entry> </row> <row> - <entry><structfield>ev_qual</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ev_qual</structfield> <type>pg_node_tree</type> + </para> + <para> Expression tree (in the form of a <function>nodeToString()</function> representation) for the rule's qualifying condition - </entry> + </para></entry> </row> <row> - <entry><structfield>ev_action</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ev_action</structfield> <type>pg_node_tree</type> + </para> + <para> Query tree (in the form of a <function>nodeToString()</function> representation) for the rule's action - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -5792,56 +6476,67 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_seclabel</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>objoid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the object this security label pertains to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objoid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the object this security label pertains to + </para></entry> </row> <row> - <entry><structfield>classoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog this object appears in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog this object appears in + </para></entry> </row> <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int4</type> + </para> + <para> For a security label on a table column, this is the column number (the <structfield>objoid</structfield> and <structfield>classoid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> <row> - <entry><structfield>provider</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The label provider associated with this label.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>provider</structfield> <type>text</type> + </para> + <para> + The label provider associated with this label. + </para></entry> </row> <row> - <entry><structfield>label</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The security label applied to this object.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>label</structfield> <type>text</type> + </para> + <para> + The security label applied to this object. + </para></entry> </row> </tbody> </tgroup> @@ -5863,72 +6558,91 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_sequence</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>seqrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the <structname>pg_class</structname> entry for this sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the <structname>pg_class</structname> entry for this sequence + </para></entry> </row> <row> - <entry><structfield>seqtypid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqtypid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type of the sequence + </para></entry> </row> <row> - <entry><structfield>seqstart</structfield></entry> - <entry><type>int8</type></entry> - <entry></entry> - <entry>Start value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqstart</structfield> <type>int8</type> + </para> + <para> + Start value of the sequence + </para></entry> </row> <row> - <entry><structfield>seqincrement</structfield></entry> - <entry><type>int8</type></entry> - <entry></entry> - <entry>Increment value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqincrement</structfield> <type>int8</type> + </para> + <para> + Increment value of the sequence + </para></entry> </row> <row> - <entry><structfield>seqmax</structfield></entry> - <entry><type>int8</type></entry> - <entry></entry> - <entry>Maximum value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqmax</structfield> <type>int8</type> + </para> + <para> + Maximum value of the sequence + </para></entry> </row> <row> - <entry><structfield>seqmin</structfield></entry> - <entry><type>int8</type></entry> - <entry></entry> - <entry>Minimum value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqmin</structfield> <type>int8</type> + </para> + <para> + Minimum value of the sequence + </para></entry> </row> <row> - <entry><structfield>seqcache</structfield></entry> - <entry><type>int8</type></entry> - <entry></entry> - <entry>Cache size of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqcache</structfield> <type>int8</type> + </para> + <para> + Cache size of the sequence + </para></entry> </row> <row> - <entry><structfield>seqcycle</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Whether the sequence cycles</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqcycle</structfield> <type>bool</type> + </para> + <para> + Whether the sequence cycles + </para></entry> </row> </tbody> </tgroup> @@ -5965,75 +6679,90 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_shdepend</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>dbid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.oid</literal></entry> - <entry>The OID of the database the dependent object is in, - or zero for a shared object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dbid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the database the dependent object is in, + or zero for a shared object + </para></entry> </row> <row> - <entry><structfield>classid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog the dependent object is in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog the dependent object is in + </para></entry> </row> <row> - <entry><structfield>objid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the specific dependent object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the specific dependent object + </para></entry> </row> <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int4</type> + </para> + <para> For a table column, this is the column number (the <structfield>objid</structfield> and <structfield>classid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> <row> - <entry><structfield>refclassid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog the referenced object is in - (must be a shared catalog)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>refclassid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog the referenced object is in + (must be a shared catalog) + </para></entry> </row> <row> - <entry><structfield>refobjid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the specific referenced object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>refobjid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the specific referenced object + </para></entry> </row> <row> - <entry><structfield>deptype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>deptype</structfield> <type>char</type> + </para> + <para> A code defining the specific semantics of this dependency relationship; see text - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -6127,37 +6856,46 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_shdescription</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>objoid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the object this description pertains to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objoid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the object this description pertains to + </para></entry> </row> <row> - <entry><structfield>classoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog this object appears in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog this object appears in + </para></entry> </row> <row> - <entry><structfield>description</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Arbitrary text that serves as the description of this object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>description</structfield> <type>text</type> + </para> + <para> + Arbitrary text that serves as the description of this object + </para></entry> </row> </tbody> </tgroup> @@ -6194,39 +6932,55 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_shseclabel</structname> Columns</title> - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>objoid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the object this security label pertains to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objoid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the object this security label pertains to + </para></entry> </row> + <row> - <entry><structfield>classoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog this object appears in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog this object appears in + </para></entry> </row> + <row> - <entry><structfield>provider</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The label provider associated with this label.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>provider</structfield> <type>text</type> + </para> + <para> + The label provider associated with this label. + </para></entry> </row> + <row> - <entry><structfield>label</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The security label applied to this object.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>label</structfield> <type>text</type> + </para> + <para> + The security label applied to this object. + </para></entry> </row> </tbody> </tgroup> @@ -6297,126 +7051,142 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_statistic</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>starelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table or index that the described column belongs to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>starelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table or index that the described column belongs to + </para></entry> </row> <row> - <entry><structfield>staattnum</structfield></entry> - <entry><type>int2</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry>The number of the described column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>staattnum</structfield> <type>int2</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> + The number of the described column + </para></entry> </row> <row> - <entry><structfield>stainherit</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, the stats include inheritance child columns, not just the - values in the specified relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stainherit</structfield> <type>bool</type> + </para> + <para> + If true, the stats include inheritance child columns, not just the + values in the specified relation + </para></entry> </row> <row> - <entry><structfield>stanullfrac</structfield></entry> - <entry><type>float4</type></entry> - <entry></entry> - <entry>The fraction of the column's entries that are null</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stanullfrac</structfield> <type>float4</type> + </para> + <para> + The fraction of the column's entries that are null + </para></entry> </row> <row> - <entry><structfield>stawidth</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry>The average stored width, in bytes, of nonnull entries</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stawidth</structfield> <type>int4</type> + </para> + <para> + The average stored width, in bytes, of nonnull entries + </para></entry> </row> <row> - <entry><structfield>stadistinct</structfield></entry> - <entry><type>float4</type></entry> - <entry></entry> - <entry>The number of distinct nonnull data values in the column. - A value greater than zero is the actual number of distinct values. - A value less than zero is the negative of a multiplier for the number - of rows in the table; for example, a column in which about 80% of the - values are nonnull and each nonnull value appears about twice on - average could be represented by <structfield>stadistinct</structfield> = -0.4. - A zero value means the number of distinct values is unknown. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stadistinct</structfield> <type>float4</type> + </para> + <para> + The number of distinct nonnull data values in the column. + A value greater than zero is the actual number of distinct values. + A value less than zero is the negative of a multiplier for the number + of rows in the table; for example, a column in which about 80% of the + values are nonnull and each nonnull value appears about twice on + average could be represented by <structfield>stadistinct</structfield> = -0.4. + A zero value means the number of distinct values is unknown. + </para></entry> </row> <row> - <entry><structfield>stakind<replaceable>N</replaceable></structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stakind<replaceable>N</replaceable></structfield> <type>int2</type> + </para> + <para> A code number indicating the kind of statistics stored in the <replaceable>N</replaceable>th <quote>slot</quote> of the <structname>pg_statistic</structname> row. - </entry> + </para></entry> </row> <row> - <entry><structfield>staop<replaceable>N</replaceable></structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>staop<replaceable>N</replaceable></structfield> <type>oid</type> + (references <link linkend="catalog-pg-operator"><structname>pg_operator</structname></link>.<structfield>oid</structfield>) + </para> + <para> An operator used to derive the statistics stored in the <replaceable>N</replaceable>th <quote>slot</quote>. For example, a histogram slot would show the <literal><</literal> operator that defines the sort order of the data. - </entry> + </para></entry> </row> <row> - <entry><structfield>stacoll<replaceable>N</replaceable></structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stacoll<replaceable>N</replaceable></structfield> <type>oid</type> + (references <link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.<structfield>oid</structfield>) + </para> + <para> The collation used to derive the statistics stored in the <replaceable>N</replaceable>th <quote>slot</quote>. For example, a histogram slot for a collatable column would show the collation that defines the sort order of the data. Zero for noncollatable data. - </entry> + </para></entry> </row> <row> - <entry><structfield>stanumbers<replaceable>N</replaceable></structfield></entry> - <entry><type>float4[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stanumbers<replaceable>N</replaceable></structfield> <type>float4[]</type> + </para> + <para> Numerical statistics of the appropriate kind for the <replaceable>N</replaceable>th <quote>slot</quote>, or null if the slot kind does not involve numerical values - </entry> + </para></entry> </row> <row> - <entry><structfield>stavalues<replaceable>N</replaceable></structfield></entry> - <entry><type>anyarray</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stavalues<replaceable>N</replaceable></structfield> <type>anyarray</type> + </para> + <para> Column data values of the appropriate kind for the <replaceable>N</replaceable>th <quote>slot</quote>, or null if the slot kind does not store any data values. Each array's element values are actually of the specific column's data type, or a related type such as an array's element type, so there is no way to define these columns' type more specifically than <type>anyarray</type>. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -6440,61 +7210,72 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_statistic_ext</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> - <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>stxrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>Table containing the columns described by this object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Table containing the columns described by this object + </para></entry> </row> <row> - <entry><structfield>stxname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the statistics object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxname</structfield> <type>name</type> + </para> + <para> + Name of the statistics object + </para></entry> </row> <row> - <entry><structfield>stxnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this statistics object - </entry> + </para></entry> </row> <row> - <entry><structfield>stxowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the statistics object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the statistics object + </para></entry> </row> <row> - <entry><structfield>stxstattarget</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxstattarget</structfield> <type>int4</type> + </para> + <para> <structfield>stxstattarget</structfield> controls the level of detail of statistics accumulated for this statistics object by <xref linkend="sql-analyze"/>. @@ -6503,34 +7284,34 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l Positive values of <structfield>stxstattarget</structfield> determine the target number of <quote>most common values</quote> to collect. - </entry> + </para></entry> </row> <row> - <entry><structfield>stxkeys</structfield></entry> - <entry><type>int2vector</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxkeys</structfield> <type>int2vector</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> An array of attribute numbers, indicating which table columns are covered by this statistics object; for example a value of <literal>1 3</literal> would mean that the first and the third table columns are covered - </entry> + </para></entry> </row> <row> - <entry><structfield>stxkind</structfield></entry> - <entry><type>char[]</type></entry> - <entry></entry> - <entry> - An array containing codes for the enabled statistic kinds; - valid values are: - <literal>d</literal> for n-distinct statistics, - <literal>f</literal> for functional dependency statistics, and - <literal>m</literal> for most common values (MCV) list statistics - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxkind</structfield> <type>char[]</type> + </para> + <para> + An array containing codes for the enabled statistic kinds; + valid values are: + <literal>d</literal> for n-distinct statistics, + <literal>f</literal> for functional dependency statistics, and + <literal>m</literal> for most common values (MCV) list statistics + </para></entry> </row> - </tbody> </tgroup> </table> @@ -6576,55 +7357,57 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_statistic_ext_data</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> - <row> - <entry><structfield>stxoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.oid</literal></entry> - <entry>Extended statistic object containing the definition for this data</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Extended statistic object containing the definition for this data + </para></entry> </row> <row> - <entry><structfield>stxdndistinct</structfield></entry> - <entry><type>pg_ndistinct</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxdndistinct</structfield> <type>pg_ndistinct</type> + </para> + <para> N-distinct counts, serialized as <structname>pg_ndistinct</structname> type - </entry> + </para></entry> </row> <row> - <entry><structfield>stxddependencies</structfield></entry> - <entry><type>pg_dependencies</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxddependencies</structfield> <type>pg_dependencies</type> + </para> + <para> Functional dependency statistics, serialized as <structname>pg_dependencies</structname> type - </entry> + </para></entry> </row> <row> - <entry><structfield>stxdmcv</structfield></entry> - <entry><type>pg_mcv_list</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stxdmcv</structfield> <type>pg_mcv_list</type> + </para> + <para> MCV (most-common values) list statistics, serialized as <structname>pg_mcv_list</structname> type - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -6658,86 +7441,104 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_subscription</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>subdbid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.oid</literal></entry> - <entry>OID of the database which the subscription resides in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subdbid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the database which the subscription resides in + </para></entry> </row> <row> - <entry><structfield>subname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the subscription</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subname</structfield> <type>name</type> + </para> + <para> + Name of the subscription + </para></entry> </row> <row> - <entry><structfield>subowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the subscription</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the subscription + </para></entry> </row> <row> - <entry><structfield>subenabled</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, the subscription is enabled and should be replicating.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subenabled</structfield> <type>bool</type> + </para> + <para> + If true, the subscription is enabled and should be replicating. + </para></entry> </row> <row> - <entry><structfield>subconninfo</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Connection string to the upstream database</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subconninfo</structfield> <type>text</type> + </para> + <para> + Connection string to the upstream database + </para></entry> </row> <row> - <entry><structfield>subslotname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the replication slot in the upstream database. Also used - for local replication origin name.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subslotname</structfield> <type>name</type> + </para> + <para> + Name of the replication slot in the upstream database. Also used + for local replication origin name. + </para></entry> </row> <row> - <entry><structfield>subsynccommit</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subsynccommit</structfield> <type>text</type> + </para> + <para> Contains the value of the <varname>synchronous_commit</varname> setting for the subscription workers. - </entry> + </para></entry> </row> <row> - <entry><structfield>subpublications</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry>Array of subscribed publication names. These reference the + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subpublications</structfield> <type>text[]</type> + </para> + <para> + Array of subscribed publication names. These reference the publications on the publisher server. For more on publications see <xref linkend="logical-replication-publication"/>. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -6765,52 +7566,59 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_subscription_rel</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>srsubid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-subscription"><structname>pg_subscription</structname></link>.oid</literal></entry> - <entry>Reference to subscription</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srsubid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-subscription"><structname>pg_subscription</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Reference to subscription + </para></entry> </row> <row> - <entry><structfield>srrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>Reference to relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Reference to relation + </para></entry> </row> <row> - <entry><structfield>srsubstate</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srsubstate</structfield> <type>char</type> + </para> + <para> State code: <literal>i</literal> = initialize, <literal>d</literal> = data is being copied, <literal>s</literal> = synchronized, <literal>r</literal> = ready (normal replication) - </entry> + </para></entry> </row> <row> - <entry><structfield>srsublsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srsublsn</structfield> <type>pg_lsn</type> + </para> + <para> End LSN for <literal>s</literal> and <literal>r</literal> states. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -6839,55 +7647,63 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_tablespace</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>spcname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Tablespace name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spcname</structfield> <type>name</type> + </para> + <para> + Tablespace name + </para></entry> </row> <row> - <entry><structfield>spcowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the tablespace, usually the user who created it</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spcowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the tablespace, usually the user who created it + </para></entry> </row> <row> - <entry><structfield>spcacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spcacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> <row> - <entry><structfield>spcoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spcoptions</structfield> <type>text[]</type> + </para> + <para> Tablespace-level options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -6910,59 +7726,70 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_transform</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>trftype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>OID of the data type this transform is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trftype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the data type this transform is for + </para></entry> </row> <row> - <entry><structfield>trflang</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-language"><structname>pg_language</structname></link>.oid</literal></entry> - <entry>OID of the language this transform is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trflang</structfield> <type>oid</type> + (references <link linkend="catalog-pg-language"><structname>pg_language</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the language this transform is for + </para></entry> </row> <row> - <entry><structfield>trffromsql</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trffromsql</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the function to use when converting the data type for input to the procedural language (e.g., function parameters). Zero is stored if this operation is not supported. - </entry> + </para></entry> </row> <row> - <entry><structfield>trftosql</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trftosql</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the function to use when converting output from the procedural language (e.g., return values) to the data type. Zero is stored if this operation is not supported. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -6986,167 +7813,209 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_trigger</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>tgrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table this trigger is on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table this trigger is on + </para></entry> </row> <row> - <entry><structfield>tgparentid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-trigger"><structname>pg_trigger</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgparentid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-trigger"><structname>pg_trigger</structname></link>.<structfield>oid</structfield>) + </para> + <para> Parent trigger that this trigger is cloned from, zero if not a clone; this happens when partitions are created or attached to a partitioned table. - </entry> + </para></entry> </row> <row> - <entry><structfield>tgname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Trigger name (must be unique among triggers of same table)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgname</structfield> <type>name</type> + </para> + <para> + Trigger name (must be unique among triggers of same table) + </para></entry> </row> <row> - <entry><structfield>tgfoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>The function to be called</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgfoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The function to be called + </para></entry> </row> <row> - <entry><structfield>tgtype</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Bit mask identifying trigger firing conditions</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgtype</structfield> <type>int2</type> + </para> + <para> + Bit mask identifying trigger firing conditions + </para></entry> </row> <row> - <entry><structfield>tgenabled</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgenabled</structfield> <type>char</type> + </para> + <para> Controls in which <xref linkend="guc-session-replication-role"/> modes the trigger fires. <literal>O</literal> = trigger fires in <quote>origin</quote> and <quote>local</quote> modes, <literal>D</literal> = trigger is disabled, <literal>R</literal> = trigger fires in <quote>replica</quote> mode, <literal>A</literal> = trigger fires always. - </entry> + </para></entry> </row> <row> - <entry><structfield>tgisinternal</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if trigger is internally generated (usually, to enforce - the constraint identified by <structfield>tgconstraint</structfield>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgisinternal</structfield> <type>bool</type> + </para> + <para> + True if trigger is internally generated (usually, to enforce + the constraint identified by <structfield>tgconstraint</structfield>) + </para></entry> </row> <row> - <entry><structfield>tgconstrrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The table referenced by a referential integrity constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgconstrrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The table referenced by a referential integrity constraint + </para></entry> </row> <row> - <entry><structfield>tgconstrindid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The index supporting a unique, primary key, referential integrity, - or exclusion constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgconstrindid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The index supporting a unique, primary key, referential integrity, + or exclusion constraint + </para></entry> </row> <row> - <entry><structfield>tgconstraint</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link>.oid</literal></entry> - <entry>The <structname>pg_constraint</structname> entry associated with the trigger, if any</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgconstraint</structfield> <type>oid</type> + (references <link linkend="catalog-pg-constraint"><structname>pg_constraint</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The <structname>pg_constraint</structname> entry associated with the trigger, if any + </para></entry> </row> <row> - <entry><structfield>tgdeferrable</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if constraint trigger is deferrable</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgdeferrable</structfield> <type>bool</type> + </para> + <para> + True if constraint trigger is deferrable + </para></entry> </row> <row> - <entry><structfield>tginitdeferred</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>True if constraint trigger is initially deferred</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tginitdeferred</structfield> <type>bool</type> + </para> + <para> + True if constraint trigger is initially deferred + </para></entry> </row> <row> - <entry><structfield>tgnargs</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry>Number of argument strings passed to trigger function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgnargs</structfield> <type>int2</type> + </para> + <para> + Number of argument strings passed to trigger function + </para></entry> </row> <row> - <entry><structfield>tgattr</structfield></entry> - <entry><type>int2vector</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attnum</literal></entry> - <entry>Column numbers, if trigger is column-specific; otherwise an - empty array</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgattr</structfield> <type>int2vector</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attnum</structfield>) + </para> + <para> + Column numbers, if trigger is column-specific; otherwise an + empty array + </para></entry> </row> <row> - <entry><structfield>tgargs</structfield></entry> - <entry><type>bytea</type></entry> - <entry></entry> - <entry>Argument strings to pass to trigger, each NULL-terminated</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgargs</structfield> <type>bytea</type> + </para> + <para> + Argument strings to pass to trigger, each NULL-terminated + </para></entry> </row> <row> - <entry><structfield>tgqual</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry>Expression tree (in <function>nodeToString()</function> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgqual</structfield> <type>pg_node_tree</type> + </para> + <para> + Expression tree (in <function>nodeToString()</function> representation) for the trigger's <literal>WHEN</literal> condition, or null - if none</entry> + if none + </para></entry> </row> <row> - <entry><structfield>tgoldtable</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry><literal>REFERENCING</literal> clause name for <literal>OLD TABLE</literal>, - or null if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgoldtable</structfield> <type>name</type> + </para> + <para> + <literal>REFERENCING</literal> clause name for <literal>OLD TABLE</literal>, + or null if none + </para></entry> </row> <row> - <entry><structfield>tgnewtable</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry><literal>REFERENCING</literal> clause name for <literal>NEW TABLE</literal>, - or null if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tgnewtable</structfield> <type>name</type> + </para> + <para> + <literal>REFERENCING</literal> clause name for <literal>NEW TABLE</literal>, + or null if none + </para></entry> </row> </tbody> </tgroup> @@ -7206,53 +8075,65 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_ts_config</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>cfgname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Text search configuration name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cfgname</structfield> <type>name</type> + </para> + <para> + Text search configuration name + </para></entry> </row> <row> - <entry><structfield>cfgnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cfgnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this configuration - </entry> + </para></entry> </row> <row> - <entry><structfield>cfgowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the configuration</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cfgowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the configuration + </para></entry> </row> <row> - <entry><structfield>cfgparser</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-ts-parser"><structname>pg_ts_parser</structname></link>.oid</literal></entry> - <entry>The OID of the text search parser for this configuration</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cfgparser</structfield> <type>oid</type> + (references <link linkend="catalog-pg-ts-parser"><structname>pg_ts_parser</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the text search parser for this configuration + </para></entry> </row> </tbody> </tgroup> @@ -7281,45 +8162,56 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_ts_config_map</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>mapcfg</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-ts-config"><structname>pg_ts_config</structname></link>.oid</literal></entry> - <entry>The OID of the <structname>pg_ts_config</structname> entry owning this map entry</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>mapcfg</structfield> <type>oid</type> + (references <link linkend="catalog-pg-ts-config"><structname>pg_ts_config</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the <structname>pg_ts_config</structname> entry owning this map entry + </para></entry> </row> <row> - <entry><structfield>maptokentype</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry>A token type emitted by the configuration's parser</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maptokentype</structfield> <type>int4</type> + </para> + <para> + A token type emitted by the configuration's parser + </para></entry> </row> <row> - <entry><structfield>mapseqno</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry>Order in which to consult this entry (lower - <structfield>mapseqno</structfield>s first)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>mapseqno</structfield> <type>int4</type> + </para> + <para> + Order in which to consult this entry (lower + <structfield>mapseqno</structfield>s first) + </para></entry> </row> <row> - <entry><structfield>mapdict</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-ts-dict"><structname>pg_ts_dict</structname></link>.oid</literal></entry> - <entry>The OID of the text search dictionary to consult</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>mapdict</structfield> <type>oid</type> + (references <link linkend="catalog-pg-ts-dict"><structname>pg_ts_dict</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the text search dictionary to consult + </para></entry> </row> </tbody> </tgroup> @@ -7352,60 +8244,74 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_ts_dict</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>dictname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Text search dictionary name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dictname</structfield> <type>name</type> + </para> + <para> + Text search dictionary name + </para></entry> </row> <row> - <entry><structfield>dictnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dictnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this dictionary - </entry> + </para></entry> </row> <row> - <entry><structfield>dictowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the dictionary</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dictowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the dictionary + </para></entry> </row> <row> - <entry><structfield>dicttemplate</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-ts-template"><structname>pg_ts_template</structname></link>.oid</literal></entry> - <entry>The OID of the text search template for this dictionary</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dicttemplate</structfield> <type>oid</type> + (references <link linkend="catalog-pg-ts-template"><structname>pg_ts_template</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the text search template for this dictionary + </para></entry> </row> <row> - <entry><structfield>dictinitoption</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Initialization option string for the template</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dictinitoption</structfield> <type>text</type> + </para> + <para> + Initialization option string for the template + </para></entry> </row> </tbody> </tgroup> @@ -7435,74 +8341,95 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_ts_parser</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>prsname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Text search parser name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prsname</structfield> <type>name</type> + </para> + <para> + Text search parser name + </para></entry> </row> <row> - <entry><structfield>prsnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prsnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this parser - </entry> + </para></entry> </row> <row> - <entry><structfield>prsstart</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the parser's startup function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prsstart</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the parser's startup function + </para></entry> </row> <row> - <entry><structfield>prstoken</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the parser's next-token function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prstoken</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the parser's next-token function + </para></entry> </row> <row> - <entry><structfield>prsend</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the parser's shutdown function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prsend</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the parser's shutdown function + </para></entry> </row> <row> - <entry><structfield>prsheadline</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the parser's headline function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prsheadline</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the parser's headline function + </para></entry> </row> <row> - <entry><structfield>prslextype</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the parser's lextype function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prslextype</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the parser's lextype function + </para></entry> </row> </tbody> </tgroup> @@ -7532,53 +8459,65 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_ts_template</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>tmplname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Text search template name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tmplname</structfield> <type>name</type> + </para> + <para> + Text search template name + </para></entry> </row> <row> - <entry><structfield>tmplnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tmplnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this template - </entry> + </para></entry> </row> <row> - <entry><structfield>tmplinit</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the template's initialization function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tmplinit</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the template's initialization function + </para></entry> </row> <row> - <entry><structfield>tmpllexize</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>OID of the template's lexize function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tmpllexize</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the template's lexize function + </para></entry> </row> </tbody> </tgroup> @@ -7606,66 +8545,75 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_type</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>typname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Data type name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typname</structfield> <type>name</type> + </para> + <para> + Data type name + </para></entry> </row> <row> - <entry><structfield>typnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace that contains this type - </entry> + </para></entry> </row> <row> - <entry><structfield>typowner</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>Owner of the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typowner</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Owner of the type + </para></entry> </row> <row> - <entry><structfield>typlen</structfield></entry> - <entry><type>int2</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typlen</structfield> <type>int2</type> + </para> + <para> For a fixed-size type, <structfield>typlen</structfield> is the number of bytes in the internal representation of the type. But for a variable-length type, <structfield>typlen</structfield> is negative. -1 indicates a <quote>varlena</quote> type (one that has a length word), -2 indicates a null-terminated C string. - </entry> + </para></entry> </row> <row> - <entry><structfield>typbyval</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typbyval</structfield> <type>bool</type> + </para> + <para> <structfield>typbyval</structfield> determines whether internal routines pass a value of this type by value or by reference. <structfield>typbyval</structfield> had better be false if @@ -7674,14 +8622,14 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l Variable-length types are always passed by reference. Note that <structfield>typbyval</structfield> can be false even if the length would allow pass-by-value. - </entry> + </para></entry> </row> <row> - <entry><structfield>typtype</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typtype</structfield> <type>char</type> + </para> + <para> <structfield>typtype</structfield> is <literal>b</literal> for a base type, <literal>c</literal> for a composite type (e.g., a table's row type), @@ -7691,59 +8639,60 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <literal>r</literal> for a range type. See also <structfield>typrelid</structfield> and <structfield>typbasetype</structfield>. - </entry> + </para></entry> </row> <row> - <entry><structfield>typcategory</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typcategory</structfield> <type>char</type> + </para> + <para> <structfield>typcategory</structfield> is an arbitrary classification of data types that is used by the parser to determine which implicit casts should be <quote>preferred</quote>. See <xref linkend="catalog-typcategory-table"/>. - </entry> + </para></entry> </row> <row> - <entry><structfield>typispreferred</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typispreferred</structfield> <type>bool</type> + </para> + <para> True if the type is a preferred cast target within its <structfield>typcategory</structfield> - </entry> + </para></entry> </row> <row> - <entry><structfield>typisdefined</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typisdefined</structfield> <type>bool</type> + </para> + <para> True if the type is defined, false if this is a placeholder entry for a not-yet-defined type. When <structfield>typisdefined</structfield> is false, nothing except the type name, namespace, and OID can be relied on. - </entry> + </para></entry> </row> <row> - <entry><structfield>typdelim</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typdelim</structfield> <type>char</type> + </para> + <para> Character that separates two values of this type when parsing array input. Note that the delimiter is associated with the array element data type, not the array data type. - </entry> + </para></entry> </row> <row> - <entry><structfield>typrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typrelid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> If this is a composite type (see <structfield>typtype</structfield>), then this column points to the <structname>pg_class</structname> entry that defines the @@ -7752,14 +8701,15 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l a table, but it is needed anyway for the type's <structname>pg_attribute</structname> entries to link to.) Zero for non-composite types. - </entry> + </para></entry> </row> <row> - <entry><structfield>typelem</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typelem</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> If <structfield>typelem</structfield> is not 0 then it identifies another row in <structname>pg_type</structname>. The current type can then be subscripted like an array yielding @@ -7774,75 +8724,96 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <structfield>typelem</structfield> data type with no other data. Variable-length array types have a header defined by the array subroutines. - </entry> + </para></entry> </row> <row> - <entry><structfield>typarray</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typarray</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> If <structfield>typarray</structfield> is not 0 then it identifies another row in <structname>pg_type</structname>, which is the <quote>true</quote> array type having this type as element - </entry> + </para></entry> </row> <row> - <entry><structfield>typinput</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Input conversion function (text format)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typinput</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Input conversion function (text format) + </para></entry> </row> <row> - <entry><structfield>typoutput</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Output conversion function (text format)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typoutput</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Output conversion function (text format) + </para></entry> </row> <row> - <entry><structfield>typreceive</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Input conversion function (binary format), or 0 if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typreceive</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Input conversion function (binary format), or 0 if none + </para></entry> </row> <row> - <entry><structfield>typsend</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Output conversion function (binary format), or 0 if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typsend</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Output conversion function (binary format), or 0 if none + </para></entry> </row> <row> - <entry><structfield>typmodin</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Type modifier input function, or 0 if type does not support modifiers</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typmodin</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Type modifier input function, or 0 if type does not support modifiers + </para></entry> </row> <row> - <entry><structfield>typmodout</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Type modifier output function, or 0 to use the standard format</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typmodout</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Type modifier output function, or 0 to use the standard format + </para></entry> </row> <row> - <entry><structfield>typanalyze</structfield></entry> - <entry><type>regproc</type></entry> - <entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry> - <entry>Custom <command>ANALYZE</command> function, or 0 to use the standard function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typanalyze</structfield> <type>regproc</type> + (references <link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Custom <command>ANALYZE</command> function, or 0 to use the standard function + </para></entry> </row> <row> - <entry><structfield>typalign</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry><para> - + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typalign</structfield> <type>char</type> + </para> + <para> <structfield>typalign</structfield> is the alignment required when storing a value of this type. It applies to storage on disk as well as most representations of the value inside @@ -7852,9 +8823,6 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l inserted before a datum of this type so that it begins on the specified boundary. The alignment reference is the beginning of the first datum in the sequence. - </para> - - <para> Possible values are: <itemizedlist> <listitem> @@ -7870,21 +8838,14 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <para><literal>d</literal> = <type>double</type> alignment (8 bytes on many machines, but by no means all).</para> </listitem> </itemizedlist> - </para><note> - <para> - For types used in system tables, it is critical that the size - and alignment defined in <structname>pg_type</structname> - agree with the way that the compiler will lay out the column in - a structure representing a table row. - </para> - </note></entry> + </para></entry> </row> <row> - <entry><structfield>typstorage</structfield></entry> - <entry><type>char</type></entry> - <entry></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typstorage</structfield> <type>char</type> + </para> + <para> <structfield>typstorage</structfield> tells for varlena types (those with <structfield>typlen</structfield> = -1) if the type is prepared for toasting and what the default strategy @@ -7925,20 +8886,21 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </row> <row> - <entry><structfield>typnotnull</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typnotnull</structfield> <type>bool</type> + </para> + <para> <structfield>typnotnull</structfield> represents a not-null constraint on a type. Used for domains only. </para></entry> </row> <row> - <entry><structfield>typbasetype</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typbasetype</structfield> <type>oid</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> If this is a domain (see <structfield>typtype</structfield>), then <structfield>typbasetype</structfield> identifies the type that this one is based on. Zero if this type is not a domain. @@ -7946,10 +8908,10 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </row> <row> - <entry><structfield>typtypmod</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typtypmod</structfield> <type>int4</type> + </para> + <para> Domains use <structfield>typtypmod</structfield> to record the <literal>typmod</literal> to be applied to their base type (-1 if base type does not use a <literal>typmod</literal>). -1 if this type is not a domain. @@ -7957,22 +8919,23 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </row> <row> - <entry><structfield>typndims</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typndims</structfield> <type>int4</type> + </para> + <para> <structfield>typndims</structfield> is the number of array dimensions for a domain over an array (that is, <structfield>typbasetype</structfield> is an array type). Zero for types other than domains over array types. - </para></entry> + </para></entry> </row> <row> - <entry><structfield>typcollation</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.oid</literal></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typcollation</structfield> <type>oid</type> + (references <link linkend="catalog-pg-collation"><structname>pg_collation</structname></link>.<structfield>oid</structfield>) + </para> + <para> <structfield>typcollation</structfield> specifies the collation of the type. If the type does not support collations, this will be zero. A base type that supports collations will have a nonzero @@ -7983,10 +8946,10 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </row> <row> - <entry><structfield>typdefaultbin</structfield></entry> - <entry><type>pg_node_tree</type></entry> - <entry></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typdefaultbin</structfield> <type>pg_node_tree</type> + </para> + <para> If <structfield>typdefaultbin</structfield> is not null, it is the <function>nodeToString()</function> representation of a default expression for the type. This is @@ -7995,10 +8958,10 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </row> <row> - <entry><structfield>typdefault</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry><para> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typdefault</structfield> <type>text</type> + </para> + <para> <structfield>typdefault</structfield> is null if the type has no associated default value. If <structfield>typdefaultbin</structfield> is not null, <structfield>typdefault</structfield> must contain a human-readable version of the @@ -8011,17 +8974,26 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l </row> <row> - <entry><structfield>typacl</structfield></entry> - <entry><type>aclitem[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>typacl</structfield> <type>aclitem[]</type> + </para> + <para> Access privileges; see <xref linkend="ddl-priv"/> for details - </entry> + </para></entry> </row> </tbody> </tgroup> </table> + <note> + <para> + For fixed-width types used in system tables, it is critical that the size + and alignment defined in <structname>pg_type</structname> + agree with the way that the compiler will lay out the column in + a structure representing a table row. + </para> + </note> + <para> <xref linkend="catalog-typcategory-table"/> lists the system-defined values of <structfield>typcategory</structfield>. Any future additions to this list will @@ -8125,48 +9097,55 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_user_mapping</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry></entry> - <entry>Row identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + </para> + <para> + Row identifier + </para></entry> </row> <row> - <entry><structfield>umuser</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>OID of the local role being mapped, 0 if the user mapping is public</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>umuser</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the local role being mapped, 0 if the user mapping is public + </para></entry> </row> <row> - <entry><structfield>umserver</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>umserver</structfield> <type>oid</type> + (references <link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the foreign server that contains this mapping - </entry> + </para></entry> </row> <row> - <entry><structfield>umoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>umoptions</structfield> <type>text[]</type> + </para> + <para> User mapping specific options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -8394,41 +9373,55 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_available_extensions</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>name</type></entry> - <entry>Extension name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>name</type> + </para> + <para> + Extension name + </para></entry> </row> <row> - <entry><structfield>default_version</structfield></entry> - <entry><type>text</type></entry> - <entry>Name of default version, or <literal>NULL</literal> if none is - specified</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_version</structfield> <type>text</type> + </para> + <para> + Name of default version, or <literal>NULL</literal> if none is + specified + </para></entry> </row> <row> - <entry><structfield>installed_version</structfield></entry> - <entry><type>text</type></entry> - <entry>Currently installed version of the extension, - or <literal>NULL</literal> if not installed</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>installed_version</structfield> <type>text</type> + </para> + <para> + Currently installed version of the extension, + or <literal>NULL</literal> if not installed + </para></entry> </row> <row> - <entry><structfield>comment</structfield></entry> - <entry><type>text</type></entry> - <entry>Comment string from the extension's control file</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>comment</structfield> <type>text</type> + </para> + <para> + Comment string from the extension's control file + </para></entry> </row> </tbody> </tgroup> @@ -8456,74 +9449,103 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_available_extension_versions</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>name</type></entry> - <entry>Extension name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>name</type> + </para> + <para> + Extension name + </para></entry> </row> <row> - <entry><structfield>version</structfield></entry> - <entry><type>text</type></entry> - <entry>Version name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>version</structfield> <type>text</type> + </para> + <para> + Version name + </para></entry> </row> <row> - <entry><structfield>installed</structfield></entry> - <entry><type>bool</type></entry> - <entry>True if this version of this extension is currently - installed</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>installed</structfield> <type>bool</type> + </para> + <para> + True if this version of this extension is currently + installed + </para></entry> </row> <row> - <entry><structfield>superuser</structfield></entry> - <entry><type>bool</type></entry> - <entry>True if only superusers are allowed to install this extension - (but see <structfield>trusted</structfield>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>superuser</structfield> <type>bool</type> + </para> + <para> + True if only superusers are allowed to install this extension + (but see <structfield>trusted</structfield>) + </para></entry> </row> <row> - <entry><structfield>trusted</structfield></entry> - <entry><type>bool</type></entry> - <entry>True if the extension can be installed by non-superusers - with appropriate privileges</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trusted</structfield> <type>bool</type> + </para> + <para> + True if the extension can be installed by non-superusers + with appropriate privileges + </para></entry> </row> <row> - <entry><structfield>relocatable</structfield></entry> - <entry><type>bool</type></entry> - <entry>True if extension can be relocated to another schema</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relocatable</structfield> <type>bool</type> + </para> + <para> + True if extension can be relocated to another schema + </para></entry> </row> <row> - <entry><structfield>schema</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema that the extension must be installed into, - or <literal>NULL</literal> if partially or fully relocatable</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schema</structfield> <type>name</type> + </para> + <para> + Name of the schema that the extension must be installed into, + or <literal>NULL</literal> if partially or fully relocatable + </para></entry> </row> <row> - <entry><structfield>requires</structfield></entry> - <entry><type>name[]</type></entry> - <entry>Names of prerequisite extensions, - or <literal>NULL</literal> if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>requires</structfield> <type>name[]</type> + </para> + <para> + Names of prerequisite extensions, + or <literal>NULL</literal> if none + </para></entry> </row> <row> - <entry><structfield>comment</structfield></entry> - <entry><type>text</type></entry> - <entry>Comment string from the extension's control file</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>comment</structfield> <type>text</type> + </para> + <para> + Comment string from the extension's control file + </para></entry> </row> </tbody> </tgroup> @@ -8560,26 +9582,35 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_config</structname> Columns</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry>The parameter name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + The parameter name + </para></entry> </row> <row> - <entry><structfield>setting</structfield></entry> - <entry><type>text</type></entry> - <entry>The parameter value</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>setting</structfield> <type>text</type> + </para> + <para> + The parameter value + </para></entry> </row> </tbody> </tgroup> @@ -8639,63 +9670,77 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_cursors</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry>The name of the cursor</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + The name of the cursor + </para></entry> </row> <row> - <entry><structfield>statement</structfield></entry> - <entry><type>text</type></entry> - <entry>The verbatim query string submitted to declare this cursor</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>statement</structfield> <type>text</type> + </para> + <para> + The verbatim query string submitted to declare this cursor + </para></entry> </row> <row> - <entry><structfield>is_holdable</structfield></entry> - <entry><type>boolean</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_holdable</structfield> <type>bool</type> + </para> + <para> <literal>true</literal> if the cursor is holdable (that is, it can be accessed after the transaction that declared the cursor has committed); <literal>false</literal> otherwise - </entry> + </para></entry> </row> <row> - <entry><structfield>is_binary</structfield></entry> - <entry><type>boolean</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_binary</structfield> <type>bool</type> + </para> + <para> <literal>true</literal> if the cursor was declared <literal>BINARY</literal>; <literal>false</literal> otherwise - </entry> + </para></entry> </row> <row> - <entry><structfield>is_scrollable</structfield></entry> - <entry><type>boolean</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_scrollable</structfield> <type>bool</type> + </para> + <para> <literal>true</literal> if the cursor is scrollable (that is, it allows rows to be retrieved in a nonsequential manner); <literal>false</literal> otherwise - </entry> + </para></entry> </row> <row> - <entry><structfield>creation_time</structfield></entry> - <entry><type>timestamptz</type></entry> - <entry>The time at which the cursor was declared</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>creation_time</structfield> <type>timestamptz</type> + </para> + <para> + The time at which the cursor was declared + </para></entry> </row> </tbody> </tgroup> @@ -8739,56 +9784,84 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_file_settings</structname> Columns</title> + <tgroup cols="1"> + <thead> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> + </row> + </thead> + + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sourcefile</structfield> <type>text</type> + </para> + <para> + Full path name of the configuration file + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sourceline</structfield> <type>int4</type> + </para> + <para> + Line number within the configuration file where the entry appears + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seqno</structfield> <type>int4</type> + </para> + <para> + Order in which the entries are processed (1..<replaceable>n</replaceable>) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + Configuration parameter name + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>setting</structfield> <type>text</type> + </para> + <para> + Value to be assigned to the parameter + </para></entry> + </row> - <tgroup cols="3"> - <thead> - <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><structfield>sourcefile</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry>Full path name of the configuration file</entry> - </row> - <row> - <entry><structfield>sourceline</structfield></entry> - <entry><structfield>integer</structfield></entry> - <entry> - Line number within the configuration file where the entry appears - </entry> - </row> - <row> - <entry><structfield>seqno</structfield></entry> - <entry><structfield>integer</structfield></entry> - <entry>Order in which the entries are processed (1..<replaceable>n</replaceable>)</entry> - </row> - <row> - <entry><structfield>name</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry>Configuration parameter name</entry> - </row> - <row> - <entry><structfield>setting</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry>Value to be assigned to the parameter</entry> - </row> - <row> - <entry><structfield>applied</structfield></entry> - <entry><structfield>boolean</structfield></entry> - <entry>True if the value can be applied successfully</entry> - </row> - <row> - <entry><structfield>error</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry>If not null, an error message indicating why this entry could - not be applied</entry> - </row> - </tbody> - </tgroup> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>applied</structfield> <type>bool</type> + </para> + <para> + True if the value can be applied successfully + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>error</structfield> <type>text</type> + </para> + <para> + If not null, an error message indicating why this entry could + not be applied + </para></entry> + </row> + </tbody> + </tgroup> </table> <para> @@ -8832,37 +9905,47 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_group</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>groname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>Name of the group</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>groname</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + Name of the group + </para></entry> </row> <row> - <entry><structfield>grosysid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>ID of this group</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grosysid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + ID of this group + </para></entry> </row> <row> - <entry><structfield>grolist</structfield></entry> - <entry><type>oid[]</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>An array containing the IDs of the roles in this group</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grolist</structfield> <type>oid[]</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + An array containing the IDs of the roles in this group + </para></entry> </row> </tbody> </tgroup> @@ -8899,72 +9982,104 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_hba_file_rules</structname> Columns</title> + <tgroup cols="1"> + <thead> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> + </row> + </thead> + + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>line_number</structfield> <type>int4</type> + </para> + <para> + Line number of this rule in <filename>pg_hba.conf</filename> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>type</structfield> <type>text</type> + </para> + <para> + Type of connection + </para></entry> + </row> - <tgroup cols="3"> - <thead> - <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><structfield>line_number</structfield></entry> - <entry><structfield>integer</structfield></entry> - <entry> - Line number of this rule in <filename>pg_hba.conf</filename> - </entry> - </row> - <row> - <entry><structfield>type</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry>Type of connection</entry> - </row> - <row> - <entry><structfield>database</structfield></entry> - <entry><structfield>text[]</structfield></entry> - <entry>List of database name(s) to which this rule applies</entry> - </row> - <row> - <entry><structfield>user_name</structfield></entry> - <entry><structfield>text[]</structfield></entry> - <entry>List of user and group name(s) to which this rule applies</entry> - </row> - <row> - <entry><structfield>address</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry> - Host name or IP address, or one - of <literal>all</literal>, <literal>samehost</literal>, - or <literal>samenet</literal>, or null for local connections - </entry> - </row> - <row> - <entry><structfield>netmask</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry>IP address mask, or null if not applicable</entry> - </row> - <row> - <entry><structfield>auth_method</structfield></entry> - <entry><type>text</type></entry> - <entry>Authentication method</entry> - </row> - <row> - <entry><structfield>options</structfield></entry> - <entry><type>text[]</type></entry> - <entry>Options specified for authentication method, if any</entry> - </row> - <row> - <entry><structfield>error</structfield></entry> - <entry><structfield>text</structfield></entry> - <entry> - If not null, an error message indicating why this - line could not be processed - </entry> - </row> - </tbody> - </tgroup> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>database</structfield> <type>text[]</type> + </para> + <para> + List of database name(s) to which this rule applies + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_name</structfield> <type>text[]</type> + </para> + <para> + List of user and group name(s) to which this rule applies + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>address</structfield> <type>text</type> + </para> + <para> + Host name or IP address, or one + of <literal>all</literal>, <literal>samehost</literal>, + or <literal>samenet</literal>, or null for local connections + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>netmask</structfield> <type>text</type> + </para> + <para> + IP address mask, or null if not applicable + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>auth_method</structfield> <type>text</type> + </para> + <para> + Authentication method + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>options</structfield> <type>text[]</type> + </para> + <para> + Options specified for authentication method, if any + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>error</structfield> <type>text</type> + </para> + <para> + If not null, an error message indicating why this + line could not be processed + </para></entry> + </row> + </tbody> + </tgroup> </table> <para> @@ -8992,47 +10107,67 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_indexes</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table and index</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table and index + </para></entry> </row> + <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table the index is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table the index is for + </para></entry> </row> + <row> - <entry><structfield>indexname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of index</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexname</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of index + </para></entry> </row> + <row> - <entry><structfield>tablespace</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.spcname</literal></entry> - <entry>Name of tablespace containing index (null if default for database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablespace</structfield> <type>name</type> + (references <link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.<structfield>spcname</structfield>) + </para> + <para> + Name of tablespace containing index (null if default for database) + </para></entry> </row> + <row> - <entry><structfield>indexdef</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Index definition (a reconstructed <command>CREATE INDEX</command> - command)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexdef</structfield> <type>text</type> + </para> + <para> + Index definition (a reconstructed <command>CREATE INDEX</command> + command) + </para></entry> </row> </tbody> </tgroup> @@ -9078,22 +10213,24 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <table> <title><structname>pg_locks</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>locktype</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>locktype</structfield> <type>text</type> + </para> + <para> Type of the lockable object: <literal>relation</literal>, <literal>extend</literal>, @@ -9104,129 +10241,152 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l <literal>object</literal>, <literal>userlock</literal>, or <literal>advisory</literal> - </entry> + </para></entry> </row> + <row> - <entry><structfield>database</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>database</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> OID of the database in which the lock target exists, or zero if the target is a shared object, or null if the target is a transaction ID - </entry> + </para></entry> </row> + <row> - <entry><structfield>relation</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relation</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> OID of the relation targeted by the lock, or null if the target is not a relation or part of a relation - </entry> + </para></entry> </row> + <row> - <entry><structfield>page</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>page</structfield> <type>int4</type> + </para> + <para> Page number targeted by the lock within the relation, or null if the target is not a relation page or tuple - </entry> + </para></entry> </row> + <row> - <entry><structfield>tuple</structfield></entry> - <entry><type>smallint</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tuple</structfield> <type>int2</type> + </para> + <para> Tuple number targeted by the lock within the page, or null if the target is not a tuple - </entry> + </para></entry> </row> + <row> - <entry><structfield>virtualxid</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>virtualxid</structfield> <type>text</type> + </para> + <para> Virtual ID of the transaction targeted by the lock, or null if the target is not a virtual transaction ID - </entry> + </para></entry> </row> + <row> - <entry><structfield>transactionid</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>transactionid</structfield> <type>xid</type> + </para> + <para> ID of the transaction targeted by the lock, or null if the target is not a transaction ID - </entry> + </para></entry> </row> + <row> - <entry><structfield>classid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> OID of the system catalog containing the lock target, or null if the target is not a general database object - </entry> + </para></entry> </row> + <row> - <entry><structfield>objid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> OID of the lock target within its system catalog, or null if the target is not a general database object - </entry> + </para></entry> </row> + <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>smallint</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int2</type> + </para> + <para> Column number targeted by the lock (the <structfield>classid</structfield> and <structfield>objid</structfield> refer to the table itself), or zero if the target is some other general database object, or null if the target is not a general database object - </entry> + </para></entry> </row> + <row> - <entry><structfield>virtualtransaction</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>virtualtransaction</structfield> <type>text</type> + </para> + <para> Virtual ID of the transaction that is holding or awaiting this lock - </entry> + </para></entry> </row> + <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>int4</type> + </para> + <para> Process ID of the server process holding or awaiting this lock, or null if the lock is held by a prepared transaction - </entry> + </para></entry> </row> + <row> - <entry><structfield>mode</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Name of the lock mode held or desired by this process (see <xref - linkend="locking-tables"/> and <xref linkend="xact-serializable"/>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>mode</structfield> <type>text</type> + </para> + <para> + Name of the lock mode held or desired by this process (see <xref linkend="locking-tables"/> and <xref linkend="xact-serializable"/>) + </para></entry> </row> + <row> - <entry><structfield>granted</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>True if lock is held, false if lock is awaited</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>granted</structfield> <type>bool</type> + </para> + <para> + True if lock is held, false if lock is awaited + </para></entry> </row> + <row> - <entry><structfield>fastpath</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>True if lock was taken via fast path, false if taken via main - lock table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>fastpath</structfield> <type>bool</type> + </para> + <para> + True if lock was taken via fast path, false if taken via main + lock table + </para></entry> </row> </tbody> </tgroup> @@ -9379,58 +10539,84 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_matviews</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing materialized view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing materialized view + </para></entry> </row> + <row> - <entry><structfield>matviewname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of materialized view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>matviewname</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of materialized view + </para></entry> </row> + <row> - <entry><structfield>matviewowner</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>Name of materialized view's owner</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>matviewowner</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + Name of materialized view's owner + </para></entry> </row> + <row> - <entry><structfield>tablespace</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.spcname</literal></entry> - <entry>Name of tablespace containing materialized view (null if default for database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablespace</structfield> <type>name</type> + (references <link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.<structfield>spcname</structfield>) + </para> + <para> + Name of tablespace containing materialized view (null if default for database) + </para></entry> </row> + <row> - <entry><structfield>hasindexes</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>True if materialized view has (or recently had) any indexes</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>hasindexes</structfield> <type>bool</type> + </para> + <para> + True if materialized view has (or recently had) any indexes + </para></entry> </row> + <row> - <entry><structfield>ispopulated</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>True if materialized view is currently populated</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ispopulated</structfield> <type>bool</type> + </para> + <para> + True if materialized view is currently populated + </para></entry> </row> + <row> - <entry><structfield>definition</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Materialized view definition (a reconstructed <command>SELECT</command> query)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>definition</structfield> <type>text</type> + </para> + <para> + Materialized view definition (a reconstructed <command>SELECT</command> query) + </para></entry> </row> </tbody> </tgroup> @@ -9452,66 +10638,94 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_policies</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table policy is on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table policy is on + </para></entry> </row> + <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table policy is on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table policy is on + </para></entry> </row> + <row> - <entry><structfield>policyname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-policy"><structname>pg_policy</structname></link>.polname</literal></entry> - <entry>Name of policy</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>policyname</structfield> <type>name</type> + (references <link linkend="catalog-pg-policy"><structname>pg_policy</structname></link>.<structfield>polname</structfield>) + </para> + <para> + Name of policy + </para></entry> </row> + <row> - <entry><structfield>permissive</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Is the policy permissive or restrictive?</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>permissive</structfield> <type>text</type> + </para> + <para> + Is the policy permissive or restrictive? + </para></entry> </row> + <row> - <entry><structfield>roles</structfield></entry> - <entry><type>name[]</type></entry> - <entry></entry> - <entry>The roles to which this policy applies</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>roles</structfield> <type>name[]</type> + </para> + <para> + The roles to which this policy applies + </para></entry> </row> + <row> - <entry><structfield>cmd</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The command type to which the policy is applied</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cmd</structfield> <type>text</type> + </para> + <para> + The command type to which the policy is applied + </para></entry> </row> + <row> - <entry><structfield>qual</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The expression added to the security barrier qualifications for - queries that this policy applies to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>qual</structfield> <type>text</type> + </para> + <para> + The expression added to the security barrier qualifications for + queries that this policy applies to + </para></entry> </row> + <row> - <entry><structfield>with_check</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The expression added to the WITH CHECK qualifications for - queries that attempt to add rows to this table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>with_check</structfield> <type>text</type> + </para> + <para> + The expression added to the WITH CHECK qualifications for + queries that attempt to add rows to this table + </para></entry> </row> </tbody> </tgroup> @@ -9542,61 +10756,73 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_prepared_statements</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> The identifier of the prepared statement - </entry> + </para></entry> </row> + <row> - <entry><structfield>statement</structfield></entry> - <entry><type>text</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>statement</structfield> <type>text</type> + </para> + <para> The query string submitted by the client to create this prepared statement. For prepared statements created via SQL, this is the <command>PREPARE</command> statement submitted by the client. For prepared statements created via the frontend/backend protocol, this is the text of the prepared statement itself. - </entry> + </para></entry> </row> + <row> - <entry><structfield>prepare_time</structfield></entry> - <entry><type>timestamptz</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prepare_time</structfield> <type>timestamptz</type> + </para> + <para> The time at which the prepared statement was created - </entry> + </para></entry> </row> + <row> - <entry><structfield>parameter_types</structfield></entry> - <entry><type>regtype[]</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>parameter_types</structfield> <type>regtype[]</type> + </para> + <para> The expected parameter types for the prepared statement in the form of an array of <type>regtype</type>. The OID corresponding to an element of this array can be obtained by casting the <type>regtype</type> value to <type>oid</type>. - </entry> + </para></entry> </row> + <row> - <entry><structfield>from_sql</structfield></entry> - <entry><type>boolean</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>from_sql</structfield> <type>bool</type> + </para> + <para> <literal>true</literal> if the prepared statement was created via the <command>PREPARE</command> SQL command; <literal>false</literal> if the statement was prepared via the frontend/backend protocol - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -9628,56 +10854,64 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_prepared_xacts</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>transaction</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>transaction</structfield> <type>xid</type> + </para> + <para> Numeric transaction identifier of the prepared transaction - </entry> + </para></entry> </row> + <row> - <entry><structfield>gid</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>gid</structfield> <type>text</type> + </para> + <para> Global transaction identifier that was assigned to the transaction - </entry> + </para></entry> </row> + <row> - <entry><structfield>prepared</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>prepared</structfield> <type>timestamptz</type> + </para> + <para> Time at which the transaction was prepared for commit - </entry> + </para></entry> </row> + <row> - <entry><structfield>owner</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>owner</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> Name of the user that executed the transaction - </entry> + </para></entry> </row> + <row> - <entry><structfield>database</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.datname</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>database</structfield> <type>name</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>datname</structfield>) + </para> + <para> Name of the database in which the transaction was executed - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -9713,37 +10947,47 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_publication_tables</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>pubname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-publication"><structname>pg_publication</structname></link>.pubname</literal></entry> - <entry>Name of publication</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pubname</structfield> <type>name</type> + (references <link linkend="catalog-pg-publication"><structname>pg_publication</structname></link>.<structfield>pubname</structfield>) + </para> + <para> + Name of publication + </para></entry> </row> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table + </para></entry> </row> <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table + </para></entry> </row> </tbody> </tgroup> @@ -9765,50 +11009,58 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx </para> <table> - <title><structname>pg_replication_origin_status</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>local_id</structfield></entry> - <entry><type>Oid</type></entry> - <entry><literal><link linkend="catalog-pg-replication-origin"><structname>pg_replication_origin</structname></link>.roident</literal></entry> - <entry>internal node identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>local_id</structfield> <type>oid</type> + (references <link linkend="catalog-pg-replication-origin"><structname>pg_replication_origin</structname></link>.<structfield>roident</structfield>) + </para> + <para> + internal node identifier + </para></entry> </row> <row> - <entry><structfield>external_id</structfield></entry> - <entry><type>text</type></entry> - <entry><literal><link linkend="catalog-pg-replication-origin"><structname>pg_replication_origin</structname></link>.roname</literal></entry> - <entry>external node identifier</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>external_id</structfield> <type>text</type> + (references <link linkend="catalog-pg-replication-origin"><structname>pg_replication_origin</structname></link>.<structfield>roname</structfield>) + </para> + <para> + external node identifier + </para></entry> </row> <row> - <entry><structfield>remote_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry></entry> - <entry>The origin node's LSN up to which data has been replicated.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>remote_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + The origin node's LSN up to which data has been replicated. + </para></entry> </row> <row> - <entry><structfield>local_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>local_lsn</structfield> <type>pg_lsn</type> + </para> + <para> This node's LSN at which <literal>remote_lsn</literal> has been replicated. Used to flush commit records before persisting data to disk when using asynchronous commits. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -9834,162 +11086,184 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx </para> <table> - <title><structname>pg_replication_slots</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>slot_name</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>A unique, cluster-wide identifier for the replication slot</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>slot_name</structfield> <type>name</type> + </para> + <para> + A unique, cluster-wide identifier for the replication slot + </para></entry> </row> <row> - <entry><structfield>plugin</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>plugin</structfield> <type>name</type> + </para> + <para> + The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots. + </para></entry> </row> <row> - <entry><structfield>slot_type</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>The slot type: <literal>physical</literal> or <literal>logical</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>slot_type</structfield> <type>text</type> + </para> + <para> + The slot type: <literal>physical</literal> or <literal>logical</literal> + </para></entry> </row> <row> - <entry><structfield>datoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.oid</literal></entry> - <entry>The OID of the database this slot is associated with, or - null. Only logical slots have an associated database.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the database this slot is associated with, or + null. Only logical slots have an associated database. + </para></entry> </row> <row> - <entry><structfield>database</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.datname</literal></entry> - <entry>The name of the database this slot is associated with, or - null. Only logical slots have an associated database.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>database</structfield> <type>name</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>datname</structfield>) + </para> + <para> + The name of the database this slot is associated with, or + null. Only logical slots have an associated database. + </para></entry> </row> <row> - <entry><structfield>temporary</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>True if this is a temporary replication slot. Temporary slots are - not saved to disk and are automatically dropped on error or when - the session has finished.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>temporary</structfield> <type>bool</type> + </para> + <para> + True if this is a temporary replication slot. Temporary slots are + not saved to disk and are automatically dropped on error or when + the session has finished. + </para></entry> </row> <row> - <entry><structfield>active</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>True if this slot is currently actively being used</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>active</structfield> <type>bool</type> + </para> + <para> + True if this slot is currently actively being used + </para></entry> </row> <row> - <entry><structfield>active_pid</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry>The process ID of the session using this slot if the slot + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>active_pid</structfield> <type>int4</type> + </para> + <para> + The process ID of the session using this slot if the slot is currently actively being used. <literal>NULL</literal> if inactive. - </entry> + </para></entry> </row> <row> - <entry><structfield>xmin</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry>The oldest transaction that this slot needs the database to - retain. <literal>VACUUM</literal> cannot remove tuples deleted - by any later transaction. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>xmin</structfield> <type>xid</type> + </para> + <para> + The oldest transaction that this slot needs the database to + retain. <literal>VACUUM</literal> cannot remove tuples deleted + by any later transaction. + </para></entry> </row> <row> - <entry><structfield>catalog_xmin</structfield></entry> - <entry><type>xid</type></entry> - <entry></entry> - <entry>The oldest transaction affecting the system catalogs that this - slot needs the database to retain. <literal>VACUUM</literal> cannot - remove catalog tuples deleted by any later transaction. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>catalog_xmin</structfield> <type>xid</type> + </para> + <para> + The oldest transaction affecting the system catalogs that this + slot needs the database to retain. <literal>VACUUM</literal> cannot + remove catalog tuples deleted by any later transaction. + </para></entry> </row> <row> - <entry><structfield>restart_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry></entry> - <entry>The address (<literal>LSN</literal>) of oldest WAL which still - might be required by the consumer of this slot and thus won't be - automatically removed during checkpoints. <literal>NULL</literal> - if the <literal>LSN</literal> of this slot has never been reserved. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>restart_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + The address (<literal>LSN</literal>) of oldest WAL which still + might be required by the consumer of this slot and thus won't be + automatically removed during checkpoints. <literal>NULL</literal> + if the <literal>LSN</literal> of this slot has never been reserved. + </para></entry> </row> <row> - <entry><structfield>confirmed_flush_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry></entry> - <entry>The address (<literal>LSN</literal>) up to which the logical - slot's consumer has confirmed receiving data. Data older than this is - not available anymore. <literal>NULL</literal> for physical slots. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confirmed_flush_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + The address (<literal>LSN</literal>) up to which the logical + slot's consumer has confirmed receiving data. Data older than this is + not available anymore. <literal>NULL</literal> for physical slots. + </para></entry> </row> <row> - <entry><structfield>wal_status</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - - <entry>Availability of WAL files claimed by this slot. - Possible values are: - <simplelist> - <member> - <literal>normal</literal> means that the claimed files - are within <varname>max_wal_size</varname> - </member> - <member> - <literal>reserved</literal> means that <varname>max_wal_size</varname> - is exceeded but the files are still held, either by some replication - slot or by <varname>wal_keep_segments</varname> - </member> - <member> - <literal>lost</literal> means that some WAL files are definitely lost - and this slot cannot be used to resume replication anymore. - </member> - </simplelist> - The last two states are seen only when - <xref linkend="guc-max-slot-wal-keep-size"/> is - non-negative. If <structfield>restart_lsn</structfield> is NULL, this - field is null. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>wal_status</structfield> <type>text</type> + </para> + <para> + Availability of WAL files claimed by this slot. + Possible values are: + <itemizedlist> + <listitem> + <para><literal>normal</literal> means that the claimed files + are within <varname>max_wal_size</varname>.</para> + </listitem> + <listitem> + <para><literal>reserved</literal> means + that <varname>max_wal_size</varname> is exceeded but the files are + still held, either by some replication slot or + by <varname>wal_keep_segments</varname>.</para> + </listitem> + <listitem> + <para><literal>lost</literal> means that some WAL files are + definitely lost and this slot cannot be used to resume replication + anymore.</para> + </listitem> + </itemizedlist> + The last two states are seen only when + <xref linkend="guc-max-slot-wal-keep-size"/> is + non-negative. If <structfield>restart_lsn</structfield> is NULL, this + field is null. + </para></entry> </row> <row> - <entry><structfield>min_safe_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>min_safe_lsn</structfield> <type>pg_lsn</type> + </para> + <para> The minimum LSN currently available for walsenders. - </entry> + </para></entry> </row> - </tbody> </tgroup> </table> @@ -10012,121 +11286,141 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_roles</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>rolname</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Role name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolname</structfield> <type>name</type> + </para> + <para> + Role name + </para></entry> </row> <row> - <entry><structfield>rolsuper</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Role has superuser privileges</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolsuper</structfield> <type>bool</type> + </para> + <para> + Role has superuser privileges + </para></entry> </row> <row> - <entry><structfield>rolinherit</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Role automatically inherits privileges of roles it is a - member of</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolinherit</structfield> <type>bool</type> + </para> + <para> + Role automatically inherits privileges of roles it is a + member of + </para></entry> </row> <row> - <entry><structfield>rolcreaterole</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Role can create more roles</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolcreaterole</structfield> <type>bool</type> + </para> + <para> + Role can create more roles + </para></entry> </row> <row> - <entry><structfield>rolcreatedb</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>Role can create databases</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolcreatedb</structfield> <type>bool</type> + </para> + <para> + Role can create databases + </para></entry> </row> <row> - <entry><structfield>rolcanlogin</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolcanlogin</structfield> <type>bool</type> + </para> + <para> Role can log in. That is, this role can be given as the initial session authorization identifier - </entry> + </para></entry> </row> <row> - <entry><structfield>rolreplication</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolreplication</structfield> <type>bool</type> + </para> + <para> Role is a replication role. A replication role can initiate replication connections and create and drop replication slots. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolconnlimit</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolconnlimit</structfield> <type>int4</type> + </para> + <para> For roles that can log in, this sets maximum number of concurrent connections this role can make. -1 means no limit. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolpassword</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Not the password (always reads as <literal>********</literal>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolpassword</structfield> <type>text</type> + </para> + <para> + Not the password (always reads as <literal>********</literal>) + </para></entry> </row> <row> - <entry><structfield>rolvaliduntil</structfield></entry> - <entry><type>timestamptz</type></entry> - <entry></entry> - <entry>Password expiry time (only used for password authentication); - null if no expiration</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolvaliduntil</structfield> <type>timestamptz</type> + </para> + <para> + Password expiry time (only used for password authentication); + null if no expiration + </para></entry> </row> <row> - <entry><structfield>rolbypassrls</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolbypassrls</structfield> <type>bool</type> + </para> + <para> Role bypasses every row level security policy, see <xref linkend="ddl-rowsecurity"/> for more information. - </entry> + </para></entry> </row> <row> - <entry><structfield>rolconfig</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry>Role-specific defaults for run-time configuration variables</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rolconfig</structfield> <type>text[]</type> + </para> + <para> + Role-specific defaults for run-time configuration variables + </para></entry> </row> <row> - <entry><structfield>oid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>ID of role</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>oid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + ID of role + </para></entry> </row> </tbody> </tgroup> @@ -10148,40 +11442,56 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_rules</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table + </para></entry> </row> + <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table the rule is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table the rule is for + </para></entry> </row> + <row> - <entry><structfield>rulename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-rewrite"><structname>pg_rewrite</structname></link>.rulename</literal></entry> - <entry>Name of rule</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rulename</structfield> <type>name</type> + (references <link linkend="catalog-pg-rewrite"><structname>pg_rewrite</structname></link>.<structfield>rulename</structfield>) + </para> + <para> + Name of rule + </para></entry> </row> + <row> - <entry><structfield>definition</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Rule definition (a reconstructed creation command)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>definition</structfield> <type>text</type> + </para> + <para> + Rule definition (a reconstructed creation command) + </para></entry> </row> </tbody> </tgroup> @@ -10210,76 +11520,98 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_seclabels</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>objoid</structfield></entry> - <entry><type>oid</type></entry> - <entry>any OID column</entry> - <entry>The OID of the object this security label pertains to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objoid</structfield> <type>oid</type> + (references any OID column) + </para> + <para> + The OID of the object this security label pertains to + </para></entry> </row> + <row> - <entry><structfield>classoid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.oid</literal></entry> - <entry>The OID of the system catalog this object appears in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>classoid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>oid</structfield>) + </para> + <para> + The OID of the system catalog this object appears in + </para></entry> </row> + <row> - <entry><structfield>objsubid</structfield></entry> - <entry><type>int4</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objsubid</structfield> <type>int4</type> + </para> + <para> For a security label on a table column, this is the column number (the <structfield>objoid</structfield> and <structfield>classoid</structfield> refer to the table itself). For all other object types, this column is zero. - </entry> + </para></entry> </row> + <row> - <entry><structfield>objtype</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> - The type of object to which this label applies, as text. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objtype</structfield> <type>text</type> + </para> + <para> + The type of object to which this label applies, as text. + </para></entry> </row> + <row> - <entry><structfield>objnamespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objnamespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the namespace for this object, if applicable; otherwise NULL. - </entry> + </para></entry> </row> + <row> - <entry><structfield>objname</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>objname</structfield> <type>text</type> + </para> + <para> The name of the object to which this label applies, as text. - </entry> + </para></entry> </row> + <row> - <entry><structfield>provider</structfield></entry> - <entry><type>text</type></entry> - <entry><literal><link linkend="catalog-pg-seclabel"><structname>pg_seclabel</structname></link>.provider</literal></entry> - <entry>The label provider associated with this label.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>provider</structfield> <type>text</type> + (references <link linkend="catalog-pg-seclabel"><structname>pg_seclabel</structname></link>.<structfield>provider</structfield>) + </para> + <para> + The label provider associated with this label. + </para></entry> </row> + <row> - <entry><structfield>label</structfield></entry> - <entry><type>text</type></entry> - <entry><literal><link linkend="catalog-pg-seclabel"><structname>pg_seclabel</structname></link>.label</literal></entry> - <entry>The security label applied to this object.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>label</structfield> <type>text</type> + (references <link linkend="catalog-pg-seclabel"><structname>pg_seclabel</structname></link>.<structfield>label</structfield>) + </para> + <para> + The security label applied to this object. + </para></entry> </row> </tbody> </tgroup> @@ -10300,87 +11632,125 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_sequences</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing sequence + </para></entry> </row> + <row> - <entry><structfield>sequencename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sequencename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of sequence + </para></entry> </row> + <row> - <entry><structfield>sequenceowner</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>Name of sequence's owner</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sequenceowner</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + Name of sequence's owner + </para></entry> </row> + <row> - <entry><structfield>data_type</structfield></entry> - <entry><type>regtype</type></entry> - <entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry> - <entry>Data type of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>regtype</type> + (references <link linkend="catalog-pg-type"><structname>pg_type</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Data type of the sequence + </para></entry> </row> + <row> - <entry><structfield>start_value</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Start value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>start_value</structfield> <type>int8</type> + </para> + <para> + Start value of the sequence + </para></entry> </row> + <row> - <entry><structfield>min_value</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Minimum value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>min_value</structfield> <type>int8</type> + </para> + <para> + Minimum value of the sequence + </para></entry> </row> + <row> - <entry><structfield>max_value</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Maximum value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>max_value</structfield> <type>int8</type> + </para> + <para> + Maximum value of the sequence + </para></entry> </row> + <row> - <entry><structfield>increment_by</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Increment value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>increment_by</structfield> <type>int8</type> + </para> + <para> + Increment value of the sequence + </para></entry> </row> + <row> - <entry><structfield>cycle</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>Whether the sequence cycles</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cycle</structfield> <type>bool</type> + </para> + <para> + Whether the sequence cycles + </para></entry> </row> + <row> - <entry><structfield>cache_size</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Cache size of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cache_size</structfield> <type>int8</type> + </para> + <para> + Cache size of the sequence + </para></entry> </row> + <row> - <entry><structfield>last_value</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>The last sequence value written to disk. If caching is used, + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_value</structfield> <type>int8</type> + </para> + <para> + The last sequence value written to disk. If caching is used, this value can be greater than the last value handed out from the sequence. Null if the sequence has not been read from yet. Also, if the current user does not have <literal>USAGE</literal> or <literal>SELECT</literal> privilege on the sequence, the value is - null.</entry> + null. + </para></entry> </row> </tbody> </tgroup> @@ -10406,118 +11776,185 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_settings</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry>Run-time configuration parameter name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + Run-time configuration parameter name + </para></entry> </row> + <row> - <entry><structfield>setting</structfield></entry> - <entry><type>text</type></entry> - <entry>Current value of the parameter</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>setting</structfield> <type>text</type> + </para> + <para> + Current value of the parameter + </para></entry> </row> + <row> - <entry><structfield>unit</structfield></entry> - <entry><type>text</type></entry> - <entry>Implicit unit of the parameter</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>unit</structfield> <type>text</type> + </para> + <para> + Implicit unit of the parameter + </para></entry> </row> + <row> - <entry><structfield>category</structfield></entry> - <entry><type>text</type></entry> - <entry>Logical group of the parameter</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>category</structfield> <type>text</type> + </para> + <para> + Logical group of the parameter + </para></entry> </row> + <row> - <entry><structfield>short_desc</structfield></entry> - <entry><type>text</type></entry> - <entry>A brief description of the parameter</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>short_desc</structfield> <type>text</type> + </para> + <para> + A brief description of the parameter + </para></entry> </row> + <row> - <entry><structfield>extra_desc</structfield></entry> - <entry><type>text</type></entry> - <entry>Additional, more detailed, description of the parameter</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>extra_desc</structfield> <type>text</type> + </para> + <para> + Additional, more detailed, description of the parameter + </para></entry> </row> + <row> - <entry><structfield>context</structfield></entry> - <entry><type>text</type></entry> - <entry>Context required to set the parameter's value (see below)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>context</structfield> <type>text</type> + </para> + <para> + Context required to set the parameter's value (see below) + </para></entry> </row> + <row> - <entry><structfield>vartype</structfield></entry> - <entry><type>text</type></entry> - <entry>Parameter type (<literal>bool</literal>, <literal>enum</literal>, + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>vartype</structfield> <type>text</type> + </para> + <para> + Parameter type (<literal>bool</literal>, <literal>enum</literal>, <literal>integer</literal>, <literal>real</literal>, or <literal>string</literal>) - </entry> + </para></entry> </row> + <row> - <entry><structfield>source</structfield></entry> - <entry><type>text</type></entry> - <entry>Source of the current parameter value</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>source</structfield> <type>text</type> + </para> + <para> + Source of the current parameter value + </para></entry> </row> + <row> - <entry><structfield>min_val</structfield></entry> - <entry><type>text</type></entry> - <entry>Minimum allowed value of the parameter (null for non-numeric - values)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>min_val</structfield> <type>text</type> + </para> + <para> + Minimum allowed value of the parameter (null for non-numeric + values) + </para></entry> </row> + <row> - <entry><structfield>max_val</structfield></entry> - <entry><type>text</type></entry> - <entry>Maximum allowed value of the parameter (null for non-numeric - values)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>max_val</structfield> <type>text</type> + </para> + <para> + Maximum allowed value of the parameter (null for non-numeric + values) + </para></entry> </row> + <row> - <entry><structfield>enumvals</structfield></entry> - <entry><type>text[]</type></entry> - <entry>Allowed values of an enum parameter (null for non-enum - values)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>enumvals</structfield> <type>text[]</type> + </para> + <para> + Allowed values of an enum parameter (null for non-enum + values) + </para></entry> </row> + <row> - <entry><structfield>boot_val</structfield></entry> - <entry><type>text</type></entry> - <entry>Parameter value assumed at server startup if the parameter is - not otherwise set</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>boot_val</structfield> <type>text</type> + </para> + <para> + Parameter value assumed at server startup if the parameter is + not otherwise set + </para></entry> </row> + <row> - <entry><structfield>reset_val</structfield></entry> - <entry><type>text</type></entry> - <entry>Value that <command>RESET</command> would reset the parameter to - in the current session</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reset_val</structfield> <type>text</type> + </para> + <para> + Value that <command>RESET</command> would reset the parameter to + in the current session + </para></entry> </row> + <row> - <entry><structfield>sourcefile</structfield></entry> - <entry><type>text</type></entry> - <entry>Configuration file the current value was set in (null for - values set from sources other than configuration files, or when - examined by a user who is neither a superuser or a member of - <literal>pg_read_all_settings</literal>); helpful when using - <literal>include</literal> directives in configuration files</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sourcefile</structfield> <type>text</type> + </para> + <para> + Configuration file the current value was set in (null for + values set from sources other than configuration files, or when + examined by a user who is neither a superuser or a member of + <literal>pg_read_all_settings</literal>); helpful when using + <literal>include</literal> directives in configuration files + </para></entry> </row> + <row> - <entry><structfield>sourceline</structfield></entry> - <entry><type>integer</type></entry> - <entry>Line number within the configuration file the current value was - set at (null for values set from sources other than configuration files, - or when examined by a user who is neither a superuser or a member of - <literal>pg_read_all_settings</literal>). - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sourceline</structfield> <type>int4</type> + </para> + <para> + Line number within the configuration file the current value was + set at (null for values set from sources other than configuration files, + or when examined by a user who is neither a superuser or a member of + <literal>pg_read_all_settings</literal>). + </para></entry> </row> + <row> - <entry><structfield>pending_restart</structfield></entry> - <entry><type>boolean</type></entry> - <entry><literal>true</literal> if the value has been changed in the - configuration file but needs a restart; or <literal>false</literal> - otherwise. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pending_restart</structfield> <type>bool</type> + </para> + <para> + <literal>true</literal> if the value has been changed in the + configuration file but needs a restart; or <literal>false</literal> + otherwise. + </para></entry> </row> </tbody> </tgroup> @@ -10681,87 +12118,104 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_shadow</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>usename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>User name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usename</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + User name + </para></entry> </row> <row> - <entry><structfield>usesysid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>ID of this user</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usesysid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + ID of this user + </para></entry> </row> <row> - <entry><structfield>usecreatedb</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>User can create databases</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usecreatedb</structfield> <type>bool</type> + </para> + <para> + User can create databases + </para></entry> </row> <row> - <entry><structfield>usesuper</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>User is a superuser</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usesuper</structfield> <type>bool</type> + </para> + <para> + User is a superuser + </para></entry> </row> <row> - <entry><structfield>userepl</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>userepl</structfield> <type>bool</type> + </para> + <para> User can initiate streaming replication and put the system in and out of backup mode. - </entry> + </para></entry> </row> <row> - <entry><structfield>usebypassrls</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usebypassrls</structfield> <type>bool</type> + </para> + <para> User bypasses every row level security policy, see <xref linkend="ddl-rowsecurity"/> for more information. - </entry> + </para></entry> </row> <row> - <entry><structfield>passwd</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Password (possibly encrypted); null if none. See - <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link> - for details of how encrypted passwords are stored.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>passwd</structfield> <type>text</type> + </para> + <para> + Password (possibly encrypted); null if none. See + <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link> + for details of how encrypted passwords are stored. + </para></entry> </row> <row> - <entry><structfield>valuntil</structfield></entry> - <entry><type>timestamptz</type></entry> - <entry></entry> - <entry>Password expiry time (only used for password authentication)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>valuntil</structfield> <type>timestamptz</type> + </para> + <para> + Password expiry time (only used for password authentication) + </para></entry> </row> <row> - <entry><structfield>useconfig</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry>Session defaults for run-time configuration variables</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>useconfig</structfield> <type>text[]</type> + </para> + <para> + Session defaults for run-time configuration variables + </para></entry> </row> </tbody> </tgroup> @@ -10791,46 +12245,60 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_shmem_allocations</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry>The name of the shared memory allocation. NULL for unused memory - and <literal><anonymous></literal> for anonymous - allocations.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + The name of the shared memory allocation. NULL for unused memory + and <literal><anonymous></literal> for anonymous + allocations. + </para></entry> </row> <row> - <entry><structfield>off</structfield></entry> - <entry><type>bigint</type></entry> - <entry>The offset at which the allocation starts. NULL for anonymous - allocations and unused memory.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>off</structfield> <type>int8</type> + </para> + <para> + The offset at which the allocation starts. NULL for anonymous + allocations and unused memory. + </para></entry> </row> <row> - <entry><structfield>size</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Size of the allocation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>size</structfield> <type>int8</type> + </para> + <para> + Size of the allocation + </para></entry> </row> <row> - <entry><structfield>allocated_size</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Size of the allocation including padding. For anonymous - allocations, no information about padding is available, so the - <literal>size</literal> and <literal>allocated_size</literal> columns - will always be equal. Padding is not meaningful for free memory, so - the columns will be equal in that case also.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>allocated_size</structfield> <type>int8</type> + </para> + <para> + Size of the allocation including padding. For anonymous + allocations, no information about padding is available, so the + <literal>size</literal> and <literal>allocated_size</literal> columns + will always be equal. Padding is not meaningful for free memory, so + the columns will be equal in that case also. + </para></entry> </row> </tbody> </tgroup> @@ -10875,65 +12343,82 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_stats</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table + </para></entry> </row> <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table + </para></entry> </row> <row> - <entry><structfield>attname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attname</literal></entry> - <entry>Name of the column described by this row</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attname</structfield> <type>name</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attname</structfield>) + </para> + <para> + Name of the column described by this row + </para></entry> </row> <row> - <entry><structfield>inherited</structfield></entry> - <entry><type>bool</type></entry> - <entry></entry> - <entry>If true, this row includes inheritance child columns, not just the - values in the specified table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>inherited</structfield> <type>bool</type> + </para> + <para> + If true, this row includes inheritance child columns, not just the + values in the specified table + </para></entry> </row> <row> - <entry><structfield>null_frac</structfield></entry> - <entry><type>real</type></entry> - <entry></entry> - <entry>Fraction of column entries that are null</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>null_frac</structfield> <type>float4</type> + </para> + <para> + Fraction of column entries that are null + </para></entry> </row> <row> - <entry><structfield>avg_width</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry>Average width in bytes of column's entries</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>avg_width</structfield> <type>int4</type> + </para> + <para> + Average width in bytes of column's entries + </para></entry> </row> <row> - <entry><structfield>n_distinct</structfield></entry> - <entry><type>real</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_distinct</structfield> <type>float4</type> + </para> + <para> If greater than zero, the estimated number of distinct values in the column. If less than zero, the negative of the number of distinct values divided by the number of rows. (The negated form is used when @@ -10942,35 +12427,35 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx the column seems to have a fixed number of possible values.) For example, -1 indicates a unique column in which the number of distinct values is the same as the number of rows. - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_vals</structfield></entry> - <entry><type>anyarray</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_vals</structfield> <type>anyarray</type> + </para> + <para> A list of the most common values in the column. (Null if no values seem to be more common than any others.) - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_freqs</structfield></entry> - <entry><type>real[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_freqs</structfield> <type>float4[]</type> + </para> + <para> A list of the frequencies of the most common values, i.e., number of occurrences of each divided by total number of rows. (Null when <structfield>most_common_vals</structfield> is.) - </entry> + </para></entry> </row> <row> - <entry><structfield>histogram_bounds</structfield></entry> - <entry><type>anyarray</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>histogram_bounds</structfield> <type>anyarray</type> + </para> + <para> A list of values that divide the column's values into groups of approximately equal population. The values in <structfield>most_common_vals</structfield>, if present, are omitted from this @@ -10978,56 +12463,56 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx does not have a <literal><</literal> operator or if the <structfield>most_common_vals</structfield> list accounts for the entire population.) - </entry> + </para></entry> </row> <row> - <entry><structfield>correlation</structfield></entry> - <entry><type>real</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>correlation</structfield> <type>float4</type> + </para> + <para> Statistical correlation between physical row ordering and logical ordering of the column values. This ranges from -1 to +1. When the value is near -1 or +1, an index scan on the column will be estimated to be cheaper than when it is near zero, due to reduction of random access to the disk. (This column is null if the column data type does not have a <literal><</literal> operator.) - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_elems</structfield></entry> - <entry><type>anyarray</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_elems</structfield> <type>anyarray</type> + </para> + <para> A list of non-null element values most often appearing within values of the column. (Null for scalar types.) - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_elem_freqs</structfield></entry> - <entry><type>real[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_elem_freqs</structfield> <type>float4[]</type> + </para> + <para> A list of the frequencies of the most common element values, i.e., the fraction of rows containing at least one instance of the given value. Two or three additional values follow the per-element frequencies; these are the minimum and maximum of the preceding per-element frequencies, and optionally the frequency of null elements. (Null when <structfield>most_common_elems</structfield> is.) - </entry> + </para></entry> </row> <row> - <entry><structfield>elem_count_histogram</structfield></entry> - <entry><type>real[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>elem_count_histogram</structfield> <type>float4[]</type> + </para> + <para> A histogram of the counts of distinct non-null element values within the values of the column, followed by the average number of distinct non-null elements. (Null for scalar types.) - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -11069,71 +12554,94 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_stats_ext</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table + </para></entry> </row> <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table + </para></entry> </row> <row> - <entry><structfield>statistics_schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing extended statistic</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>statistics_schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing extended statistic + </para></entry> </row> <row> - <entry><structfield>statistics_name</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.stxname</literal></entry> - <entry>Name of extended statistics</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>statistics_name</structfield> <type>name</type> + (references <link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.<structfield>stxname</structfield>) + </para> + <para> + Name of extended statistics + </para></entry> </row> <row> - <entry><structfield>statistics_owner</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>Owner of the extended statistics</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>statistics_owner</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + Owner of the extended statistics + </para></entry> </row> <row> - <entry><structfield>attnames</structfield></entry> - <entry><type>name[]</type></entry> - <entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attname</literal></entry> - <entry>Names of the columns the extended statistics is defined on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attnames</structfield> <type>name[]</type> + (references <link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.<structfield>attname</structfield>) + </para> + <para> + Names of the columns the extended statistics is defined on + </para></entry> </row> <row> - <entry><structfield>kinds</structfield></entry> - <entry><type>char[]</type></entry> - <entry></entry> - <entry>Types of extended statistics enabled for this record</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>kinds</structfield> <type>char[]</type> + </para> + <para> + Types of extended statistics enabled for this record + </para></entry> </row> <row> - <entry><structfield>n_distinct</structfield></entry> - <entry><type>pg_ndistinct</type></entry> - <entry></entry> - <entry>N-distinct counts for combinations of column values. If greater + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_distinct</structfield> <type>pg_ndistinct</type> + </para> + <para> + N-distinct counts for combinations of column values. If greater than zero, the estimated number of distinct values in the combination. If less than zero, the negative of the number of distinct values divided by the number of rows. @@ -11143,56 +12651,58 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx of possible values.) For example, -1 indicates a unique combination of columns in which the number of distinct combinations is the same as the number of rows. - </entry> + </para></entry> </row> <row> - <entry><structfield>dependencies</structfield></entry> - <entry><type>pg_dependencies</type></entry> - <entry></entry> - <entry>Functional dependency statistics</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dependencies</structfield> <type>pg_dependencies</type> + </para> + <para> + Functional dependency statistics + </para></entry> </row> <row> - <entry><structfield>most_common_vals</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_vals</structfield> <type>text[]</type> + </para> + <para> A list of the most common combinations of values in the columns. (Null if no combinations seem to be more common than any others.) - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_val_nulls</structfield></entry> - <entry><type>bool[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_val_nulls</structfield> <type>bool[]</type> + </para> + <para> A list of NULL flags for the most common combinations of values. (Null when <structfield>most_common_vals</structfield> is.) - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_freqs</structfield></entry> - <entry><type>float8[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_freqs</structfield> <type>float8[]</type> + </para> + <para> A list of the frequencies of the most common combinations, i.e., number of occurrences of each divided by total number of rows. (Null when <structfield>most_common_vals</structfield> is.) - </entry> + </para></entry> </row> <row> - <entry><structfield>most_common_base_freqs</structfield></entry> - <entry><type>float8[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>most_common_base_freqs</structfield> <type>float8[]</type> + </para> + <para> A list of the base frequencies of the most common combinations, i.e., product of per-value frequencies. (Null when <structfield>most_common_vals</structfield> is.) - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -11221,64 +12731,97 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_tables</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing table + </para></entry> </row> + <row> - <entry><structfield>tablename</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablename</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of table + </para></entry> </row> + <row> - <entry><structfield>tableowner</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>Name of table's owner</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tableowner</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + Name of table's owner + </para></entry> </row> + <row> - <entry><structfield>tablespace</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.spcname</literal></entry> - <entry>Name of tablespace containing table (null if default for database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablespace</structfield> <type>name</type> + (references <link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.<structfield>spcname</structfield>) + </para> + <para> + Name of tablespace containing table (null if default for database) + </para></entry> </row> + <row> - <entry><structfield>hasindexes</structfield></entry> - <entry><type>boolean</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relhasindex</literal></entry> - <entry>True if table has (or recently had) any indexes</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>hasindexes</structfield> <type>bool</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relhasindex</structfield>) + </para> + <para> + True if table has (or recently had) any indexes + </para></entry> </row> + <row> - <entry><structfield>hasrules</structfield></entry> - <entry><type>boolean</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relhasrules</literal></entry> - <entry>True if table has (or once had) rules</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>hasrules</structfield> <type>bool</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relhasrules</structfield>) + </para> + <para> + True if table has (or once had) rules + </para></entry> </row> + <row> - <entry><structfield>hastriggers</structfield></entry> - <entry><type>boolean</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relhastriggers</literal></entry> - <entry>True if table has (or once had) triggers</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>hastriggers</structfield> <type>bool</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relhastriggers</structfield>) + </para> + <para> + True if table has (or once had) triggers + </para></entry> </row> + <row> - <entry><structfield>rowsecurity</structfield></entry> - <entry><type>boolean</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relrowsecurity</literal></entry> - <entry>True if row security is enabled on the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rowsecurity</structfield> <type>bool</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relrowsecurity</structfield>) + </para> + <para> + True if row security is enabled on the table + </para></entry> </row> </tbody> </tgroup> @@ -11302,30 +12845,44 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_timezone_abbrevs</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>abbrev</structfield></entry> - <entry><type>text</type></entry> - <entry>Time zone abbreviation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>abbrev</structfield> <type>text</type> + </para> + <para> + Time zone abbreviation + </para></entry> </row> + <row> - <entry><structfield>utc_offset</structfield></entry> - <entry><type>interval</type></entry> - <entry>Offset from UTC (positive means east of Greenwich)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>utc_offset</structfield> <type>interval</type> + </para> + <para> + Offset from UTC (positive means east of Greenwich) + </para></entry> </row> + <row> - <entry><structfield>is_dst</structfield></entry> - <entry><type>boolean</type></entry> - <entry>True if this is a daylight-savings abbreviation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_dst</structfield> <type>bool</type> + </para> + <para> + True if this is a daylight-savings abbreviation + </para></entry> </row> </tbody> </tgroup> @@ -11363,35 +12920,53 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_timezone_names</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry>Time zone name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + Time zone name + </para></entry> </row> + <row> - <entry><structfield>abbrev</structfield></entry> - <entry><type>text</type></entry> - <entry>Time zone abbreviation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>abbrev</structfield> <type>text</type> + </para> + <para> + Time zone abbreviation + </para></entry> </row> + <row> - <entry><structfield>utc_offset</structfield></entry> - <entry><type>interval</type></entry> - <entry>Offset from UTC (positive means east of Greenwich)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>utc_offset</structfield> <type>interval</type> + </para> + <para> + Offset from UTC (positive means east of Greenwich) + </para></entry> </row> + <row> - <entry><structfield>is_dst</structfield></entry> - <entry><type>boolean</type></entry> - <entry>True if currently observing daylight savings</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_dst</structfield> <type>bool</type> + </para> + <para> + True if currently observing daylight savings + </para></entry> </row> </tbody> </tgroup> @@ -11416,74 +12991,100 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_user</structname> Columns</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>usename</structfield></entry> - <entry><type>name</type></entry> - <entry>User name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usename</structfield> <type>name</type> + </para> + <para> + User name + </para></entry> </row> <row> - <entry><structfield>usesysid</structfield></entry> - <entry><type>oid</type></entry> - <entry>ID of this user</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usesysid</structfield> <type>oid</type> + </para> + <para> + ID of this user + </para></entry> </row> <row> - <entry><structfield>usecreatedb</structfield></entry> - <entry><type>bool</type></entry> - <entry>User can create databases</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usecreatedb</structfield> <type>bool</type> + </para> + <para> + User can create databases + </para></entry> </row> <row> - <entry><structfield>usesuper</structfield></entry> - <entry><type>bool</type></entry> - <entry>User is a superuser</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usesuper</structfield> <type>bool</type> + </para> + <para> + User is a superuser + </para></entry> </row> <row> - <entry><structfield>userepl</structfield></entry> - <entry><type>bool</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>userepl</structfield> <type>bool</type> + </para> + <para> User can initiate streaming replication and put the system in and out of backup mode. - </entry> + </para></entry> </row> <row> - <entry><structfield>usebypassrls</structfield></entry> - <entry><type>bool</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usebypassrls</structfield> <type>bool</type> + </para> + <para> User bypasses every row level security policy, see <xref linkend="ddl-rowsecurity"/> for more information. - </entry> + </para></entry> </row> <row> - <entry><structfield>passwd</structfield></entry> - <entry><type>text</type></entry> - <entry>Not the password (always reads as <literal>********</literal>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>passwd</structfield> <type>text</type> + </para> + <para> + Not the password (always reads as <literal>********</literal>) + </para></entry> </row> <row> - <entry><structfield>valuntil</structfield></entry> - <entry><type>timestamptz</type></entry> - <entry>Password expiry time (only used for password authentication)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>valuntil</structfield> <type>timestamptz</type> + </para> + <para> + Password expiry time (only used for password authentication) + </para></entry> </row> <row> - <entry><structfield>useconfig</structfield></entry> - <entry><type>text[]</type></entry> - <entry>Session defaults for run-time configuration variables</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>useconfig</structfield> <type>text[]</type> + </para> + <para> + Session defaults for run-time configuration variables + </para></entry> </row> </tbody> </tgroup> @@ -11509,64 +13110,75 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_user_mappings</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>umid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-user-mapping"><structname>pg_user_mapping</structname></link>.oid</literal></entry> - <entry>OID of the user mapping</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>umid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-user-mapping"><structname>pg_user_mapping</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the user mapping + </para></entry> </row> <row> - <entry><structfield>srvid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.oid</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.<structfield>oid</structfield>) + </para> + <para> The OID of the foreign server that contains this mapping - </entry> + </para></entry> </row> <row> - <entry><structfield>srvname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.srvname</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>srvname</structfield> <type>name</type> + (references <link linkend="catalog-pg-foreign-server"><structname>pg_foreign_server</structname></link>.<structfield>srvname</structfield>) + </para> + <para> Name of the foreign server - </entry> + </para></entry> </row> <row> - <entry><structfield>umuser</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>OID of the local role being mapped, 0 if the user mapping is public</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>umuser</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of the local role being mapped, 0 if the user mapping is public + </para></entry> </row> <row> - <entry><structfield>usename</structfield></entry> - <entry><type>name</type></entry> - <entry></entry> - <entry>Name of the local user to be mapped</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usename</structfield> <type>name</type> + </para> + <para> + Name of the local user to be mapped + </para></entry> </row> <row> - <entry><structfield>umoptions</structfield></entry> - <entry><type>text[]</type></entry> - <entry></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>umoptions</structfield> <type>text[]</type> + </para> + <para> User mapping specific options, as <quote>keyword=value</quote> strings - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -11613,40 +13225,56 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx <table> <title><structname>pg_views</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry> - <entry>Name of schema containing view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + (references <link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.<structfield>nspname</structfield>) + </para> + <para> + Name of schema containing view + </para></entry> </row> + <row> - <entry><structfield>viewname</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry> - <entry>Name of view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>viewname</structfield> <type>name</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relname</structfield>) + </para> + <para> + Name of view + </para></entry> </row> + <row> - <entry><structfield>viewowner</structfield></entry> - <entry><type>name</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.rolname</literal></entry> - <entry>Name of view's owner</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>viewowner</structfield> <type>name</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>rolname</structfield>) + </para> + <para> + Name of view's owner + </para></entry> </row> + <row> - <entry><structfield>definition</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>View definition (a reconstructed <command>SELECT</command> query)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>definition</structfield> <type>text</type> + </para> + <para> + View definition (a reconstructed <command>SELECT</command> query) + </para></entry> </row> </tbody> </tgroup> diff --git a/doc/src/sgml/information_schema.sgml b/doc/src/sgml/information_schema.sgml index 70ad1994f74..36ec17a4c60 100644 --- a/doc/src/sgml/information_schema.sgml +++ b/doc/src/sgml/information_schema.sgml @@ -151,22 +151,27 @@ </para> <table> - <title><literal>information_schema_catalog_name</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>information_schema_catalog_name</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>catalog_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains this information schema</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>catalog_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains this information schema + </para></entry> </row> </tbody> </tgroup> @@ -183,38 +188,47 @@ </para> <table> - <title><literal>administrable_role_authorizations</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>administrable_role_authorizations</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> Name of the role to which this role membership was granted (can be the current user, or a different role in case of nested role memberships) - </entry> + </para></entry> </row> <row> - <entry><literal>role_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of a role</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>role_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of a role + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Always <literal>YES</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + Always <literal>YES</literal> + </para></entry> </row> </tbody> </tgroup> @@ -235,41 +249,48 @@ </para> <table> - <title><literal>applicable_roles</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>applicable_roles</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> Name of the role to which this role membership was granted (can be the current user, or a different role in case of nested role memberships) - </entry> + </para></entry> </row> <row> - <entry><literal>role_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of a role</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>role_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of a role + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the grantee has the admin option on the role, <literal>NO</literal> if not - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -289,149 +310,186 @@ </para> <table> - <title><literal>attributes</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>attributes</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the data type (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the data type (always the current database) + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the data type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the data type + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the data type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the data type + </para></entry> </row> <row> - <entry><literal>attribute_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the attribute</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attribute_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the attribute + </para></entry> </row> <row> - <entry><literal>ordinal_position</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Ordinal position of the attribute within the data type (count starts at 1)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordinal_position</structfield> <type>cardinal_number</type> + </para> + <para> + Ordinal position of the attribute within the data type (count starts at 1) + </para></entry> </row> <row> - <entry><literal>attribute_default</literal></entry> - <entry><type>character_data</type></entry> - <entry>Default expression of the attribute</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attribute_default</structfield> <type>character_data</type> + </para> + <para> + Default expression of the attribute + </para></entry> </row> <row> - <entry><literal>is_nullable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_nullable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the attribute is possibly nullable, <literal>NO</literal> if it is known not nullable. - </entry> + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> Data type of the attribute, if it is a built-in type, or <literal>ARRAY</literal> if it is some array (in that case, see the view <literal>element_types</literal>), else <literal>USER-DEFINED</literal> (in that case, the type is identified in <literal>attribute_udt_name</literal> and associated columns). - </entry> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a character or bit string type, the declared maximum length; null for all other data types or if no maximum length was declared. - </entry> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a character type, the maximum possible length in octets (bytes) of a datum; null for all other data types. The maximum octet length depends on the declared character maximum length (see above) and the server encoding. - </entry> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database containing the collation of the attribute (always the current database), null if default or the data type of the attribute is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema containing the collation of the attribute, null if default or the data type of the attribute is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the collation of the attribute, null if default or the data type of the attribute is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a numeric type, this column contains the (declared or implicit) precision of the type for this attribute. The precision indicates the number of @@ -439,25 +497,27 @@ or binary (base 2) terms, as specified in the column <literal>numeric_precision_radix</literal>. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a numeric type, this column indicates in which base the values in the columns <literal>numeric_precision</literal> and <literal>numeric_scale</literal> are expressed. The value is either 2 or 10. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies an exact numeric type, this column contains the (declared or implicit) scale of the type for this attribute. The scale indicates the number of @@ -466,26 +526,28 @@ specified in the column <literal>numeric_precision_radix</literal>. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a date, time, timestamp, or interval type, this column contains the (declared or implicit) fractional seconds precision of the type for this attribute, that is, the number of decimal digits maintained following the decimal point in the seconds value. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> If <literal>data_type</literal> identifies an interval type, this column contains the specification which fields the intervals include for this attribute, e.g., <literal>YEAR TO @@ -493,86 +555,106 @@ field restrictions were specified (that is, the interval accepts all fields), and for all other data types, this field is null. - </entry> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> Applies to a feature not available in <productname>PostgreSQL</productname> (see <literal>datetime_precision</literal> for the fractional seconds precision of interval type attributes) - </entry> + </para></entry> </row> <row> - <entry><literal>attribute_udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attribute_udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that the attribute data type is defined in (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>attribute_udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attribute_udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that the attribute data type is defined in - </entry> + </para></entry> </row> <row> - <entry><literal>attribute_udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>attribute_udt_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the attribute data type - </entry> + </para></entry> </row> <row> - <entry><literal>scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> An identifier of the data type descriptor of the column, unique among the data type descriptors pertaining to the table. This is mainly useful for joining with other instances of such identifiers. (The specific format of the identifier is not defined and not guaranteed to remain the same in future versions.) - </entry> + </para></entry> </row> <row> - <entry><literal>is_derived_reference_attribute</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_derived_reference_attribute</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> </tbody> </tgroup> @@ -647,71 +729,95 @@ </para> <table> - <title><literal>character_sets</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>character_sets</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Character sets are currently not implemented as schema objects, so this column is null.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Character sets are currently not implemented as schema objects, so this column is null. + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Character sets are currently not implemented as schema objects, so this column is null.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Character sets are currently not implemented as schema objects, so this column is null. + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the character set, currently implemented as showing the name of the database encoding</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the character set, currently implemented as showing the name of the database encoding + </para></entry> </row> <row> - <entry><literal>character_repertoire</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Character repertoire, showing <literal>UCS</literal> if the encoding is <literal>UTF8</literal>, else just the encoding name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_repertoire</structfield> <type>sql_identifier</type> + </para> + <para> + Character repertoire, showing <literal>UCS</literal> if the encoding is <literal>UTF8</literal>, else just the encoding name + </para></entry> </row> <row> - <entry><literal>form_of_use</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Character encoding form, same as the database encoding</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>form_of_use</structfield> <type>sql_identifier</type> + </para> + <para> + Character encoding form, same as the database encoding + </para></entry> </row> <row> - <entry><literal>default_collate_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the default collation (always the current database, if any collation is identified)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_collate_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the default collation (always the current database, if any collation is identified) + </para></entry> </row> <row> - <entry><literal>default_collate_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the default collation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_collate_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the default collation + </para></entry> </row> <row> - <entry><literal>default_collate_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_collate_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the default collation. The default collation is identified as the collation that matches the <literal>COLLATE</literal> and <literal>CTYPE</literal> settings of the current database. If there is no such collation, then this column and the associated schema and catalog columns are null. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -729,55 +835,72 @@ </para> <table> - <title><literal>check_constraint_routine_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>check_constraint_routine_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> - The <quote>specific name</quote> of the function. See <xref - linkend="infoschema-routines"/> for more information. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + The <quote>specific name</quote> of the function. See <xref linkend="infoschema-routines"/> for more information. + </para></entry> </row> </tbody> </tgroup> @@ -795,40 +918,54 @@ </para> <table> - <title><literal>check_constraints</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>check_constraints</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> <row> - <entry><literal>check_clause</literal></entry> - <entry><literal>character_data</literal></entry> - <entry>The check expression of the check constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>check_clause</structfield> <type>character_data</type> + </para> + <para> + The check expression of the check constraint + </para></entry> </row> </tbody> </tgroup> @@ -844,43 +981,55 @@ </para> <table> - <title><literal>collations</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>collations</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the collation (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the collation (always the current database) + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the collation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the collation + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the default collation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the default collation + </para></entry> </row> <row> - <entry><literal>pad_attribute</literal></entry> - <entry><literal>character_data</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pad_attribute</structfield> <type>character_data</type> + </para> + <para> Always <literal>NO PAD</literal> (The alternative <literal>PAD SPACE</literal> is not supported by PostgreSQL.) - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -900,52 +1049,72 @@ </para> <table> - <title><literal>collation_character_set_applicability</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>collation_character_set_applicability</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the collation (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the collation (always the current database) + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the collation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the collation + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the default collation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the default collation + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Character sets are currently not implemented as schema objects, so this column is null</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Character sets are currently not implemented as schema objects, so this column is null + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Character sets are currently not implemented as schema objects, so this column is null</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Character sets are currently not implemented as schema objects, so this column is null + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the character set</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the character set + </para></entry> </row> </tbody> </tgroup> @@ -962,46 +1131,63 @@ </para> <table> - <title><literal>column_column_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>column_column_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the base column that a generated column depends on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the base column that a generated column depends on + </para></entry> </row> <row> - <entry><literal>dependent_column</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the generated column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dependent_column</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the generated column + </para></entry> </row> </tbody> </tgroup> @@ -1018,58 +1204,81 @@ </para> <table> - <title><literal>column_domain_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>column_domain_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>domain_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the domain (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the domain (always the current database) + </para></entry> </row> <row> - <entry><literal>domain_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the domain + </para></entry> </row> <row> - <entry><literal>domain_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the domain + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column + </para></entry> </row> </tbody> </tgroup> @@ -1087,52 +1296,72 @@ </para> <table> - <title><literal>column_options</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>column_options</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the foreign table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the foreign table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the foreign table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign table + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column + </para></entry> </row> <row> - <entry><literal>option_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of an option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of an option + </para></entry> </row> <row> - <entry><literal>option_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>Value of the option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_value</structfield> <type>character_data</type> + </para> + <para> + Value of the option + </para></entry> </row> </tbody> </tgroup> @@ -1158,68 +1387,92 @@ </para> <table> - <title><literal>column_privileges</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>column_privileges</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the table that contains the column (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the table that contains the column (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table that contains the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table that contains the column + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table that contains the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table that contains the column + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> Type of the privilege: <literal>SELECT</literal>, <literal>INSERT</literal>, <literal>UPDATE</literal>, or <literal>REFERENCES</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -1238,68 +1491,85 @@ </para> <table> - <title><literal>column_udt_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>column_udt_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that the column data type (the underlying type of the domain, if applicable) is defined in (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that the column data type (the underlying type of the domain, if applicable) is defined in - </entry> + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the column data type (the underlying type of the domain, if applicable) - </entry> + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column + </para></entry> </row> </tbody> </tgroup> @@ -1318,69 +1588,91 @@ </para> <table> - <title><literal>columns</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>columns</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column + </para></entry> </row> <row> - <entry><literal>ordinal_position</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Ordinal position of the column within the table (count starts at 1)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordinal_position</structfield> <type>cardinal_number</type> + </para> + <para> + Ordinal position of the column within the table (count starts at 1) + </para></entry> </row> <row> - <entry><literal>column_default</literal></entry> - <entry><type>character_data</type></entry> - <entry>Default expression of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_default</structfield> <type>character_data</type> + </para> + <para> + Default expression of the column + </para></entry> </row> <row> - <entry><literal>is_nullable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_nullable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the column is possibly nullable, <literal>NO</literal> if it is known not nullable. A not-null constraint is one way a column can be known not nullable, but there can be others. - </entry> + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> Data type of the column, if it is a built-in type, or <literal>ARRAY</literal> if it is some array (in that case, see the view <literal>element_types</literal>), else @@ -1390,35 +1682,38 @@ refers to the type underlying the domain (and the domain is identified in <literal>domain_name</literal> and associated columns). - </entry> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a character or bit string type, the declared maximum length; null for all other data types or if no maximum length was declared. - </entry> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a character type, the maximum possible length in octets (bytes) of a datum; null for all other data types. The maximum octet length depends on the declared character maximum length (see above) and the server encoding. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a numeric type, this column contains the (declared or implicit) precision of the type for this column. The precision indicates the number of @@ -1426,25 +1721,27 @@ or binary (base 2) terms, as specified in the column <literal>numeric_precision_radix</literal>. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a numeric type, this column indicates in which base the values in the columns <literal>numeric_precision</literal> and <literal>numeric_scale</literal> are expressed. The value is either 2 or 10. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies an exact numeric type, this column contains the (declared or implicit) scale of the type for this column. The scale indicates the number of @@ -1453,26 +1750,28 @@ specified in the column <literal>numeric_precision_radix</literal>. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a date, time, timestamp, or interval type, this column contains the (declared or implicit) fractional seconds precision of the type for this column, that is, the number of decimal digits maintained following the decimal point in the seconds value. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> If <literal>data_type</literal> identifies an interval type, this column contains the specification which fields the intervals include for this column, e.g., <literal>YEAR TO @@ -1480,253 +1779,300 @@ field restrictions were specified (that is, the interval accepts all fields), and for all other data types, this field is null. - </entry> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> Applies to a feature not available in <productname>PostgreSQL</productname> (see <literal>datetime_precision</literal> for the fractional seconds precision of interval type columns) - </entry> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database containing the collation of the column (always the current database), null if default or the data type of the column is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema containing the collation of the column, null if default or the data type of the column is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the collation of the column, null if default or the data type of the column is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>domain_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_catalog</structfield> <type>sql_identifier</type> + </para> + <para> If the column has a domain type, the name of the database that the domain is defined in (always the current database), else null. - </entry> + </para></entry> </row> <row> - <entry><literal>domain_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_schema</structfield> <type>sql_identifier</type> + </para> + <para> If the column has a domain type, the name of the schema that the domain is defined in, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>domain_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>If the column has a domain type, the name of the domain, else null.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_name</structfield> <type>sql_identifier</type> + </para> + <para> + If the column has a domain type, the name of the domain, else null. + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that the column data type (the underlying type of the domain, if applicable) is defined in (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that the column data type (the underlying type of the domain, if applicable) is defined in - </entry> + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the column data type (the underlying type of the domain, if applicable) - </entry> + </para></entry> </row> <row> - <entry><literal>scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> An identifier of the data type descriptor of the column, unique among the data type descriptors pertaining to the table. This is mainly useful for joining with other instances of such identifiers. (The specific format of the identifier is not defined and not guaranteed to remain the same in future versions.) - </entry> + </para></entry> </row> <row> - <entry><literal>is_self_referencing</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_self_referencing</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>is_identity</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_identity</structfield> <type>yes_or_no</type> + </para> + <para> If the column is an identity column, then <literal>YES</literal>, else <literal>NO</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>identity_generation</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>identity_generation</structfield> <type>character_data</type> + </para> + <para> If the column is an identity column, then <literal>ALWAYS</literal> or <literal>BY DEFAULT</literal>, reflecting the definition of the column. - </entry> + </para></entry> </row> <row> - <entry><literal>identity_start</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>identity_start</structfield> <type>character_data</type> + </para> + <para> If the column is an identity column, then the start value of the internal sequence, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>identity_increment</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>identity_increment</structfield> <type>character_data</type> + </para> + <para> If the column is an identity column, then the increment of the internal sequence, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>identity_maximum</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>identity_maximum</structfield> <type>character_data</type> + </para> + <para> If the column is an identity column, then the maximum value of the internal sequence, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>identity_minimum</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>identity_minimum</structfield> <type>character_data</type> + </para> + <para> If the column is an identity column, then the minimum value of the internal sequence, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>identity_cycle</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>identity_cycle</structfield> <type>yes_or_no</type> + </para> + <para> If the column is an identity column, then <literal>YES</literal> if the internal sequence cycles or <literal>NO</literal> if it does not; otherwise null. - </entry> + </para></entry> </row> <row> - <entry><literal>is_generated</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_generated</structfield> <type>character_data</type> + </para> + <para> If the column is a generated column, then <literal>ALWAYS</literal>, else <literal>NEVER</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>generation_expression</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>generation_expression</structfield> <type>character_data</type> + </para> + <para> If the column is a generated column, then the generation expression, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>is_updatable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_updatable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the column is updatable, <literal>NO</literal> if not (Columns in base tables are always updatable, columns in views not necessarily) - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -1777,70 +2123,85 @@ </para> <table> - <title><literal>constraint_column_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>constraint_column_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that contains the column that is used by some constraint (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the table that contains the column that is used by some constraint - </entry> + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the table that contains the column that is used by some constraint - </entry> + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the column that is used by some constraint - </entry> + </para></entry> </row> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> </tbody> </tgroup> @@ -1864,58 +2225,74 @@ </para> <table> - <title><literal>constraint_table_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>constraint_table_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that is used by some constraint (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the table that is used by some constraint - </entry> + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table that is used by some constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table that is used by some constraint + </para></entry> </row> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> </tbody> </tgroup> @@ -1942,56 +2319,69 @@ </para> <table> - <title><literal>data_type_privileges</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>data_type_privileges</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>object_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the described object (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the described object (always the current database) + </para></entry> </row> <row> - <entry><literal>object_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the described object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the described object + </para></entry> </row> <row> - <entry><literal>object_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the described object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the described object + </para></entry> </row> <row> - <entry><literal>object_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_type</structfield> <type>character_data</type> + </para> + <para> The type of the described object: one of <literal>TABLE</literal> (the data type descriptor pertains to a column of that table), <literal>DOMAIN</literal> (the data type descriptors pertains to that domain), <literal>ROUTINE</literal> (the data type descriptor pertains to a parameter or the return data type of that function). - </entry> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> The identifier of the data type descriptor, which is unique among the data type descriptors for that same object. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2009,64 +2399,90 @@ </para> <table> - <title><literal>domain_constraints</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>domain_constraints</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> <row> - <entry><literal>domain_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the domain (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the domain (always the current database) + </para></entry> </row> <row> - <entry><literal>domain_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the domain + </para></entry> </row> <row> - <entry><literal>domain_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the domain + </para></entry> </row> <row> - <entry><literal>is_deferrable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the constraint is deferrable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_deferrable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the constraint is deferrable, <literal>NO</literal> if not + </para></entry> </row> <row> - <entry><literal>initially_deferred</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the constraint is deferrable and initially deferred, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>initially_deferred</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the constraint is deferrable and initially deferred, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -2085,52 +2501,72 @@ </para> <table> - <title><literal>domain_udt_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>domain_udt_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the domain data type is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the domain data type is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that the domain data type is defined in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that the domain data type is defined in + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the domain data type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the domain data type + </para></entry> </row> <row> - <entry><literal>domain_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the domain (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the domain (always the current database) + </para></entry> </row> <row> - <entry><literal>domain_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the domain + </para></entry> </row> <row> - <entry><literal>domain_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the domain + </para></entry> </row> </tbody> </tgroup> @@ -2147,120 +2583,147 @@ </para> <table> - <title><literal>domains</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>domains</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>domain_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the domain (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the domain (always the current database) + </para></entry> </row> <row> - <entry><literal>domain_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the domain + </para></entry> </row> <row> - <entry><literal>domain_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the domain + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> Data type of the domain, if it is a built-in type, or <literal>ARRAY</literal> if it is some array (in that case, see the view <literal>element_types</literal>), else <literal>USER-DEFINED</literal> (in that case, the type is identified in <literal>udt_name</literal> and associated columns). - </entry> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> If the domain has a character or bit string type, the declared maximum length; null for all other data types or if no maximum length was declared. - </entry> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> If the domain has a character type, the maximum possible length in octets (bytes) of a datum; null for all other data types. The maximum octet length depends on the declared character maximum length (see above) and the server encoding. - </entry> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database containing the collation of the domain (always the current database), null if default or the data type of the domain is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema containing the collation of the domain, null if default or the data type of the domain is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the collation of the domain, null if default or the data type of the domain is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> If the domain has a numeric type, this column contains the (declared or implicit) precision of the type for this domain. The precision indicates the number of significant digits. It @@ -2268,25 +2731,27 @@ as specified in the column <literal>numeric_precision_radix</literal>. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> If the domain has a numeric type, this column indicates in which base the values in the columns <literal>numeric_precision</literal> and <literal>numeric_scale</literal> are expressed. The value is either 2 or 10. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> If the domain has an exact numeric type, this column contains the (declared or implicit) scale of the type for this domain. The scale indicates the number of significant digits to the @@ -2294,26 +2759,28 @@ (base 10) or binary (base 2) terms, as specified in the column <literal>numeric_precision_radix</literal>. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> If <literal>data_type</literal> identifies a date, time, timestamp, or interval type, this column contains the (declared or implicit) fractional seconds precision of the type for this domain, that is, the number of decimal digits maintained following the decimal point in the seconds value. For all other data types, this column is null. - </entry> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> If <literal>data_type</literal> identifies an interval type, this column contains the specification which fields the intervals include for this domain, e.g., <literal>YEAR TO @@ -2321,72 +2788,98 @@ field restrictions were specified (that is, the interval accepts all fields), and for all other data types, this field is null. - </entry> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> Applies to a feature not available in <productname>PostgreSQL</productname> (see <literal>datetime_precision</literal> for the fractional seconds precision of interval type domains) - </entry> + </para></entry> </row> <row> - <entry><literal>domain_default</literal></entry> - <entry><type>character_data</type></entry> - <entry>Default expression of the domain</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_default</structfield> <type>character_data</type> + </para> + <para> + Default expression of the domain + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the domain data type is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the domain data type is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that the domain data type is defined in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that the domain data type is defined in + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the domain data type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the domain data type + </para></entry> </row> <row> - <entry><literal>scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> An identifier of the data type descriptor of the domain, unique among the data type descriptors pertaining to the domain (which is trivial, because a domain only contains one data type @@ -2394,7 +2887,7 @@ instances of such identifiers. (The specific format of the identifier is not defined and not guaranteed to remain the same in future versions.) - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2427,48 +2920,54 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>element_types</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>element_types</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>object_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the object that uses the array being described (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>object_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the object that uses the array being described - </entry> + </para></entry> </row> <row> - <entry><literal>object_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the object that uses the array being described - </entry> + </para></entry> </row> <row> - <entry><literal>object_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_type</structfield> <type>character_data</type> + </para> + <para> The type of the object that uses the array being described: one of <literal>TABLE</literal> (the array is used by a column of that table), <literal>USER-DEFINED TYPE</literal> (the array is @@ -2476,189 +2975,246 @@ ORDER BY c.ordinal_position; <literal>DOMAIN</literal> (the array is used by that domain), <literal>ROUTINE</literal> (the array is used by a parameter or the return data type of that function). - </entry> + </para></entry> </row> <row> - <entry><literal>collection_type_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collection_type_identifier</structfield> <type>sql_identifier</type> + </para> + <para> The identifier of the data type descriptor of the array being described. Use this to join with the <literal>dtd_identifier</literal> columns of other information schema views. - </entry> + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> Data type of the array elements, if it is a built-in type, else <literal>USER-DEFINED</literal> (in that case, the type is identified in <literal>udt_name</literal> and associated columns). - </entry> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database containing the collation of the element type (always the current database), null if default or the data type of the element is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema containing the collation of the element type, null if default or the data type of the element is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the collation of the element type, null if default or the data type of the element is not collatable - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to array element data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>domain_default</literal></entry> - <entry><type>character_data</type></entry> - <entry>Not yet implemented</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>domain_default</structfield> <type>character_data</type> + </para> + <para> + Not yet implemented + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that the data type of the elements is defined in (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that the data type of the elements is defined in - </entry> + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the data type of the elements - </entry> + </para></entry> </row> <row> - <entry><literal>scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> An identifier of the data type descriptor of the element. This is currently not useful. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -2689,22 +3245,27 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>enabled_roles</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>enabled_roles</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>role_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of a role</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>role_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of a role + </para></entry> </row> </tbody> </tgroup> @@ -2723,40 +3284,54 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>foreign_data_wrapper_options</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>foreign_data_wrapper_options</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>foreign_data_wrapper_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign-data wrapper is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign-data wrapper is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_data_wrapper_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign-data wrapper</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign-data wrapper + </para></entry> </row> <row> - <entry><literal>option_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of an option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of an option + </para></entry> </row> <row> - <entry><literal>option_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>Value of the option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_value</structfield> <type>character_data</type> + </para> + <para> + Value of the option + </para></entry> </row> </tbody> </tgroup> @@ -2774,47 +3349,64 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>foreign_data_wrappers</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>foreign_data_wrappers</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>foreign_data_wrapper_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the foreign-data - wrapper (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the foreign-data + wrapper (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_data_wrapper_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign-data wrapper</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign-data wrapper + </para></entry> </row> <row> - <entry><literal>authorization_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the owner of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>authorization_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the owner of the foreign server + </para></entry> </row> <row> - <entry><literal>library_name</literal></entry> - <entry><type>character_data</type></entry> - <entry>File name of the library that implementing this foreign-data wrapper</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>library_name</structfield> <type>character_data</type> + </para> + <para> + File name of the library that implementing this foreign-data wrapper + </para></entry> </row> <row> - <entry><literal>foreign_data_wrapper_language</literal></entry> - <entry><type>character_data</type></entry> - <entry>Language used to implement this foreign-data wrapper</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_language</structfield> <type>character_data</type> + </para> + <para> + Language used to implement this foreign-data wrapper + </para></entry> </row> </tbody> </tgroup> @@ -2832,40 +3424,54 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>foreign_server_options</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>foreign_server_options</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>foreign_server_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign server is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign server is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_server_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign server + </para></entry> </row> <row> - <entry><literal>option_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of an option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of an option + </para></entry> </row> <row> - <entry><literal>option_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>Value of the option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_value</structfield> <type>character_data</type> + </para> + <para> + Value of the option + </para></entry> </row> </tbody> </tgroup> @@ -2883,59 +3489,82 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>foreign_servers</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>foreign_servers</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>foreign_server_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign server is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign server is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_server_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign server + </para></entry> </row> <row> - <entry><literal>foreign_data_wrapper_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the foreign-data - wrapper used by the foreign server (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the foreign-data + wrapper used by the foreign server (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_data_wrapper_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign-data wrapper used by the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_data_wrapper_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign-data wrapper used by the foreign server + </para></entry> </row> <row> - <entry><literal>foreign_server_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Foreign server type information, if specified upon creation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_type</structfield> <type>character_data</type> + </para> + <para> + Foreign server type information, if specified upon creation + </para></entry> </row> <row> - <entry><literal>foreign_server_version</literal></entry> - <entry><type>character_data</type></entry> - <entry>Foreign server version information, if specified upon creation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_version</structfield> <type>character_data</type> + </para> + <para> + Foreign server version information, if specified upon creation + </para></entry> </row> <row> - <entry><literal>authorization_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the owner of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>authorization_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the owner of the foreign server + </para></entry> </row> </tbody> </tgroup> @@ -2953,46 +3582,63 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>foreign_table_options</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>foreign_table_options</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>foreign_table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the foreign table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the foreign table (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the foreign table + </para></entry> </row> <row> - <entry><literal>foreign_table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign table + </para></entry> </row> <row> - <entry><literal>option_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of an option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of an option + </para></entry> </row> <row> - <entry><literal>option_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>Value of the option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_value</structfield> <type>character_data</type> + </para> + <para> + Value of the option + </para></entry> </row> </tbody> </tgroup> @@ -3010,46 +3656,63 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>foreign_tables</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>foreign_tables</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>foreign_table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign table is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign table is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the foreign table + </para></entry> </row> <row> - <entry><literal>foreign_table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign table + </para></entry> </row> <row> - <entry><literal>foreign_server_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign server is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign server is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_server_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign server</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign server + </para></entry> </row> </tbody> </tgroup> @@ -3068,89 +3731,106 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>key_column_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>key_column_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that contains the column that is restricted by this constraint (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the table that contains the column that is restricted by this constraint - </entry> + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the table that contains the column that is restricted by this constraint - </entry> + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the column that is restricted by this constraint - </entry> + </para></entry> </row> <row> - <entry><literal>ordinal_position</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordinal_position</structfield> <type>cardinal_number</type> + </para> + <para> Ordinal position of the column within the constraint key (count starts at 1) - </entry> + </para></entry> </row> <row> - <entry><literal>position_in_unique_constraint</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>position_in_unique_constraint</structfield> <type>cardinal_number</type> + </para> + <para> For a foreign-key constraint, ordinal position of the referenced column within its unique constraint (count starts at 1); otherwise null - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3168,243 +3848,322 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>parameters</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>parameters</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> - The <quote>specific name</quote> of the function. See <xref - linkend="infoschema-routines"/> for more information. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + The <quote>specific name</quote> of the function. See <xref linkend="infoschema-routines"/> for more information. + </para></entry> </row> <row> - <entry><literal>ordinal_position</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordinal_position</structfield> <type>cardinal_number</type> + </para> + <para> Ordinal position of the parameter in the argument list of the function (count starts at 1) - </entry> + </para></entry> </row> <row> - <entry><literal>parameter_mode</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>parameter_mode</structfield> <type>character_data</type> + </para> + <para> <literal>IN</literal> for input parameter, <literal>OUT</literal> for output parameter, and <literal>INOUT</literal> for input/output parameter. - </entry> + </para></entry> </row> <row> - <entry><literal>is_result</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_result</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>as_locator</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>as_locator</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>parameter_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the parameter, or null if the parameter has no name</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>parameter_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the parameter, or null if the parameter has no name + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> Data type of the parameter, if it is a built-in type, or <literal>ARRAY</literal> if it is some array (in that case, see the view <literal>element_types</literal>), else <literal>USER-DEFINED</literal> (in that case, the type is identified in <literal>udt_name</literal> and associated columns). - </entry> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to parameter data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that the data type of the parameter is defined in (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that the data type of the parameter is defined in - </entry> + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the data type of the parameter - </entry> + </para></entry> </row> <row> - <entry><literal>scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> An identifier of the data type descriptor of the parameter, unique among the data type descriptors pertaining to the function. This is mainly useful for joining with other instances of such identifiers. (The specific format of the identifier is not defined and not guaranteed to remain the same in future versions.) - </entry> + </para></entry> </row> <row> - <entry><literal>parameter_default</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>parameter_default</structfield> <type>character_data</type> + </para> + <para> The default expression of the parameter, or null if none or if the function is not owned by a currently enabled role. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3423,94 +4182,111 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>referential_constraints</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>referential_constraints</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> <row> - <entry><literal>unique_constraint_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>unique_constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the unique or primary key constraint that the foreign key constraint references (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>unique_constraint_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>unique_constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the unique or primary key constraint that the foreign key constraint references - </entry> + </para></entry> </row> <row> - <entry><literal>unique_constraint_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>unique_constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the unique or primary key constraint that the foreign key constraint references - </entry> + </para></entry> </row> <row> - <entry><literal>match_option</literal></entry> - <entry><literal>character_data</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>match_option</structfield> <type>character_data</type> + </para> + <para> Match option of the foreign key constraint: <literal>FULL</literal>, <literal>PARTIAL</literal>, or <literal>NONE</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>update_rule</literal></entry> - <entry><literal>character_data</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>update_rule</structfield> <type>character_data</type> + </para> + <para> Update rule of the foreign key constraint: <literal>CASCADE</literal>, <literal>SET NULL</literal>, <literal>SET DEFAULT</literal>, <literal>RESTRICT</literal>, or <literal>NO ACTION</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>delete_rule</literal></entry> - <entry><literal>character_data</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>delete_rule</structfield> <type>character_data</type> + </para> + <para> Delete rule of the foreign key constraint: <literal>CASCADE</literal>, <literal>SET NULL</literal>, <literal>SET DEFAULT</literal>, <literal>RESTRICT</literal>, or <literal>NO ACTION</literal>. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3533,68 +4309,92 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>role_column_grants</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>role_column_grants</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the table that contains the column (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the table that contains the column (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table that contains the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table that contains the column + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table that contains the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table that contains the column + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> Type of the privilege: <literal>SELECT</literal>, <literal>INSERT</literal>, <literal>UPDATE</literal>, or <literal>REFERENCES</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -3616,79 +4416,108 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>role_routine_grants</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>role_routine_grants</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> - The <quote>specific name</quote> of the function. See <xref - linkend="infoschema-routines"/> for more information. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + The <quote>specific name</quote> of the function. See <xref linkend="infoschema-routines"/> for more information. + </para></entry> </row> <row> - <entry><literal>routine_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>routine_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>routine_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the function (might be duplicated in case of overloading)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the function (might be duplicated in case of overloading) + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always <literal>EXECUTE</literal> (the only privilege type for functions)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> + Always <literal>EXECUTE</literal> (the only privilege type for functions) + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -3710,76 +4539,98 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>role_table_grants</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>role_table_grants</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> Type of the privilege: <literal>SELECT</literal>, <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>, <literal>TRUNCATE</literal>, <literal>REFERENCES</literal>, or <literal>TRIGGER</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> <row> - <entry><literal>with_hierarchy</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>with_hierarchy</structfield> <type>yes_or_no</type> + </para> + <para> In the SQL standard, <literal>WITH HIERARCHY OPTION</literal> is a separate (sub-)privilege allowing certain operations on table inheritance hierarchies. In PostgreSQL, this is included in the <literal>SELECT</literal> privilege, so this column shows <literal>YES</literal> if the privilege is <literal>SELECT</literal>, else <literal>NO</literal>. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -3803,58 +4654,81 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>role_udt_grants</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>role_udt_grants</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>The name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + The name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>The name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + The name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the type (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the type (always the current database) + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the type + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the type + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always <literal>TYPE USAGE</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> + Always <literal>TYPE USAGE</literal> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -3876,65 +4750,91 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>role_usage_grants</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>role_usage_grants</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>The name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + The name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>The name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + The name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>object_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the object (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the object (always the current database) + </para></entry> </row> <row> - <entry><literal>object_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the object, if applicable, - else an empty string</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the object, if applicable, + else an empty string + </para></entry> </row> <row> - <entry><literal>object_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the object + </para></entry> </row> <row> - <entry><literal>object_type</literal></entry> - <entry><type>character_data</type></entry> - <entry><literal>COLLATION</literal> or <literal>DOMAIN</literal> or <literal>FOREIGN DATA WRAPPER</literal> or <literal>FOREIGN SERVER</literal> or <literal>SEQUENCE</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_type</structfield> <type>character_data</type> + </para> + <para> + <literal>COLLATION</literal> or <literal>DOMAIN</literal> or <literal>FOREIGN DATA WRAPPER</literal> or <literal>FOREIGN SERVER</literal> or <literal>SEQUENCE</literal> + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always <literal>USAGE</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> + Always <literal>USAGE</literal> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -3952,79 +4852,108 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>routine_privileges</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>routine_privileges</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> - The <quote>specific name</quote> of the function. See <xref - linkend="infoschema-routines"/> for more information. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + The <quote>specific name</quote> of the function. See <xref linkend="infoschema-routines"/> for more information. + </para></entry> </row> <row> - <entry><literal>routine_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>routine_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>routine_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the function (might be duplicated in case of overloading)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the function (might be duplicated in case of overloading) + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always <literal>EXECUTE</literal> (the only privilege type for functions)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> + Always <literal>EXECUTE</literal> (the only privilege type for functions) + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -4042,278 +4971,376 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>routines</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>routines</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> The <quote>specific name</quote> of the function. This is a name that uniquely identifies the function in the schema, even if the real name of the function is overloaded. The format of the specific name is not defined, it should only be used to compare it to other instances of specific routine names. - </entry> + </para></entry> </row> <row> - <entry><literal>routine_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>routine_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>routine_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the function (might be duplicated in case of overloading)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the function (might be duplicated in case of overloading) + </para></entry> </row> <row> - <entry><literal>routine_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_type</structfield> <type>character_data</type> + </para> + <para> <literal>FUNCTION</literal> for a function, <literal>PROCEDURE</literal> for a procedure - </entry> + </para></entry> </row> <row> - <entry><literal>module_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>module_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>module_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>module_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>module_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>module_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> Return data type of the function, if it is a built-in type, or <literal>ARRAY</literal> if it is some array (in that case, see the view <literal>element_types</literal>), else <literal>USER-DEFINED</literal> (in that case, the type is identified in <literal>type_udt_name</literal> and associated columns). Null for a procedure. - </entry> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, since this information is not applied to return data types in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>type_udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>type_udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that the return data type of the function is defined in (always the current database). Null for a procedure. - </entry> + </para></entry> </row> <row> - <entry><literal>type_udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>type_udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that the return data type of the function is defined in. Null for a procedure. - </entry> + </para></entry> </row> <row> - <entry><literal>type_udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>type_udt_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the return data type of the function. Null for a procedure. - </entry> + </para></entry> </row> <row> - <entry><literal>scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Always null, because arrays always have unlimited maximum cardinality in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> An identifier of the data type descriptor of the return data type of this function, unique among the data type descriptors pertaining to the function. This is mainly useful for joining with other instances of such identifiers. (The specific format of the identifier is not defined and not guaranteed to remain the same in future versions.) - </entry> + </para></entry> </row> <row> - <entry><literal>routine_body</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_body</structfield> <type>character_data</type> + </para> + <para> If the function is an SQL function, then <literal>SQL</literal>, else <literal>EXTERNAL</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>routine_definition</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>routine_definition</structfield> <type>character_data</type> + </para> + <para> The source text of the function (null if the function is not owned by a currently enabled role). (According to the SQL standard, this column is only applicable if @@ -4321,305 +5348,421 @@ ORDER BY c.ordinal_position; in <productname>PostgreSQL</productname> it will contain whatever source text was specified when the function was created.) - </entry> + </para></entry> </row> <row> - <entry><literal>external_name</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>external_name</structfield> <type>character_data</type> + </para> + <para> If this function is a C function, then the external name (link symbol) of the function; else null. (This works out to be the same value that is shown in <literal>routine_definition</literal>.) - </entry> + </para></entry> </row> <row> - <entry><literal>external_language</literal></entry> - <entry><type>character_data</type></entry> - <entry>The language the function is written in</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>external_language</structfield> <type>character_data</type> + </para> + <para> + The language the function is written in + </para></entry> </row> <row> - <entry><literal>parameter_style</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>parameter_style</structfield> <type>character_data</type> + </para> + <para> Always <literal>GENERAL</literal> (The SQL standard defines other parameter styles, which are not available in <productname>PostgreSQL</productname>.) - </entry> + </para></entry> </row> <row> - <entry><literal>is_deterministic</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_deterministic</structfield> <type>yes_or_no</type> + </para> + <para> If the function is declared immutable (called deterministic in the SQL standard), then <literal>YES</literal>, else <literal>NO</literal>. (You cannot query the other volatility levels available in <productname>PostgreSQL</productname> through the information schema.) - </entry> + </para></entry> </row> <row> - <entry><literal>sql_data_access</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sql_data_access</structfield> <type>character_data</type> + </para> + <para> Always <literal>MODIFIES</literal>, meaning that the function possibly modifies SQL data. This information is not useful for <productname>PostgreSQL</productname>. - </entry> + </para></entry> </row> <row> - <entry><literal>is_null_call</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_null_call</structfield> <type>yes_or_no</type> + </para> + <para> If the function automatically returns null if any of its arguments are null, then <literal>YES</literal>, else <literal>NO</literal>. Null for a procedure. - </entry> + </para></entry> </row> <row> - <entry><literal>sql_path</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sql_path</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>schema_level_routine</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schema_level_routine</structfield> <type>yes_or_no</type> + </para> + <para> Always <literal>YES</literal> (The opposite would be a method of a user-defined type, which is a feature not available in <productname>PostgreSQL</productname>.) - </entry> + </para></entry> </row> <row> - <entry><literal>max_dynamic_result_sets</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>max_dynamic_result_sets</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>is_user_defined_cast</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_user_defined_cast</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>is_implicitly_invocable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_implicitly_invocable</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>security_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>security_type</structfield> <type>character_data</type> + </para> + <para> If the function runs with the privileges of the current user, then <literal>INVOKER</literal>, if the function runs with the privileges of the user who defined it, then <literal>DEFINER</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>to_sql_specific_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>to_sql_specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>to_sql_specific_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>to_sql_specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>to_sql_specific_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>to_sql_specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>as_locator</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>as_locator</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>created</literal></entry> - <entry><type>time_stamp</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>created</structfield> <type>time_stamp</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>last_altered</literal></entry> - <entry><type>time_stamp</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_altered</structfield> <type>time_stamp</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>new_savepoint_level</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>new_savepoint_level</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>is_udt_dependent</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_udt_dependent</structfield> <type>yes_or_no</type> + </para> + <para> Currently always <literal>NO</literal>. The alternative <literal>YES</literal> applies to a feature not available in <productname>PostgreSQL</productname>. - </entry> + </para></entry> </row> <row> - <entry><literal>result_cast_from_data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_from_data_type</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_as_locator</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_as_locator</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_char_max_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_char_max_length</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_char_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_char_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_char_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_char_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_char_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_char_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_char_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_char_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_collation_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_interval_type</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_type_udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_type_udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_type_udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_type_udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_type_udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_type_udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_scope_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_scope_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_scope_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_scope_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_scope_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_scope_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_maximum_cardinality</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_maximum_cardinality</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>result_cast_dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>result_cast_dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> </tbody> </tgroup> @@ -4636,58 +5779,81 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>schemata</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>schemata</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>catalog_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the schema is contained in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>catalog_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the schema is contained in (always the current database) + </para></entry> </row> <row> - <entry><literal>schema_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schema_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema + </para></entry> </row> <row> - <entry><literal>schema_owner</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the owner of the schema</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schema_owner</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the owner of the schema + </para></entry> </row> <row> - <entry><literal>default_character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>default_character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>default_character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>default_character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>sql_path</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sql_path</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> </tbody> </tgroup> @@ -4705,108 +5871,138 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>sequences</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>sequences</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>sequence_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the sequence (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sequence_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the sequence (always the current database) + </para></entry> </row> <row> - <entry><literal>sequence_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sequence_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the sequence + </para></entry> </row> <row> - <entry><literal>sequence_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sequence_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the sequence + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> The data type of the sequence. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> This column contains the (declared or implicit) precision of the sequence data type (see above). The precision indicates the number of significant digits. It can be expressed in decimal (base 10) or binary (base 2) terms, as specified in the column <literal>numeric_precision_radix</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> This column indicates in which base the values in the columns <literal>numeric_precision</literal> and <literal>numeric_scale</literal> are expressed. The value is either 2 or 10. - </entry> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> This column contains the (declared or implicit) scale of the sequence data type (see above). The scale indicates the number of significant digits to the right of the decimal point. It can be expressed in decimal (base 10) or binary (base 2) terms, as specified in the column <literal>numeric_precision_radix</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>start_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>The start value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>start_value</structfield> <type>character_data</type> + </para> + <para> + The start value of the sequence + </para></entry> </row> <row> - <entry><literal>minimum_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>The minimum value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>minimum_value</structfield> <type>character_data</type> + </para> + <para> + The minimum value of the sequence + </para></entry> </row> <row> - <entry><literal>maximum_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>The maximum value of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maximum_value</structfield> <type>character_data</type> + </para> + <para> + The maximum value of the sequence + </para></entry> </row> <row> - <entry><literal>increment</literal></entry> - <entry><type>character_data</type></entry> - <entry>The increment of the sequence</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>increment</structfield> <type>character_data</type> + </para> + <para> + The increment of the sequence + </para></entry> </row> <row> - <entry><literal>cycle_option</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the sequence cycles, else <literal>NO</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cycle_option</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the sequence cycles, else <literal>NO</literal> + </para></entry> </row> </tbody> </tgroup> @@ -4830,64 +6026,83 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>sql_features</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>sql_features</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>feature_id</literal></entry> - <entry><type>character_data</type></entry> - <entry>Identifier string of the feature</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>feature_id</structfield> <type>character_data</type> + </para> + <para> + Identifier string of the feature + </para></entry> </row> <row> - <entry><literal>feature_name</literal></entry> - <entry><type>character_data</type></entry> - <entry>Descriptive name of the feature</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>feature_name</structfield> <type>character_data</type> + </para> + <para> + Descriptive name of the feature + </para></entry> </row> <row> - <entry><literal>sub_feature_id</literal></entry> - <entry><type>character_data</type></entry> - <entry>Identifier string of the subfeature, or a zero-length string if not a subfeature</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sub_feature_id</structfield> <type>character_data</type> + </para> + <para> + Identifier string of the subfeature, or a zero-length string if not a subfeature + </para></entry> </row> <row> - <entry><literal>sub_feature_name</literal></entry> - <entry><type>character_data</type></entry> - <entry>Descriptive name of the subfeature, or a zero-length string if not a subfeature</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sub_feature_name</structfield> <type>character_data</type> + </para> + <para> + Descriptive name of the subfeature, or a zero-length string if not a subfeature + </para></entry> </row> <row> - <entry><literal>is_supported</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_supported</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the feature is fully supported by the current version of <productname>PostgreSQL</productname>, <literal>NO</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_verified_by</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_verified_by</structfield> <type>character_data</type> + </para> + <para> Always null, since the <productname>PostgreSQL</productname> development group does not perform formal testing of feature conformance - </entry> + </para></entry> </row> <row> - <entry><literal>comments</literal></entry> - <entry><type>character_data</type></entry> - <entry>Possibly a comment about the supported status of the feature</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>comments</structfield> <type>character_data</type> + </para> + <para> + Possibly a comment about the supported status of the feature + </para></entry> </row> </tbody> </tgroup> @@ -4909,54 +6124,67 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>sql_implementation_info</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>sql_implementation_info</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>implementation_info_id</literal></entry> - <entry><type>character_data</type></entry> - <entry>Identifier string of the implementation information item</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>implementation_info_id</structfield> <type>character_data</type> + </para> + <para> + Identifier string of the implementation information item + </para></entry> </row> <row> - <entry><literal>implementation_info_name</literal></entry> - <entry><type>character_data</type></entry> - <entry>Descriptive name of the implementation information item</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>implementation_info_name</structfield> <type>character_data</type> + </para> + <para> + Descriptive name of the implementation information item + </para></entry> </row> <row> - <entry><literal>integer_value</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>integer_value</structfield> <type>cardinal_number</type> + </para> + <para> Value of the implementation information item, or null if the value is contained in the column <literal>character_value</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>character_value</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_value</structfield> <type>character_data</type> + </para> + <para> Value of the implementation information item, or null if the value is contained in the column <literal>integer_value</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>comments</literal></entry> - <entry><type>character_data</type></entry> - <entry>Possibly a comment pertaining to the implementation information item</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>comments</structfield> <type>character_data</type> + </para> + <para> + Possibly a comment pertaining to the implementation information item + </para></entry> </row> </tbody> </tgroup> @@ -4973,53 +6201,66 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>sql_parts</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>sql_parts</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>feature_id</literal></entry> - <entry><type>character_data</type></entry> - <entry>An identifier string containing the number of the part</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>feature_id</structfield> <type>character_data</type> + </para> + <para> + An identifier string containing the number of the part + </para></entry> </row> <row> - <entry><literal>feature_name</literal></entry> - <entry><type>character_data</type></entry> - <entry>Descriptive name of the part</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>feature_name</structfield> <type>character_data</type> + </para> + <para> + Descriptive name of the part + </para></entry> </row> <row> - <entry><literal>is_supported</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_supported</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the part is fully supported by the current version of <productname>PostgreSQL</productname>, <literal>NO</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_verified_by</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_verified_by</structfield> <type>character_data</type> + </para> + <para> Always null, since the <productname>PostgreSQL</productname> development group does not perform formal testing of feature conformance - </entry> + </para></entry> </row> <row> - <entry><literal>comments</literal></entry> - <entry><type>character_data</type></entry> - <entry>Possibly a comment about the supported status of the part</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>comments</structfield> <type>character_data</type> + </para> + <para> + Possibly a comment about the supported status of the part + </para></entry> </row> </tbody> </tgroup> @@ -5041,44 +6282,56 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>sql_sizing</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>sql_sizing</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>sizing_id</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Identifier of the sizing item</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sizing_id</structfield> <type>cardinal_number</type> + </para> + <para> + Identifier of the sizing item + </para></entry> </row> <row> - <entry><literal>sizing_name</literal></entry> - <entry><type>character_data</type></entry> - <entry>Descriptive name of the sizing item</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sizing_name</structfield> <type>character_data</type> + </para> + <para> + Descriptive name of the sizing item + </para></entry> </row> <row> - <entry><literal>supported_value</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>supported_value</structfield> <type>cardinal_number</type> + </para> + <para> Value of the sizing item, or 0 if the size is unlimited or cannot be determined, or null if the features for which the sizing item is applicable are not supported - </entry> + </para></entry> </row> <row> - <entry><literal>comments</literal></entry> - <entry><type>character_data</type></entry> - <entry>Possibly a comment pertaining to the sizing item</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>comments</structfield> <type>character_data</type> + </para> + <para> + Possibly a comment pertaining to the sizing item + </para></entry> </row> </tbody> </tgroup> @@ -5095,81 +6348,112 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>table_constraints</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>table_constraints</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>constraint_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the constraint (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the constraint (always the current database) + </para></entry> </row> <row> - <entry><literal>constraint_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the constraint + </para></entry> </row> <row> - <entry><literal>constraint_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the constraint</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the constraint + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>constraint_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>constraint_type</structfield> <type>character_data</type> + </para> + <para> Type of the constraint: <literal>CHECK</literal>, <literal>FOREIGN KEY</literal>, <literal>PRIMARY KEY</literal>, or <literal>UNIQUE</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>is_deferrable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the constraint is deferrable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_deferrable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the constraint is deferrable, <literal>NO</literal> if not + </para></entry> </row> <row> - <entry><literal>initially_deferred</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the constraint is deferrable and initially deferred, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>initially_deferred</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the constraint is deferrable and initially deferred, <literal>NO</literal> if not + </para></entry> </row> + <row> - <entry><literal>enforced</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in - <productname>PostgreSQL</productname> (currently always - <literal>YES</literal>)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>enforced</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in + <productname>PostgreSQL</productname> (currently always + <literal>YES</literal>) + </para></entry> </row> </tbody> </tgroup> @@ -5187,76 +6471,98 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>table_privileges</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>table_privileges</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> Type of the privilege: <literal>SELECT</literal>, <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>, <literal>TRUNCATE</literal>, <literal>REFERENCES</literal>, or <literal>TRIGGER</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> <row> - <entry><literal>with_hierarchy</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>with_hierarchy</structfield> <type>yes_or_no</type> + </para> + <para> In the SQL standard, <literal>WITH HIERARCHY OPTION</literal> is a separate (sub-)privilege allowing certain operations on table inheritance hierarchies. In PostgreSQL, this is included in the <literal>SELECT</literal> privilege, so this column shows <literal>YES</literal> if the privilege is <literal>SELECT</literal>, else <literal>NO</literal>. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -5274,108 +6580,136 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>tables</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>tables</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the table (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the table (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table + </para></entry> </row> <row> - <entry><literal>table_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_type</structfield> <type>character_data</type> + </para> + <para> Type of the table: <literal>BASE TABLE</literal> for a persistent base table (the normal table type), <literal>VIEW</literal> for a view, <literal>FOREIGN</literal> for a foreign table, or <literal>LOCAL TEMPORARY</literal> for a temporary table - </entry> + </para></entry> </row> <row> - <entry><literal>self_referencing_column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>self_referencing_column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>reference_generation</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reference_generation</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>user_defined_type_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_catalog</structfield> <type>sql_identifier</type> + </para> + <para> If the table is a typed table, the name of the database that contains the underlying data type (always the current database), else null. - </entry> + </para></entry> </row> <row> - <entry><literal>user_defined_type_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_schema</structfield> <type>sql_identifier</type> + </para> + <para> If the table is a typed table, the name of the schema that contains the underlying data type, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>user_defined_type_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_name</structfield> <type>sql_identifier</type> + </para> + <para> If the table is a typed table, the name of the underlying data type, else null. - </entry> + </para></entry> </row> <row> - <entry><literal>is_insertable_into</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_insertable_into</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the table is insertable into, <literal>NO</literal> if not (Base tables are always insertable into, views not necessarily.) - </entry> + </para></entry> </row> <row> - <entry><literal>is_typed</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the table is a typed table, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_typed</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the table is a typed table, <literal>NO</literal> if not + </para></entry> </row> <row> - <entry><literal>commit_action</literal></entry> - <entry><type>character_data</type></entry> - <entry>Not yet implemented</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>commit_action</structfield> <type>character_data</type> + </para> + <para> + Not yet implemented + </para></entry> </row> </tbody> </tgroup> @@ -5393,74 +6727,93 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>transforms</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>transforms</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the type the transform is for (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the type the transform is for (always the current database) + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the type the transform is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the type the transform is for + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the type the transform is for</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the type the transform is for + </para></entry> </row> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> - The <quote>specific name</quote> of the function. See <xref - linkend="infoschema-routines"/> for more information. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + The <quote>specific name</quote> of the function. See <xref linkend="infoschema-routines"/> for more information. + </para></entry> </row> <row> - <entry><literal>group_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>group_name</structfield> <type>sql_identifier</type> + </para> + <para> The SQL standard allows defining transforms in <quote>groups</quote>, and selecting a group at run time. PostgreSQL does not support this. Instead, transforms are specific to a language. As a compromise, this field contains the language the transform is for. - </entry> + </para></entry> </row> <row> - <entry><literal>transform_type</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>transform_type</structfield> <type>character_data</type> + </para> + <para> <literal>FROM SQL</literal> or <literal>TO SQL</literal> - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -5481,61 +6834,82 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>triggered_update_columns</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>triggered_update_columns</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>trigger_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the trigger (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trigger_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the trigger (always the current database) + </para></entry> </row> <row> - <entry><literal>trigger_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the trigger</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trigger_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the trigger + </para></entry> </row> <row> - <entry><literal>trigger_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the trigger</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trigger_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the trigger + </para></entry> </row> <row> - <entry><literal>event_object_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that the trigger is defined on (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>event_object_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table that the trigger is defined on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table that the trigger is defined on + </para></entry> </row> <row> - <entry><literal>event_object_table</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table that the trigger is defined on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_table</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table that the trigger is defined on + </para></entry> </row> <row> - <entry><literal>event_object_column</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column that the trigger is defined on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_column</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column that the trigger is defined on + </para></entry> </row> </tbody> </tgroup> @@ -5552,146 +6926,185 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>triggers</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>triggers</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>trigger_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the trigger (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trigger_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the trigger (always the current database) + </para></entry> </row> <row> - <entry><literal>trigger_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the trigger</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trigger_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the trigger + </para></entry> </row> <row> - <entry><literal>trigger_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the trigger</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>trigger_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the trigger + </para></entry> </row> <row> - <entry><literal>event_manipulation</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_manipulation</structfield> <type>character_data</type> + </para> + <para> Event that fires the trigger (<literal>INSERT</literal>, <literal>UPDATE</literal>, or <literal>DELETE</literal>) - </entry> + </para></entry> </row> <row> - <entry><literal>event_object_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that the trigger is defined on (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>event_object_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the table that the trigger is defined on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the table that the trigger is defined on + </para></entry> </row> <row> - <entry><literal>event_object_table</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the table that the trigger is defined on</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>event_object_table</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the table that the trigger is defined on + </para></entry> </row> <row> - <entry><literal>action_order</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_order</structfield> <type>cardinal_number</type> + </para> + <para> Firing order among triggers on the same table having the same <literal>event_manipulation</literal>, <literal>action_timing</literal>, and <literal>action_orientation</literal>. In <productname>PostgreSQL</productname>, triggers are fired in name order, so this column reflects that. - </entry> + </para></entry> </row> <row> - <entry><literal>action_condition</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_condition</structfield> <type>character_data</type> + </para> + <para> <literal>WHEN</literal> condition of the trigger, null if none (also null if the table is not owned by a currently enabled role) - </entry> + </para></entry> </row> <row> - <entry><literal>action_statement</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_statement</structfield> <type>character_data</type> + </para> + <para> Statement that is executed by the trigger (currently always <literal>EXECUTE FUNCTION <replaceable>function</replaceable>(...)</literal>) - </entry> + </para></entry> </row> <row> - <entry><literal>action_orientation</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_orientation</structfield> <type>character_data</type> + </para> + <para> Identifies whether the trigger fires once for each processed row or once for each statement (<literal>ROW</literal> or <literal>STATEMENT</literal>) - </entry> + </para></entry> </row> <row> - <entry><literal>action_timing</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_timing</structfield> <type>character_data</type> + </para> + <para> Time at which the trigger fires (<literal>BEFORE</literal>, <literal>AFTER</literal>, or <literal>INSTEAD OF</literal>) - </entry> + </para></entry> </row> <row> - <entry><literal>action_reference_old_table</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the <quote>old</quote> transition table, or null if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_reference_old_table</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the <quote>old</quote> transition table, or null if none + </para></entry> </row> <row> - <entry><literal>action_reference_new_table</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the <quote>new</quote> transition table, or null if none</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_reference_new_table</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the <quote>new</quote> transition table, or null if none + </para></entry> </row> <row> - <entry><literal>action_reference_old_row</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_reference_old_row</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>action_reference_new_row</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>action_reference_new_row</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>created</literal></entry> - <entry><type>time_stamp</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>created</structfield> <type>time_stamp</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> </tbody> </tgroup> @@ -5758,58 +7171,81 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>udt_privileges</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>udt_privileges</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>udt_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the type (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the type (always the current database) + </para></entry> </row> <row> - <entry><literal>udt_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the type + </para></entry> </row> <row> - <entry><literal>udt_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>udt_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the type + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always <literal>TYPE USAGE</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> + Always <literal>TYPE USAGE</literal> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -5844,65 +7280,91 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>usage_privileges</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>usage_privileges</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>grantor</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that granted the privilege</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantor</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that granted the privilege + </para></entry> </row> <row> - <entry><literal>grantee</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the role that the privilege was granted to</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>grantee</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the role that the privilege was granted to + </para></entry> </row> <row> - <entry><literal>object_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database containing the object (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the object (always the current database) + </para></entry> </row> <row> - <entry><literal>object_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema containing the object, if applicable, - else an empty string</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the object, if applicable, + else an empty string + </para></entry> </row> <row> - <entry><literal>object_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the object</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the object + </para></entry> </row> <row> - <entry><literal>object_type</literal></entry> - <entry><type>character_data</type></entry> - <entry><literal>COLLATION</literal> or <literal>DOMAIN</literal> or <literal>FOREIGN DATA WRAPPER</literal> or <literal>FOREIGN SERVER</literal> or <literal>SEQUENCE</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>object_type</structfield> <type>character_data</type> + </para> + <para> + <literal>COLLATION</literal> or <literal>DOMAIN</literal> or <literal>FOREIGN DATA WRAPPER</literal> or <literal>FOREIGN SERVER</literal> or <literal>SEQUENCE</literal> + </para></entry> </row> <row> - <entry><literal>privilege_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Always <literal>USAGE</literal></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>privilege_type</structfield> <type>character_data</type> + </para> + <para> + Always <literal>USAGE</literal> + </para></entry> </row> <row> - <entry><literal>is_grantable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry><literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_grantable</structfield> <type>yes_or_no</type> + </para> + <para> + <literal>YES</literal> if the privilege is grantable, <literal>NO</literal> if not + </para></entry> </row> </tbody> </tgroup> @@ -5933,192 +7395,279 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>user_defined_types</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>user_defined_types</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>user_defined_type_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the type (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the type (always the current database) + </para></entry> </row> <row> - <entry><literal>user_defined_type_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the type + </para></entry> </row> <row> - <entry><literal>user_defined_type_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the type</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the type + </para></entry> </row> <row> - <entry><literal>user_defined_type_category</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>user_defined_type_category</structfield> <type>character_data</type> + </para> + <para> Currently always <literal>STRUCTURED</literal> - </entry> + </para></entry> </row> <row> - <entry><literal>is_instantiable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_instantiable</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>is_final</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_final</structfield> <type>yes_or_no</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>ordering_form</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordering_form</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>ordering_category</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordering_category</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>ordering_routine_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordering_routine_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>ordering_routine_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordering_routine_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>ordering_routine_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ordering_routine_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>reference_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reference_type</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>data_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>data_type</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_maximum_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_maximum_length</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_octet_length</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_octet_length</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>character_set_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>character_set_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>collation_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>collation_name</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_precision_radix</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_precision_radix</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>numeric_scale</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numeric_scale</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>datetime_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datetime_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_type</literal></entry> - <entry><type>character_data</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_type</structfield> <type>character_data</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>interval_precision</literal></entry> - <entry><type>cardinal_number</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>interval_precision</structfield> <type>cardinal_number</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>source_dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>source_dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> <row> - <entry><literal>ref_dtd_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Applies to a feature not available in <productname>PostgreSQL</productname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ref_dtd_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Applies to a feature not available in <productname>PostgreSQL</productname> + </para></entry> </row> </tbody> </tgroup> @@ -6137,53 +7686,70 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>user_mapping_options</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>user_mapping_options</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>authorization_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the user being mapped, - or <literal>PUBLIC</literal> if the mapping is public</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>authorization_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the user being mapped, + or <literal>PUBLIC</literal> if the mapping is public + </para></entry> </row> <row> - <entry><literal>foreign_server_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign server used by this - mapping is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign server used by this + mapping is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_server_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign server used by this mapping</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign server used by this mapping + </para></entry> </row> <row> - <entry><literal>option_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of an option</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of an option + </para></entry> </row> <row> - <entry><literal>option_value</literal></entry> - <entry><type>character_data</type></entry> - <entry>Value of the option. This column will show as null - unless the current user is the user being mapped, or the mapping - is for <literal>PUBLIC</literal> and the current user is the - server owner, or the current user is a superuser. The intent is - to protect password information stored as user mapping - option.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>option_value</structfield> <type>character_data</type> + </para> + <para> + Value of the option. This column will show as null + unless the current user is the user being mapped, or the mapping + is for <literal>PUBLIC</literal> and the current user is the + server owner, or the current user is a superuser. The intent is + to protect password information stored as user mapping + option. + </para></entry> </row> </tbody> </tgroup> @@ -6202,36 +7768,47 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>user_mappings</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>user_mappings</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>authorization_identifier</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the user being mapped, - or <literal>PUBLIC</literal> if the mapping is public</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>authorization_identifier</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the user being mapped, + or <literal>PUBLIC</literal> if the mapping is public + </para></entry> </row> <row> - <entry><literal>foreign_server_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that the foreign server used by this - mapping is defined in (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that the foreign server used by this + mapping is defined in (always the current database) + </para></entry> </row> <row> - <entry><literal>foreign_server_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the foreign server used by this mapping</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>foreign_server_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the foreign server used by this mapping + </para></entry> </row> </tbody> </tgroup> @@ -6257,67 +7834,84 @@ ORDER BY c.ordinal_position; </note> <table> - <title><literal>view_column_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>view_column_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>view_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the view (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the view (always the current database) + </para></entry> </row> <row> - <entry><literal>view_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the view + </para></entry> </row> <row> - <entry><literal>view_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the view + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that contains the column that is used by the view (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the table that contains the column that is used by the view - </entry> + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the table that contains the column that is used by the view - </entry> + </para></entry> </row> <row> - <entry><literal>column_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the column that is used by the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>column_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the column that is used by the view + </para></entry> </row> </tbody> </tgroup> @@ -6336,55 +7930,72 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>view_routine_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>view_routine_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the view (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the view (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the view + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the view + </para></entry> </row> <row> - <entry><literal>specific_catalog</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the database containing the function (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database containing the function (always the current database) + </para></entry> </row> <row> - <entry><literal>specific_schema</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry>Name of the schema containing the function</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema containing the function + </para></entry> </row> <row> - <entry><literal>specific_name</literal></entry> - <entry><literal>sql_identifier</literal></entry> - <entry> - The <quote>specific name</quote> of the function. See <xref - linkend="infoschema-routines"/> for more information. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>specific_name</structfield> <type>sql_identifier</type> + </para> + <para> + The <quote>specific name</quote> of the function. See <xref linkend="infoschema-routines"/> for more information. + </para></entry> </row> </tbody> </tgroup> @@ -6409,60 +8020,74 @@ ORDER BY c.ordinal_position; </note> <table> - <title><literal>view_table_usage</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>view_table_usage</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>view_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the view (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the view (always the current database) + </para></entry> </row> <row> - <entry><literal>view_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the view + </para></entry> </row> <row> - <entry><literal>view_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the view + </para></entry> </row> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> Name of the database that contains the table that is used by the view (always the current database) - </entry> + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> Name of the schema that contains the table that is used by the view - </entry> + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> Name of the table that is used by the view - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -6479,99 +8104,117 @@ ORDER BY c.ordinal_position; </para> <table> - <title><literal>views</literal> Columns</title> - - <tgroup cols="3"> + <title><structname>views</structname> Columns</title> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Data Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><literal>table_catalog</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the database that contains the view (always the current database)</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_catalog</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the database that contains the view (always the current database) + </para></entry> </row> <row> - <entry><literal>table_schema</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the schema that contains the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_schema</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the schema that contains the view + </para></entry> </row> <row> - <entry><literal>table_name</literal></entry> - <entry><type>sql_identifier</type></entry> - <entry>Name of the view</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>table_name</structfield> <type>sql_identifier</type> + </para> + <para> + Name of the view + </para></entry> </row> <row> - <entry><literal>view_definition</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>view_definition</structfield> <type>character_data</type> + </para> + <para> Query expression defining the view (null if the view is not owned by a currently enabled role) - </entry> + </para></entry> </row> <row> - <entry><literal>check_option</literal></entry> - <entry><type>character_data</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>check_option</structfield> <type>character_data</type> + </para> + <para> <literal>CASCADED</literal> or <literal>LOCAL</literal> if the view has a <literal>CHECK OPTION</literal> defined on it, <literal>NONE</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_updatable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_updatable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the view is updatable (allows <command>UPDATE</command> and <command>DELETE</command>), <literal>NO</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_insertable_into</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_insertable_into</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the view is insertable into (allows <command>INSERT</command>), <literal>NO</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_trigger_updatable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_trigger_updatable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the view has an <literal>INSTEAD OF</literal> <command>UPDATE</command> trigger defined on it, <literal>NO</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_trigger_deletable</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_trigger_deletable</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the view has an <literal>INSTEAD OF</literal> <command>DELETE</command> trigger defined on it, <literal>NO</literal> if not - </entry> + </para></entry> </row> <row> - <entry><literal>is_trigger_insertable_into</literal></entry> - <entry><type>yes_or_no</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>is_trigger_insertable_into</structfield> <type>yes_or_no</type> + </para> + <para> <literal>YES</literal> if the view has an <literal>INSTEAD OF</literal> <command>INSERT</command> trigger defined on it, <literal>NO</literal> if not - </entry> + </para></entry> </row> </tbody> </tgroup> diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 579ccd34d4f..4c6b40778bb 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -611,119 +611,170 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser <table id="pg-stat-activity-view" xreflabel="pg_stat_activity"> <title><structname>pg_stat_activity</structname> View</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the database this backend is connected to</entry> - </row> - <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the database this backend is connected to</entry> - </row> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of this backend</entry> - </row> - <row> - <entry><structfield>leader_pid</structfield></entry> - <entry><type>integer</type></entry> - <entry> - Process ID of the parallel group leader if this process is or - has been involved in parallel query, or null. This field is set - when a process wants to cooperate with parallel workers, and - remains set as long as the process exists. For a parallel group leader, - this field is set to its own process ID. For a parallel worker, - this field is set to the process ID of the parallel group leader. - </entry> - </row> - <row> - <entry><structfield>usesysid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the user logged into this backend</entry> - </row> - <row> - <entry><structfield>usename</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the user logged into this backend</entry> - </row> - <row> - <entry><structfield>application_name</structfield></entry> - <entry><type>text</type></entry> - <entry>Name of the application that is connected - to this backend</entry> - </row> - <row> - <entry><structfield>client_addr</structfield></entry> - <entry><type>inet</type></entry> - <entry>IP address of the client connected to this backend. - If this field is null, it indicates either that the client is - connected via a Unix socket on the server machine or that this is an - internal process such as autovacuum. - </entry> - </row> - <row> - <entry><structfield>client_hostname</structfield></entry> - <entry><type>text</type></entry> - <entry>Host name of the connected client, as reported by a - reverse DNS lookup of <structfield>client_addr</structfield>. This field will - only be non-null for IP connections, and only when <xref - linkend="guc-log-hostname"/> is enabled. - </entry> - </row> - <row> - <entry><structfield>client_port</structfield></entry> - <entry><type>integer</type></entry> - <entry>TCP port number that the client is using for communication - with this backend, or <literal>-1</literal> if a Unix socket is used. - If this field is null, it indicates that this is an internal server process. - </entry> - </row> - <row> - <entry><structfield>backend_start</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time when this process was started. For client backends, - this is the time the client connected to the server. - </entry> - </row> - <row> - <entry><structfield>xact_start</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time when this process' current transaction was started, or null - if no transaction is active. If the current - query is the first of its transaction, this column is equal to the - <structfield>query_start</structfield> column. - </entry> - </row> - <row> - <entry><structfield>query_start</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time when the currently active query was started, or if - <structfield>state</structfield> is not <literal>active</literal>, when the last query - was started - </entry> - </row> - <row> - <entry><structfield>state_change</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time when the <structfield>state</structfield> was last changed</entry> - </row> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of the database this backend is connected to + </para></entry> + </row> + <row> - <entry><structfield>wait_event_type</structfield></entry> - <entry><type>text</type></entry> - <entry>The type of event for which the backend is waiting, if any; + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of the database this backend is connected to + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of this backend + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>leader_pid</structfield> <type>integer</type> + </para> + <para> + Process ID of the parallel group leader if this process is or + has been involved in parallel query, or null. This field is set + when a process wants to cooperate with parallel workers, and + remains set as long as the process exists. For a parallel group leader, + this field is set to its own process ID. For a parallel worker, + this field is set to the process ID of the parallel group leader. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usesysid</structfield> <type>oid</type> + </para> + <para> + OID of the user logged into this backend + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usename</structfield> <type>name</type> + </para> + <para> + Name of the user logged into this backend + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>application_name</structfield> <type>text</type> + </para> + <para> + Name of the application that is connected + to this backend + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_addr</structfield> <type>inet</type> + </para> + <para> + IP address of the client connected to this backend. + If this field is null, it indicates either that the client is + connected via a Unix socket on the server machine or that this is an + internal process such as autovacuum. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_hostname</structfield> <type>text</type> + </para> + <para> + Host name of the connected client, as reported by a + reverse DNS lookup of <structfield>client_addr</structfield>. This field will + only be non-null for IP connections, and only when <xref linkend="guc-log-hostname"/> is enabled. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_port</structfield> <type>integer</type> + </para> + <para> + TCP port number that the client is using for communication + with this backend, or <literal>-1</literal> if a Unix socket is used. + If this field is null, it indicates that this is an internal server process. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backend_start</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time when this process was started. For client backends, + this is the time the client connected to the server. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>xact_start</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time when this process' current transaction was started, or null + if no transaction is active. If the current + query is the first of its transaction, this column is equal to the + <structfield>query_start</structfield> column. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>query_start</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time when the currently active query was started, or if + <structfield>state</structfield> is not <literal>active</literal>, when the last query + was started + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>state_change</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time when the <structfield>state</structfield> was last changed + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>wait_event_type</structfield> <type>text</type> + </para> + <para> + The type of event for which the backend is waiting, if any; otherwise NULL. Possible values are: <itemizedlist> <listitem> @@ -797,96 +848,115 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser </para> </listitem> </itemizedlist> - </entry> + </para></entry> </row> - <row> - <entry><structfield>wait_event</structfield></entry> - <entry><type>text</type></entry> - <entry>Wait event name if backend is currently waiting, otherwise NULL. - See <xref linkend="wait-event-table"/> for details. - </entry> - </row> - <row> - <entry><structfield>state</structfield></entry> - <entry><type>text</type></entry> - <entry>Current overall state of this backend. + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>wait_event</structfield> <type>text</type> + </para> + <para> + Wait event name if backend is currently waiting, otherwise NULL. + See <xref linkend="wait-event-table"/> for details. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>state</structfield> <type>text</type> + </para> + <para> + Current overall state of this backend. Possible values are: <itemizedlist> - <listitem> - <para> - <literal>active</literal>: The backend is executing a query. - </para> - </listitem> - <listitem> - <para> - <literal>idle</literal>: The backend is waiting for a new client command. - </para> - </listitem> - <listitem> - <para> - <literal>idle in transaction</literal>: The backend is in a transaction, - but is not currently executing a query. - </para> - </listitem> - <listitem> - <para> - <literal>idle in transaction (aborted)</literal>: This state is similar to - <literal>idle in transaction</literal>, except one of the statements in - the transaction caused an error. - </para> - </listitem> - <listitem> - <para> - <literal>fastpath function call</literal>: The backend is executing a - fast-path function. - </para> - </listitem> - <listitem> - <para> - <literal>disabled</literal>: This state is reported if <xref - linkend="guc-track-activities"/> is disabled in this backend. - </para> - </listitem> + <listitem> + <para> + <literal>active</literal>: The backend is executing a query. + </para> + </listitem> + <listitem> + <para> + <literal>idle</literal>: The backend is waiting for a new client command. + </para> + </listitem> + <listitem> + <para> + <literal>idle in transaction</literal>: The backend is in a transaction, + but is not currently executing a query. + </para> + </listitem> + <listitem> + <para> + <literal>idle in transaction (aborted)</literal>: This state is similar to + <literal>idle in transaction</literal>, except one of the statements in + the transaction caused an error. + </para> + </listitem> + <listitem> + <para> + <literal>fastpath function call</literal>: The backend is executing a + fast-path function. + </para> + </listitem> + <listitem> + <para> + <literal>disabled</literal>: This state is reported if <xref linkend="guc-track-activities"/> is disabled in this backend. + </para> + </listitem> </itemizedlist> - </entry> - </row> - <row> - <entry><structfield>backend_xid</structfield></entry> - <entry><type>xid</type></entry> - <entry>Top-level transaction identifier of this backend, if any.</entry> - </row> - <row> - <entry><structfield>backend_xmin</structfield></entry> - <entry><type>xid</type></entry> - <entry>The current backend's <literal>xmin</literal> horizon.</entry> - </row> - <row> - <entry><structfield>query</structfield></entry> - <entry><type>text</type></entry> - <entry>Text of this backend's most recent query. If - <structfield>state</structfield> is <literal>active</literal> this field shows the - currently executing query. In all other states, it shows the last query - that was executed. By default the query text is truncated at 1024 - characters; this value can be changed via the parameter - <xref linkend="guc-track-activity-query-size"/>. - </entry> - </row> - <row> - <entry><structfield>backend_type</structfield></entry> - <entry><type>text</type></entry> - <entry>Type of current backend. Possible types are - <literal>autovacuum launcher</literal>, <literal>autovacuum worker</literal>, - <literal>logical replication launcher</literal>, - <literal>logical replication worker</literal>, - <literal>parallel worker</literal>, <literal>background writer</literal>, - <literal>client backend</literal>, <literal>checkpointer</literal>, - <literal>startup</literal>, <literal>walreceiver</literal>, - <literal>walsender</literal> and <literal>walwriter</literal>. - In addition, background workers registered by extensions may have - additional types. - </entry> - </row> - </tbody> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backend_xid</structfield> <type>xid</type> + </para> + <para> + Top-level transaction identifier of this backend, if any. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backend_xmin</structfield> <type>xid</type> + </para> + <para> + The current backend's <literal>xmin</literal> horizon. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>query</structfield> <type>text</type> + </para> + <para> + Text of this backend's most recent query. If + <structfield>state</structfield> is <literal>active</literal> this field shows the + currently executing query. In all other states, it shows the last query + that was executed. By default the query text is truncated at 1024 + characters; this value can be changed via the parameter + <xref linkend="guc-track-activity-query-size"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backend_type</structfield> <type>text</type> + </para> + <para> + Type of current backend. Possible types are + <literal>autovacuum launcher</literal>, <literal>autovacuum worker</literal>, + <literal>logical replication launcher</literal>, + <literal>logical replication worker</literal>, + <literal>parallel worker</literal>, <literal>background writer</literal>, + <literal>client backend</literal>, <literal>checkpointer</literal>, + <literal>startup</literal>, <literal>walreceiver</literal>, + <literal>walsender</literal> and <literal>walwriter</literal>. + In addition, background workers registered by extensions may have + additional types. + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -1842,228 +1912,315 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-replication-view" xreflabel="pg_stat_replication"> <title><structname>pg_stat_replication</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of a WAL sender process</entry> - </row> - <row> - <entry><structfield>usesysid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the user logged into this WAL sender process</entry> - </row> - <row> - <entry><structfield>usename</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the user logged into this WAL sender process</entry> - </row> - <row> - <entry><structfield>application_name</structfield></entry> - <entry><type>text</type></entry> - <entry>Name of the application that is connected - to this WAL sender</entry> - </row> - <row> - <entry><structfield>client_addr</structfield></entry> - <entry><type>inet</type></entry> - <entry>IP address of the client connected to this WAL sender. - If this field is null, it indicates that the client is - connected via a Unix socket on the server machine. - </entry> - </row> - <row> - <entry><structfield>client_hostname</structfield></entry> - <entry><type>text</type></entry> - <entry>Host name of the connected client, as reported by a - reverse DNS lookup of <structfield>client_addr</structfield>. This field will - only be non-null for IP connections, and only when <xref - linkend="guc-log-hostname"/> is enabled. - </entry> - </row> - <row> - <entry><structfield>client_port</structfield></entry> - <entry><type>integer</type></entry> - <entry>TCP port number that the client is using for communication - with this WAL sender, or <literal>-1</literal> if a Unix socket is used - </entry> - </row> - <row> - <entry><structfield>backend_start</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time when this process was started, i.e., when the - client connected to this WAL sender - </entry> - </row> - <row> - <entry><structfield>backend_xmin</structfield></entry> - <entry><type>xid</type></entry> - <entry>This standby's <literal>xmin</literal> horizon reported - by <xref linkend="guc-hot-standby-feedback"/>.</entry> - </row> - <row> - <entry><structfield>state</structfield></entry> - <entry><type>text</type></entry> - <entry>Current WAL sender state. + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of a WAL sender process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usesysid</structfield> <type>oid</type> + </para> + <para> + OID of the user logged into this WAL sender process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usename</structfield> <type>name</type> + </para> + <para> + Name of the user logged into this WAL sender process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>application_name</structfield> <type>text</type> + </para> + <para> + Name of the application that is connected + to this WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_addr</structfield> <type>inet</type> + </para> + <para> + IP address of the client connected to this WAL sender. + If this field is null, it indicates that the client is + connected via a Unix socket on the server machine. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_hostname</structfield> <type>text</type> + </para> + <para> + Host name of the connected client, as reported by a + reverse DNS lookup of <structfield>client_addr</structfield>. This field will + only be non-null for IP connections, and only when <xref linkend="guc-log-hostname"/> is enabled. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_port</structfield> <type>integer</type> + </para> + <para> + TCP port number that the client is using for communication + with this WAL sender, or <literal>-1</literal> if a Unix socket is used + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backend_start</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time when this process was started, i.e., when the + client connected to this WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backend_xmin</structfield> <type>xid</type> + </para> + <para> + This standby's <literal>xmin</literal> horizon reported + by <xref linkend="guc-hot-standby-feedback"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>state</structfield> <type>text</type> + </para> + <para> + Current WAL sender state. Possible values are: <itemizedlist> - <listitem> - <para> - <literal>startup</literal>: This WAL sender is starting up. - </para> - </listitem> - <listitem> - <para> - <literal>catchup</literal>: This WAL sender's connected standby is - catching up with the primary. - </para> - </listitem> - <listitem> - <para> - <literal>streaming</literal>: This WAL sender is streaming changes - after its connected standby server has caught up with the primary. - </para> - </listitem> - <listitem> - <para> - <literal>backup</literal>: This WAL sender is sending a backup. - </para> - </listitem> - <listitem> - <para> - <literal>stopping</literal>: This WAL sender is stopping. - </para> - </listitem> + <listitem> + <para> + <literal>startup</literal>: This WAL sender is starting up. + </para> + </listitem> + <listitem> + <para> + <literal>catchup</literal>: This WAL sender's connected standby is + catching up with the primary. + </para> + </listitem> + <listitem> + <para> + <literal>streaming</literal>: This WAL sender is streaming changes + after its connected standby server has caught up with the primary. + </para> + </listitem> + <listitem> + <para> + <literal>backup</literal>: This WAL sender is sending a backup. + </para> + </listitem> + <listitem> + <para> + <literal>stopping</literal>: This WAL sender is stopping. + </para> + </listitem> </itemizedlist> - </entry> - </row> - <row> - <entry><structfield>sent_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location sent on this connection</entry> - </row> - <row> - <entry><structfield>write_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location written to disk by this standby - server</entry> - </row> - <row> - <entry><structfield>flush_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location flushed to disk by this standby - server</entry> - </row> - <row> - <entry><structfield>replay_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location replayed into the database on this - standby server</entry> - </row> - <row> - <entry><structfield>write_lag</structfield></entry> - <entry><type>interval</type></entry> - <entry>Time elapsed between flushing recent WAL locally and receiving - notification that this standby server has written it (but not yet - flushed it or applied it). This can be used to gauge the delay that - <literal>synchronous_commit</literal> level - <literal>remote_write</literal> incurred while committing if this - server was configured as a synchronous standby.</entry> - </row> - <row> - <entry><structfield>flush_lag</structfield></entry> - <entry><type>interval</type></entry> - <entry>Time elapsed between flushing recent WAL locally and receiving - notification that this standby server has written and flushed it - (but not yet applied it). This can be used to gauge the delay that - <literal>synchronous_commit</literal> level - <literal>on</literal> incurred while committing if this - server was configured as a synchronous standby.</entry> - </row> - <row> - <entry><structfield>replay_lag</structfield></entry> - <entry><type>interval</type></entry> - <entry>Time elapsed between flushing recent WAL locally and receiving - notification that this standby server has written, flushed and - applied it. This can be used to gauge the delay that - <literal>synchronous_commit</literal> level - <literal>remote_apply</literal> incurred while committing if this - server was configured as a synchronous standby.</entry> - </row> - <row> - <entry><structfield>sync_priority</structfield></entry> - <entry><type>integer</type></entry> - <entry>Priority of this standby server for being chosen as the - synchronous standby in a priority-based synchronous replication. - This has no effect in a quorum-based synchronous replication.</entry> - </row> - <row> - <entry><structfield>sync_state</structfield></entry> - <entry><type>text</type></entry> - <entry>Synchronous state of this standby server. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sent_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location sent on this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>write_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location written to disk by this standby + server + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>flush_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location flushed to disk by this standby + server + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>replay_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location replayed into the database on this + standby server + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>write_lag</structfield> <type>interval</type> + </para> + <para> + Time elapsed between flushing recent WAL locally and receiving + notification that this standby server has written it (but not yet + flushed it or applied it). This can be used to gauge the delay that + <literal>synchronous_commit</literal> level + <literal>remote_write</literal> incurred while committing if this + server was configured as a synchronous standby. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>flush_lag</structfield> <type>interval</type> + </para> + <para> + Time elapsed between flushing recent WAL locally and receiving + notification that this standby server has written and flushed it + (but not yet applied it). This can be used to gauge the delay that + <literal>synchronous_commit</literal> level + <literal>on</literal> incurred while committing if this + server was configured as a synchronous standby. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>replay_lag</structfield> <type>interval</type> + </para> + <para> + Time elapsed between flushing recent WAL locally and receiving + notification that this standby server has written, flushed and + applied it. This can be used to gauge the delay that + <literal>synchronous_commit</literal> level + <literal>remote_apply</literal> incurred while committing if this + server was configured as a synchronous standby. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sync_priority</structfield> <type>integer</type> + </para> + <para> + Priority of this standby server for being chosen as the + synchronous standby in a priority-based synchronous replication. + This has no effect in a quorum-based synchronous replication. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sync_state</structfield> <type>text</type> + </para> + <para> + Synchronous state of this standby server. Possible values are: <itemizedlist> - <listitem> - <para> - <literal>async</literal>: This standby server is asynchronous. - </para> - </listitem> - <listitem> - <para> - <literal>potential</literal>: This standby server is now asynchronous, - but can potentially become synchronous if one of current - synchronous ones fails. - </para> - </listitem> - <listitem> - <para> - <literal>sync</literal>: This standby server is synchronous. - </para> - </listitem> - <listitem> - <para> - <literal>quorum</literal>: This standby server is considered as a candidate - for quorum standbys. - </para> - </listitem> + <listitem> + <para> + <literal>async</literal>: This standby server is asynchronous. + </para> + </listitem> + <listitem> + <para> + <literal>potential</literal>: This standby server is now asynchronous, + but can potentially become synchronous if one of current + synchronous ones fails. + </para> + </listitem> + <listitem> + <para> + <literal>sync</literal>: This standby server is synchronous. + </para> + </listitem> + <listitem> + <para> + <literal>quorum</literal>: This standby server is considered as a candidate + for quorum standbys. + </para> + </listitem> </itemizedlist> - </entry> - </row> - <row> - <entry><structfield>reply_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Send time of last reply message received from standby server</entry> - </row> - <row> - <entry><structfield>spill_txns</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of transactions spilled to disk after the memory used by - logical decoding exceeds <literal>logical_decoding_work_mem</literal>. The - counter gets incremented both for toplevel transactions and - subtransactions.</entry> - </row> - <row> - <entry><structfield>spill_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times transactions were spilled to disk. Transactions - may get spilled repeatedly, and this counter gets incremented on every - such invocation.</entry> - </row> - <row> - <entry><structfield>spill_bytes</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Amount of decoded transaction data spilled to disk.</entry> - </row> - </tbody> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reply_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Send time of last reply message received from standby server + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spill_txns</structfield> <type>bigint</type> + </para> + <para> + Number of transactions spilled to disk after the memory used by + logical decoding exceeds <literal>logical_decoding_work_mem</literal>. The + counter gets incremented both for toplevel transactions and + subtransactions. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spill_count</structfield> <type>bigint</type> + </para> + <para> + Number of times transactions were spilled to disk. Transactions + may get spilled repeatedly, and this counter gets incremented on every + such invocation. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>spill_bytes</structfield> <type>bigint</type> + </para> + <para> + Amount of decoded transaction data spilled to disk. + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2115,105 +2272,156 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-wal-receiver-view" xreflabel="pg_stat_wal_receiver"> <title><structname>pg_stat_wal_receiver</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of the WAL receiver process</entry> - </row> - <row> - <entry><structfield>status</structfield></entry> - <entry><type>text</type></entry> - <entry>Activity status of the WAL receiver process</entry> - </row> - <row> - <entry><structfield>receive_start_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>First write-ahead log location used when WAL receiver is - started</entry> - </row> - <row> - <entry><structfield>receive_start_tli</structfield></entry> - <entry><type>integer</type></entry> - <entry>First timeline number used when WAL receiver is started</entry> - </row> - <row> - <entry><structfield>received_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location already received and flushed to - disk, the initial value of this field being the first log location used - when WAL receiver is started</entry> - </row> - <row> - <entry><structfield>received_tli</structfield></entry> - <entry><type>integer</type></entry> - <entry>Timeline number of last write-ahead log location received and - flushed to disk, the initial value of this field being the timeline - number of the first log location used when WAL receiver is started - </entry> - </row> - <row> - <entry><structfield>last_msg_send_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Send time of last message received from origin WAL sender</entry> - </row> - <row> - <entry><structfield>last_msg_receipt_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Receipt time of last message received from origin WAL sender</entry> - </row> - <row> - <entry><structfield>latest_end_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location reported to origin WAL sender</entry> - </row> - <row> - <entry><structfield>latest_end_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time of last write-ahead log location reported to origin WAL sender</entry> - </row> - <row> - <entry><structfield>slot_name</structfield></entry> - <entry><type>text</type></entry> - <entry>Replication slot name used by this WAL receiver</entry> - </row> - <row> - <entry><structfield>sender_host</structfield></entry> - <entry><type>text</type></entry> - <entry> - Host of the <productname>PostgreSQL</productname> instance - this WAL receiver is connected to. This can be a host name, - an IP address, or a directory path if the connection is via - Unix socket. (The path case can be distinguished because it - will always be an absolute path, beginning with <literal>/</literal>.) - </entry> - </row> - <row> - <entry><structfield>sender_port</structfield></entry> - <entry><type>integer</type></entry> - <entry> - Port number of the <productname>PostgreSQL</productname> instance - this WAL receiver is connected to. - </entry> - </row> - <row> - <entry><structfield>conninfo</structfield></entry> - <entry><type>text</type></entry> - <entry> - Connection string used by this WAL receiver, - with security-sensitive fields obfuscated. - </entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of the WAL receiver process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>status</structfield> <type>text</type> + </para> + <para> + Activity status of the WAL receiver process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>receive_start_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + First write-ahead log location used when WAL receiver is + started + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>receive_start_tli</structfield> <type>integer</type> + </para> + <para> + First timeline number used when WAL receiver is started + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>received_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location already received and flushed to + disk, the initial value of this field being the first log location used + when WAL receiver is started + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>received_tli</structfield> <type>integer</type> + </para> + <para> + Timeline number of last write-ahead log location received and + flushed to disk, the initial value of this field being the timeline + number of the first log location used when WAL receiver is started + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_msg_send_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Send time of last message received from origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_msg_receipt_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Receipt time of last message received from origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>latest_end_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location reported to origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>latest_end_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time of last write-ahead log location reported to origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>slot_name</structfield> <type>text</type> + </para> + <para> + Replication slot name used by this WAL receiver + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sender_host</structfield> <type>text</type> + </para> + <para> + Host of the <productname>PostgreSQL</productname> instance + this WAL receiver is connected to. This can be a host name, + an IP address, or a directory path if the connection is via + Unix socket. (The path case can be distinguished because it + will always be an absolute path, beginning with <literal>/</literal>.) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sender_port</structfield> <type>integer</type> + </para> + <para> + Port number of the <productname>PostgreSQL</productname> instance + this WAL receiver is connected to. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conninfo</structfield> <type>text</type> + </para> + <para> + Connection string used by this WAL receiver, + with security-sensitive fields obfuscated. + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2225,67 +2433,103 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-subscription" xreflabel="pg_stat_subscription"> <title><structname>pg_stat_subscription</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>subid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the subscription</entry> - </row> - <row> - <entry><structfield>subname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the subscription</entry> - </row> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of the subscription worker process</entry> - </row> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>Oid</type></entry> - <entry>OID of the relation that the worker is synchronizing; null for the - main apply worker</entry> - </row> - <row> - <entry><structfield>received_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location received, the initial value of - this field being 0</entry> - </row> - <row> - <entry><structfield>last_msg_send_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Send time of last message received from origin WAL sender</entry> - </row> - <row> - <entry><structfield>last_msg_receipt_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Receipt time of last message received from origin WAL sender - </entry> - </row> - <row> - <entry><structfield>latest_end_lsn</structfield></entry> - <entry><type>pg_lsn</type></entry> - <entry>Last write-ahead log location reported to origin WAL sender - </entry> - </row> - <row> - <entry><structfield>latest_end_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time of last write-ahead log location reported to origin WAL - sender</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subid</structfield> <type>oid</type> + </para> + <para> + OID of the subscription + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>subname</structfield> <type>name</type> + </para> + <para> + Name of the subscription + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of the subscription worker process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the relation that the worker is synchronizing; null for the + main apply worker + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>received_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location received, the initial value of + this field being 0 + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_msg_send_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Send time of last message received from origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_msg_receipt_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Receipt time of last message received from origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>latest_end_lsn</structfield> <type>pg_lsn</type> + </para> + <para> + Last write-ahead log location reported to origin WAL sender + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>latest_end_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time of last write-ahead log location reported to origin WAL + sender + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2298,77 +2542,114 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-ssl-view" xreflabel="pg_stat_ssl"> <title><structname>pg_stat_ssl</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of a backend or WAL sender process</entry> - </row> - <row> - <entry><structfield>ssl</structfield></entry> - <entry><type>boolean</type></entry> - <entry>True if SSL is used on this connection</entry> - </row> - <row> - <entry><structfield>version</structfield></entry> - <entry><type>text</type></entry> - <entry>Version of SSL in use, or NULL if SSL is not in use - on this connection</entry> - </row> - <row> - <entry><structfield>cipher</structfield></entry> - <entry><type>text</type></entry> - <entry>Name of SSL cipher in use, or NULL if SSL is not in use - on this connection</entry> - </row> - <row> - <entry><structfield>bits</structfield></entry> - <entry><type>integer</type></entry> - <entry>Number of bits in the encryption algorithm used, or NULL - if SSL is not used on this connection</entry> - </row> - <row> - <entry><structfield>compression</structfield></entry> - <entry><type>boolean</type></entry> - <entry>True if SSL compression is in use, false if not, - or NULL if SSL is not in use on this connection</entry> - </row> - <row> - <entry><structfield>client_dn</structfield></entry> - <entry><type>text</type></entry> - <entry>Distinguished Name (DN) field from the client certificate - used, or NULL if no client certificate was supplied or if SSL - is not in use on this connection. This field is truncated if the - DN field is longer than <symbol>NAMEDATALEN</symbol> (64 characters - in a standard build). - </entry> - </row> - <row> - <entry><structfield>client_serial</structfield></entry> - <entry><type>numeric</type></entry> - <entry>Serial number of the client certificate, or NULL if no client - certificate was supplied or if SSL is not in use on this connection. The - combination of certificate serial number and certificate issuer uniquely - identifies a certificate (unless the issuer erroneously reuses serial - numbers).</entry> - </row> - <row> - <entry><structfield>issuer_dn</structfield></entry> - <entry><type>text</type></entry> - <entry>DN of the issuer of the client certificate, or NULL if no client - certificate was supplied or if SSL is not in use on this connection. - This field is truncated like <structfield>client_dn</structfield>.</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of a backend or WAL sender process + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ssl</structfield> <type>boolean</type> + </para> + <para> + True if SSL is used on this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>version</structfield> <type>text</type> + </para> + <para> + Version of SSL in use, or NULL if SSL is not in use + on this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cipher</structfield> <type>text</type> + </para> + <para> + Name of SSL cipher in use, or NULL if SSL is not in use + on this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>bits</structfield> <type>integer</type> + </para> + <para> + Number of bits in the encryption algorithm used, or NULL + if SSL is not used on this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>compression</structfield> <type>boolean</type> + </para> + <para> + True if SSL compression is in use, false if not, + or NULL if SSL is not in use on this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_dn</structfield> <type>text</type> + </para> + <para> + Distinguished Name (DN) field from the client certificate + used, or NULL if no client certificate was supplied or if SSL + is not in use on this connection. This field is truncated if the + DN field is longer than <symbol>NAMEDATALEN</symbol> (64 characters + in a standard build). + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>client_serial</structfield> <type>numeric</type> + </para> + <para> + Serial number of the client certificate, or NULL if no client + certificate was supplied or if SSL is not in use on this connection. The + combination of certificate serial number and certificate issuer uniquely + identifies a certificate (unless the issuer erroneously reuses serial + numbers). + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>issuer_dn</structfield> <type>text</type> + </para> + <para> + DN of the issuer of the client certificate, or NULL if no client + certificate was supplied or if SSL is not in use on this connection. + This field is truncated like <structfield>client_dn</structfield>. + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2383,41 +2664,58 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-gssapi-view" xreflabel="pg_stat_gssapi"> <title><structname>pg_stat_gssapi</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of a backend</entry> - </row> - <row> - <entry><structfield>gss_authenticated</structfield></entry> - <entry><type>boolean</type></entry> - <entry>True if GSSAPI authentication was used for this connection</entry> - </row> - <row> - <entry><structfield>principal</structfield></entry> - <entry><type>text</type></entry> - <entry>Principal used to authenticate this connection, or NULL - if GSSAPI was not used to authenticate this connection. This - field is truncated if the principal is longer than - <symbol>NAMEDATALEN</symbol> (64 characters in a standard build). - </entry> - </row> - <row> - <entry><structfield>encrypted</structfield></entry> - <entry><type>boolean</type></entry> - <entry>True if GSSAPI encryption is in use on this connection</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of a backend + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>gss_authenticated</structfield> <type>boolean</type> + </para> + <para> + True if GSSAPI authentication was used for this connection + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>principal</structfield> <type>text</type> + </para> + <para> + Principal used to authenticate this connection, or NULL + if GSSAPI was not used to authenticate this connection. This + field is truncated if the principal is longer than + <symbol>NAMEDATALEN</symbol> (64 characters in a standard build). + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>encrypted</structfield> <type>boolean</type> + </para> + <para> + True if GSSAPI encryption is in use on this connection + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2433,51 +2731,80 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-archiver-view" xreflabel="pg_stat_archiver"> <title><structname>pg_stat_archiver</structname> View</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>archived_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of WAL files that have been successfully archived</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>archived_count</structfield> <type>bigint</type> + </para> + <para> + Number of WAL files that have been successfully archived + </para></entry> </row> + <row> - <entry><structfield>last_archived_wal</structfield></entry> - <entry><type>text</type></entry> - <entry>Name of the last WAL file successfully archived</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_archived_wal</structfield> <type>text</type> + </para> + <para> + Name of the last WAL file successfully archived + </para></entry> </row> + <row> - <entry><structfield>last_archived_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time of the last successful archive operation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_archived_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time of the last successful archive operation + </para></entry> </row> + <row> - <entry><structfield>failed_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of failed attempts for archiving WAL files</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>failed_count</structfield> <type>bigint</type> + </para> + <para> + Number of failed attempts for archiving WAL files + </para></entry> </row> + <row> - <entry><structfield>last_failed_wal</structfield></entry> - <entry><type>text</type></entry> - <entry>Name of the WAL file of the last failed archival operation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_failed_wal</structfield> <type>text</type> + </para> + <para> + Name of the WAL file of the last failed archival operation + </para></entry> </row> + <row> - <entry><structfield>last_failed_time</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time of the last failed archival operation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_failed_time</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time of the last failed archival operation + </para></entry> </row> + <row> - <entry><structfield>stats_reset</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time at which these statistics were last reset</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stats_reset</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time at which these statistics were last reset + </para></entry> </row> </tbody> </tgroup> @@ -2490,84 +2817,125 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-bgwriter-view" xreflabel="pg_stat_bgwriter"> <title><structname>pg_stat_bgwriter</structname> View</title> - - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>checkpoints_timed</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of scheduled checkpoints that have been performed</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>checkpoints_timed</structfield> <type>bigint</type> + </para> + <para> + Number of scheduled checkpoints that have been performed + </para></entry> </row> + <row> - <entry><structfield>checkpoints_req</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of requested checkpoints that have been performed</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>checkpoints_req</structfield> <type>bigint</type> + </para> + <para> + Number of requested checkpoints that have been performed + </para></entry> </row> + <row> - <entry><structfield>checkpoint_write_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry> - Total amount of time that has been spent in the portion of - checkpoint processing where files are written to disk, in milliseconds - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>checkpoint_write_time</structfield> <type>double precision</type> + </para> + <para> + Total amount of time that has been spent in the portion of + checkpoint processing where files are written to disk, in milliseconds + </para></entry> </row> + <row> - <entry><structfield>checkpoint_sync_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry> - Total amount of time that has been spent in the portion of - checkpoint processing where files are synchronized to disk, in - milliseconds - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>checkpoint_sync_time</structfield> <type>double precision</type> + </para> + <para> + Total amount of time that has been spent in the portion of + checkpoint processing where files are synchronized to disk, in + milliseconds + </para></entry> </row> + <row> - <entry><structfield>buffers_checkpoint</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffers written during checkpoints</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>buffers_checkpoint</structfield> <type>bigint</type> + </para> + <para> + Number of buffers written during checkpoints + </para></entry> </row> + <row> - <entry><structfield>buffers_clean</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffers written by the background writer</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>buffers_clean</structfield> <type>bigint</type> + </para> + <para> + Number of buffers written by the background writer + </para></entry> </row> + <row> - <entry><structfield>maxwritten_clean</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times the background writer stopped a cleaning - scan because it had written too many buffers</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>maxwritten_clean</structfield> <type>bigint</type> + </para> + <para> + Number of times the background writer stopped a cleaning + scan because it had written too many buffers + </para></entry> </row> + <row> - <entry><structfield>buffers_backend</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffers written directly by a backend</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>buffers_backend</structfield> <type>bigint</type> + </para> + <para> + Number of buffers written directly by a backend + </para></entry> </row> + <row> - <entry><structfield>buffers_backend_fsync</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times a backend had to execute its own + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>buffers_backend_fsync</structfield> <type>bigint</type> + </para> + <para> + Number of times a backend had to execute its own <function>fsync</function> call (normally the background writer handles those - even when the backend does its own write)</entry> + even when the backend does its own write) + </para></entry> </row> + <row> - <entry><structfield>buffers_alloc</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffers allocated</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>buffers_alloc</structfield> <type>bigint</type> + </para> + <para> + Number of buffers allocated + </para></entry> </row> + <row> - <entry><structfield>stats_reset</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time at which these statistics were last reset</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stats_reset</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time at which these statistics were last reset + </para></entry> </row> </tbody> - </tgroup> + </tgroup> </table> <para> @@ -2577,149 +2945,231 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-database-view" xreflabel="pg_stat_database"> <title><structname>pg_stat_database</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of this database, or 0 for objects belonging to a shared - relation</entry> - </row> - <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this database, or <literal>NULL</literal> for shared - objects.</entry> - </row> - <row> - <entry><structfield>numbackends</structfield></entry> - <entry><type>integer</type></entry> - <entry>Number of backends currently connected to this database, or - <literal>NULL</literal> for shared objects. This is the only column - in this view that returns a value reflecting current state; all other - columns return the accumulated values since the last reset.</entry> - </row> - <row> - <entry><structfield>xact_commit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of transactions in this database that have been - committed</entry> - </row> - <row> - <entry><structfield>xact_rollback</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of transactions in this database that have been - rolled back</entry> - </row> - <row> - <entry><structfield>blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read in this database</entry> - </row> - <row> - <entry><structfield>blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times disk blocks were found already in the buffer - cache, so that a read was not necessary (this only includes hits in the - PostgreSQL buffer cache, not the operating system's file system cache) - </entry> - </row> - <row> - <entry><structfield>tup_returned</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows returned by queries in this database</entry> - </row> - <row> - <entry><structfield>tup_fetched</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows fetched by queries in this database</entry> - </row> - <row> - <entry><structfield>tup_inserted</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows inserted by queries in this database</entry> - </row> - <row> - <entry><structfield>tup_updated</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows updated by queries in this database</entry> - </row> - <row> - <entry><structfield>tup_deleted</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows deleted by queries in this database</entry> - </row> - <row> - <entry><structfield>conflicts</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of queries canceled due to conflicts with recovery - in this database. (Conflicts occur only on standby servers; see - <xref linkend="pg-stat-database-conflicts-view"/> for details.) - </entry> - </row> - <row> - <entry><structfield>temp_files</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of temporary files created by queries in this database. - All temporary files are counted, regardless of why the temporary file - was created (e.g., sorting or hashing), and regardless of the - <xref linkend="guc-log-temp-files"/> setting. - </entry> - </row> - <row> - <entry><structfield>temp_bytes</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Total amount of data written to temporary files by queries in - this database. All temporary files are counted, regardless of why - the temporary file was created, and - regardless of the <xref linkend="guc-log-temp-files"/> setting. - </entry> - </row> - <row> - <entry><structfield>deadlocks</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of deadlocks detected in this database</entry> - </row> - <row> - <entry><structfield>checksum_failures</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of data page checksum failures detected in this - database (or on a shared object), or NULL if data checksums are not - enabled.</entry> - </row> - <row> - <entry><structfield>checksum_last_failure</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time at which the last data page checksum failure was detected in - this database (or on a shared object), or NULL if data checksums are not - enabled.</entry> - </row> - <row> - <entry><structfield>blk_read_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry>Time spent reading data file blocks by backends in this database, - in milliseconds</entry> - </row> - <row> - <entry><structfield>blk_write_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry>Time spent writing data file blocks by backends in this database, - in milliseconds</entry> - </row> - <row> - <entry><structfield>stats_reset</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time at which these statistics were last reset</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of this database, or 0 for objects belonging to a shared + relation + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of this database, or <literal>NULL</literal> for shared + objects. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>numbackends</structfield> <type>integer</type> + </para> + <para> + Number of backends currently connected to this database, or + <literal>NULL</literal> for shared objects. This is the only column + in this view that returns a value reflecting current state; all other + columns return the accumulated values since the last reset. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>xact_commit</structfield> <type>bigint</type> + </para> + <para> + Number of transactions in this database that have been + committed + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>xact_rollback</structfield> <type>bigint</type> + </para> + <para> + Number of transactions in this database that have been + rolled back + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of times disk blocks were found already in the buffer + cache, so that a read was not necessary (this only includes hits in the + PostgreSQL buffer cache, not the operating system's file system cache) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tup_returned</structfield> <type>bigint</type> + </para> + <para> + Number of rows returned by queries in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tup_fetched</structfield> <type>bigint</type> + </para> + <para> + Number of rows fetched by queries in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tup_inserted</structfield> <type>bigint</type> + </para> + <para> + Number of rows inserted by queries in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tup_updated</structfield> <type>bigint</type> + </para> + <para> + Number of rows updated by queries in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tup_deleted</structfield> <type>bigint</type> + </para> + <para> + Number of rows deleted by queries in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>conflicts</structfield> <type>bigint</type> + </para> + <para> + Number of queries canceled due to conflicts with recovery + in this database. (Conflicts occur only on standby servers; see + <xref linkend="pg-stat-database-conflicts-view"/> for details.) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>temp_files</structfield> <type>bigint</type> + </para> + <para> + Number of temporary files created by queries in this database. + All temporary files are counted, regardless of why the temporary file + was created (e.g., sorting or hashing), and regardless of the + <xref linkend="guc-log-temp-files"/> setting. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>temp_bytes</structfield> <type>bigint</type> + </para> + <para> + Total amount of data written to temporary files by queries in + this database. All temporary files are counted, regardless of why + the temporary file was created, and + regardless of the <xref linkend="guc-log-temp-files"/> setting. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>deadlocks</structfield> <type>bigint</type> + </para> + <para> + Number of deadlocks detected in this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>checksum_failures</structfield> <type>bigint</type> + </para> + <para> + Number of data page checksum failures detected in this + database (or on a shared object), or NULL if data checksums are not + enabled. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>checksum_last_failure</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time at which the last data page checksum failure was detected in + this database (or on a shared object), or NULL if data checksums are not + enabled. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blk_read_time</structfield> <type>double precision</type> + </para> + <para> + Time spent reading data file blocks by backends in this database, + in milliseconds + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blk_write_time</structfield> <type>double precision</type> + </para> + <para> + Time spent writing data file blocks by backends in this database, + in milliseconds + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stats_reset</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time at which these statistics were last reset + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2731,57 +3181,87 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-database-conflicts-view" xreflabel="pg_stat_database_conflicts"> <title><structname>pg_stat_database_conflicts</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of a database</entry> - </row> - <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this database</entry> - </row> - <row> - <entry><structfield>confl_tablespace</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of queries in this database that have been canceled due to - dropped tablespaces</entry> - </row> - <row> - <entry><structfield>confl_lock</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of queries in this database that have been canceled due to - lock timeouts</entry> - </row> - <row> - <entry><structfield>confl_snapshot</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of queries in this database that have been canceled due to - old snapshots</entry> - </row> - <row> - <entry><structfield>confl_bufferpin</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of queries in this database that have been canceled due to - pinned buffers</entry> - </row> - <row> - <entry><structfield>confl_deadlock</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of queries in this database that have been canceled due to - deadlocks</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of a database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of this database + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confl_tablespace</structfield> <type>bigint</type> + </para> + <para> + Number of queries in this database that have been canceled due to + dropped tablespaces + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confl_lock</structfield> <type>bigint</type> + </para> + <para> + Number of queries in this database that have been canceled due to + lock timeouts + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confl_snapshot</structfield> <type>bigint</type> + </para> + <para> + Number of queries in this database that have been canceled due to + old snapshots + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confl_bufferpin</structfield> <type>bigint</type> + </para> + <para> + Number of queries in this database that have been canceled due to + pinned buffers + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>confl_deadlock</structfield> <type>bigint</type> + </para> + <para> + Number of queries in this database that have been canceled due to + deadlocks + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2795,139 +3275,233 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-all-tables-view" xreflabel="pg_stat_all_tables"> <title><structname>pg_stat_all_tables</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of a table</entry> - </row> - <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema that this table is in</entry> - </row> - <row> - <entry><structfield>relname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this table</entry> - </row> - <row> - <entry><structfield>seq_scan</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of sequential scans initiated on this table</entry> - </row> - <row> - <entry><structfield>seq_tup_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of live rows fetched by sequential scans</entry> - </row> - <row> - <entry><structfield>idx_scan</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of index scans initiated on this table</entry> - </row> - <row> - <entry><structfield>idx_tup_fetch</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of live rows fetched by index scans</entry> - </row> - <row> - <entry><structfield>n_tup_ins</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows inserted</entry> - </row> - <row> - <entry><structfield>n_tup_upd</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows updated (includes HOT updated rows)</entry> - </row> - <row> - <entry><structfield>n_tup_del</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows deleted</entry> - </row> - <row> - <entry><structfield>n_tup_hot_upd</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of rows HOT updated (i.e., with no separate index - update required)</entry> - </row> - <row> - <entry><structfield>n_live_tup</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Estimated number of live rows</entry> - </row> - <row> - <entry><structfield>n_dead_tup</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Estimated number of dead rows</entry> - </row> - <row> - <entry><structfield>n_mod_since_analyze</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Estimated number of rows modified since this table was last analyzed</entry> - </row> - <row> - <entry><structfield>n_ins_since_vacuum</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Estimated number of rows inserted since this table was last vacuumed</entry> - </row> - <row> - <entry><structfield>last_vacuum</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Last time at which this table was manually vacuumed - (not counting <command>VACUUM FULL</command>)</entry> - </row> - <row> - <entry><structfield>last_autovacuum</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Last time at which this table was vacuumed by the autovacuum - daemon</entry> - </row> - <row> - <entry><structfield>last_analyze</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Last time at which this table was manually analyzed</entry> - </row> - <row> - <entry><structfield>last_autoanalyze</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Last time at which this table was analyzed by the autovacuum - daemon</entry> - </row> - <row> - <entry><structfield>vacuum_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times this table has been manually vacuumed - (not counting <command>VACUUM FULL</command>)</entry> - </row> - <row> - <entry><structfield>autovacuum_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times this table has been vacuumed by the autovacuum - daemon</entry> - </row> - <row> - <entry><structfield>analyze_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times this table has been manually analyzed</entry> - </row> - <row> - <entry><structfield>autoanalyze_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times this table has been analyzed by the autovacuum - daemon</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of a table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + </para> + <para> + Name of the schema that this table is in + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relname</structfield> <type>name</type> + </para> + <para> + Name of this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seq_scan</structfield> <type>bigint</type> + </para> + <para> + Number of sequential scans initiated on this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>seq_tup_read</structfield> <type>bigint</type> + </para> + <para> + Number of live rows fetched by sequential scans + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_scan</structfield> <type>bigint</type> + </para> + <para> + Number of index scans initiated on this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_tup_fetch</structfield> <type>bigint</type> + </para> + <para> + Number of live rows fetched by index scans + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_tup_ins</structfield> <type>bigint</type> + </para> + <para> + Number of rows inserted + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_tup_upd</structfield> <type>bigint</type> + </para> + <para> + Number of rows updated (includes HOT updated rows) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_tup_del</structfield> <type>bigint</type> + </para> + <para> + Number of rows deleted + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_tup_hot_upd</structfield> <type>bigint</type> + </para> + <para> + Number of rows HOT updated (i.e., with no separate index + update required) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_live_tup</structfield> <type>bigint</type> + </para> + <para> + Estimated number of live rows + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_dead_tup</structfield> <type>bigint</type> + </para> + <para> + Estimated number of dead rows + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_mod_since_analyze</structfield> <type>bigint</type> + </para> + <para> + Estimated number of rows modified since this table was last analyzed + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>n_ins_since_vacuum</structfield> <type>bigint</type> + </para> + <para> + Estimated number of rows inserted since this table was last vacuumed + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_vacuum</structfield> <type>timestamp with time zone</type> + </para> + <para> + Last time at which this table was manually vacuumed + (not counting <command>VACUUM FULL</command>) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_autovacuum</structfield> <type>timestamp with time zone</type> + </para> + <para> + Last time at which this table was vacuumed by the autovacuum + daemon + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_analyze</structfield> <type>timestamp with time zone</type> + </para> + <para> + Last time at which this table was manually analyzed + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>last_autoanalyze</structfield> <type>timestamp with time zone</type> + </para> + <para> + Last time at which this table was analyzed by the autovacuum + daemon + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>vacuum_count</structfield> <type>bigint</type> + </para> + <para> + Number of times this table has been manually vacuumed + (not counting <command>VACUUM FULL</command>) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>autovacuum_count</structfield> <type>bigint</type> + </para> + <para> + Number of times this table has been vacuumed by the autovacuum + daemon + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>analyze_count</structfield> <type>bigint</type> + </para> + <para> + Number of times this table has been manually analyzed + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>autoanalyze_count</structfield> <type>bigint</type> + </para> + <para> + Number of times this table has been analyzed by the autovacuum + daemon + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -2943,58 +3517,92 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-all-indexes-view" xreflabel="pg_stat_all_indexes"> <title><structname>pg_stat_all_indexes</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the table for this index</entry> - </row> - <row> - <entry><structfield>indexrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of this index</entry> - </row> - <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema this index is in</entry> - </row> - <row> - <entry><structfield>relname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the table for this index</entry> - </row> - <row> - <entry><structfield>indexrelname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this index</entry> - </row> - <row> - <entry><structfield>idx_scan</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of index scans initiated on this index</entry> - </row> - <row> - <entry><structfield>idx_tup_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of index entries returned by scans on this index</entry> - </row> - <row> - <entry><structfield>idx_tup_fetch</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of live table rows fetched by simple index scans using this - index</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the table for this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexrelid</structfield> <type>oid</type> + </para> + <para> + OID of this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + </para> + <para> + Name of the schema this index is in + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relname</structfield> <type>name</type> + </para> + <para> + Name of the table for this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexrelname</structfield> <type>name</type> + </para> + <para> + Name of this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_scan</structfield> <type>bigint</type> + </para> + <para> + Number of index scans initiated on this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_tup_read</structfield> <type>bigint</type> + </para> + <para> + Number of index entries returned by scans on this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_tup_fetch</structfield> <type>bigint</type> + </para> + <para> + Number of live table rows fetched by simple index scans using this + index + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -3039,72 +3647,118 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-statio-all-tables-view" xreflabel="pg_statio_all_tables"> <title><structname>pg_statio_all_tables</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of a table</entry> - </row> - <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema that this table is in</entry> - </row> - <row> - <entry><structfield>relname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this table</entry> - </row> - <row> - <entry><structfield>heap_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read from this table</entry> - </row> - <row> - <entry><structfield>heap_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffer hits in this table</entry> - </row> - <row> - <entry><structfield>idx_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read from all indexes on this table</entry> - </row> - <row> - <entry><structfield>idx_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffer hits in all indexes on this table</entry> - </row> - <row> - <entry><structfield>toast_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read from this table's TOAST table (if any)</entry> - </row> - <row> - <entry><structfield>toast_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffer hits in this table's TOAST table (if any)</entry> - </row> - <row> - <entry><structfield>tidx_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read from this table's TOAST table indexes (if any)</entry> - </row> - <row> - <entry><structfield>tidx_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffer hits in this table's TOAST table indexes (if any)</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of a table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + </para> + <para> + Name of the schema that this table is in + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relname</structfield> <type>name</type> + </para> + <para> + Name of this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read from this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of buffer hits in this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read from all indexes on this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of buffer hits in all indexes on this table + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>toast_blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read from this table's TOAST table (if any) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>toast_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of buffer hits in this table's TOAST table (if any) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tidx_blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read from this table's TOAST table indexes (if any) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tidx_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of buffer hits in this table's TOAST table indexes (if any) + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -3120,52 +3774,82 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-statio-all-indexes-view" xreflabel="pg_statio_all_indexes"> <title><structname>pg_statio_all_indexes</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the table for this index</entry> - </row> - <row> - <entry><structfield>indexrelid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of this index</entry> - </row> - <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema this index is in</entry> - </row> - <row> - <entry><structfield>relname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the table for this index</entry> - </row> - <row> - <entry><structfield>indexrelname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this index</entry> - </row> - <row> - <entry><structfield>idx_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read from this index</entry> - </row> - <row> - <entry><structfield>idx_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffer hits in this index</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the table for this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexrelid</structfield> <type>oid</type> + </para> + <para> + OID of this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + </para> + <para> + Name of the schema this index is in + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relname</structfield> <type>name</type> + </para> + <para> + Name of the table for this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>indexrelname</structfield> <type>name</type> + </para> + <para> + Name of this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read from this index + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>idx_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of buffer hits in this index + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -3181,42 +3865,64 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-statio-all-sequences-view" xreflabel="pg_statio_all_sequences"> <title><structname>pg_statio_all_sequences</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of a sequence</entry> - </row> - <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema this sequence is in</entry> - </row> - <row> - <entry><structfield>relname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this sequence</entry> - </row> - <row> - <entry><structfield>blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read from this sequence</entry> - </row> - <row> - <entry><structfield>blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of buffer hits in this sequence</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of a sequence + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + </para> + <para> + Name of the schema this sequence is in + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relname</structfield> <type>name</type> + </para> + <para> + Name of this sequence + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read from this sequence + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of buffer hits in this sequence + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -3228,49 +3934,75 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-user-functions-view" xreflabel="pg_stat_user_functions"> <title><structname>pg_stat_user_functions</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>funcid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of a function</entry> - </row> - <row> - <entry><structfield>schemaname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the schema this function is in</entry> - </row> - <row> - <entry><structfield>funcname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of this function</entry> - </row> - <row> - <entry><structfield>calls</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times this function has been called</entry> - </row> - <row> - <entry><structfield>total_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry>Total time spent in this function and all other functions - called by it, in milliseconds</entry> - </row> - <row> - <entry><structfield>self_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry>Total time spent in this function itself, not including - other functions called by it, in milliseconds</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>funcid</structfield> <type>oid</type> + </para> + <para> + OID of a function + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>schemaname</structfield> <type>name</type> + </para> + <para> + Name of the schema this function is in + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>funcname</structfield> <type>name</type> + </para> + <para> + Name of this function + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>calls</structfield> <type>bigint</type> + </para> + <para> + Number of times this function has been called + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>total_time</structfield> <type>double precision</type> + </para> + <para> + Total time spent in this function and all other functions + called by it, in milliseconds + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>self_time</structfield> <type>double precision</type> + </para> + <para> + Total time spent in this function itself, not including + other functions called by it, in milliseconds + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -3282,65 +4014,102 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i <table id="pg-stat-slru-view" xreflabel="pg_stat_slru"> <title><structname>pg_stat_slru</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>name</structfield></entry> - <entry><type>text</type></entry> - <entry>name of the SLRU</entry> - </row> - <row> - <entry><structfield>blks_zeroed</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of blocks zeroed during initializations</entry> - </row> - <row> - <entry><structfield>blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of times disk blocks were found already in the SLRU, - so that a read was not necessary (this only includes hits in the - SLRU, not the operating system's file system cache) - </entry> - </row> - <row> - <entry><structfield>blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks read for this SLRU</entry> - </row> - <row> - <entry><structfield>blks_written</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of disk blocks written for this SLRU</entry> - </row> - <row> - <entry><structfield>blks_exists</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of blocks checked for existence for this SLRU</entry> - </row> - <row> - <entry><structfield>flushes</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of flushes of dirty data for this SLRU</entry> - </row> - <row> - <entry><structfield>truncates</structfield></entry> - <entry><type>bigint</type></entry> - <entry>Number of truncates for this SLRU</entry> - </row> - <row> - <entry><structfield>stats_reset</structfield></entry> - <entry><type>timestamp with time zone</type></entry> - <entry>Time at which these statistics were last reset</entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>name</structfield> <type>text</type> + </para> + <para> + name of the SLRU + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_zeroed</structfield> <type>bigint</type> + </para> + <para> + Number of blocks zeroed during initializations + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_hit</structfield> <type>bigint</type> + </para> + <para> + Number of times disk blocks were found already in the SLRU, + so that a read was not necessary (this only includes hits in the + SLRU, not the operating system's file system cache) + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_read</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks read for this SLRU + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_written</structfield> <type>bigint</type> + </para> + <para> + Number of disk blocks written for this SLRU + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blks_exists</structfield> <type>bigint</type> + </para> + <para> + Number of blocks checked for existence for this SLRU + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>flushes</structfield> <type>bigint</type> + </para> + <para> + Number of flushes of dirty data for this SLRU + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>truncates</structfield> <type>bigint</type> + </para> + <para> + Number of truncates for this SLRU + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stats_reset</structfield> <type>timestamp with time zone</type> + </para> + <para> + Time at which these statistics were last reset + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -3828,95 +4597,131 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, <table id="pg-stat-progress-analyze-view" xreflabel="pg_stat_progress_analyze"> <title><structname>pg_stat_progress_analyze</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of backend.</entry> - </row> - <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the database to which this backend is connected.</entry> - </row> - <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the database to which this backend is connected.</entry> - </row> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the table being analyzed.</entry> - </row> - <row> - <entry><structfield>phase</structfield></entry> - <entry><type>text</type></entry> - <entry>Current processing phase. See <xref linkend="analyze-phases" />.</entry> - </row> - <row> - <entry><structfield>sample_blks_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Total number of heap blocks that will be sampled. - </entry> - </row> - <row> - <entry><structfield>sample_blks_scanned</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of heap blocks scanned. - </entry> - </row> - <row> - <entry><structfield>ext_stats_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of extended statistics. - </entry> - </row> - <row> - <entry><structfield>ext_stats_computed</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of extended statistics computed. This counter only advances - when the phase is <literal>computing extended statistics</literal>. - </entry> - </row> - <row> - <entry><structfield>child_tables_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of child tables. - </entry> - </row> - <row> - <entry><structfield>child_tables_done</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of child tables scanned. This counter only advances when the - phase is <literal>acquiring inherited sample rows</literal>. - </entry> - </row> - <row> - <entry><structfield>current_child_table_relid</structfield></entry> - <entry><type>oid</type></entry> - <entry> - OID of the child table currently being scanned. This field is - only valid when the phase is - <literal>acquiring inherited sample rows</literal>. - </entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of backend. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of the database to which this backend is connected. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of the database to which this backend is connected. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the table being analyzed. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>phase</structfield> <type>text</type> + </para> + <para> + Current processing phase. See <xref linkend="analyze-phases"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sample_blks_total</structfield> <type>bigint</type> + </para> + <para> + Total number of heap blocks that will be sampled. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>sample_blks_scanned</structfield> <type>bigint</type> + </para> + <para> + Number of heap blocks scanned. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ext_stats_total</structfield> <type>bigint</type> + </para> + <para> + Number of extended statistics. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>ext_stats_computed</structfield> <type>bigint</type> + </para> + <para> + Number of extended statistics computed. This counter only advances + when the phase is <literal>computing extended statistics</literal>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>child_tables_total</structfield> <type>bigint</type> + </para> + <para> + Number of child tables. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>child_tables_done</structfield> <type>bigint</type> + </para> + <para> + Number of child tables scanned. This counter only advances when the + phase is <literal>acquiring inherited sample rows</literal>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>current_child_table_relid</structfield> <type>oid</type> + </para> + <para> + OID of the child table currently being scanned. This field is + only valid when the phase is + <literal>acquiring inherited sample rows</literal>. + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -4005,122 +4810,166 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, <table id="pg-stat-progress-create-index-view" xreflabel="pg_stat_progress_create_index"> <title><structname>pg_stat_progress_create_index</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> <tbody> <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of backend.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of backend. + </para></entry> </row> + <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the database to which this backend is connected.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of the database to which this backend is connected. + </para></entry> </row> + <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the database to which this backend is connected.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of the database to which this backend is connected. + </para></entry> </row> + <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the table on which the index is being created.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the table on which the index is being created. + </para></entry> </row> + <row> - <entry><structfield>index_relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the index being created or reindexed. During a - non-concurrent <command>CREATE INDEX</command>, this is 0.</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>index_relid</structfield> <type>oid</type> + </para> + <para> + OID of the index being created or reindexed. During a + non-concurrent <command>CREATE INDEX</command>, this is 0. + </para></entry> </row> + <row> - <entry><structfield>command</structfield></entry> - <entry><type>text</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>command</structfield> <type>text</type> + </para> + <para> The command that is running: <literal>CREATE INDEX</literal>, <literal>CREATE INDEX CONCURRENTLY</literal>, <literal>REINDEX</literal>, or <literal>REINDEX CONCURRENTLY</literal>. - </entry> + </para></entry> </row> + <row> - <entry><structfield>phase</structfield></entry> - <entry><type>text</type></entry> - <entry> - Current processing phase of index creation. See <xref linkend='create-index-phases'/>. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>phase</structfield> <type>text</type> + </para> + <para> + Current processing phase of index creation. See <xref linkend="create-index-phases"/>. + </para></entry> </row> + <row> - <entry><structfield>lockers_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Total number of lockers to wait for, when applicable. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lockers_total</structfield> <type>bigint</type> + </para> + <para> + Total number of lockers to wait for, when applicable. + </para></entry> </row> + <row> - <entry><structfield>lockers_done</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of lockers already waited for. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>lockers_done</structfield> <type>bigint</type> + </para> + <para> + Number of lockers already waited for. + </para></entry> </row> + <row> - <entry><structfield>current_locker_pid</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Process ID of the locker currently being waited for. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>current_locker_pid</structfield> <type>bigint</type> + </para> + <para> + Process ID of the locker currently being waited for. + </para></entry> </row> + <row> - <entry><structfield>blocks_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Total number of blocks to be processed in the current phase. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blocks_total</structfield> <type>bigint</type> + </para> + <para> + Total number of blocks to be processed in the current phase. + </para></entry> </row> + <row> - <entry><structfield>blocks_done</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of blocks already processed in the current phase. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blocks_done</structfield> <type>bigint</type> + </para> + <para> + Number of blocks already processed in the current phase. + </para></entry> </row> + <row> - <entry><structfield>tuples_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Total number of tuples to be processed in the current phase. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tuples_total</structfield> <type>bigint</type> + </para> + <para> + Total number of tuples to be processed in the current phase. + </para></entry> </row> + <row> - <entry><structfield>tuples_done</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of tuples already processed in the current phase. - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tuples_done</structfield> <type>bigint</type> + </para> + <para> + Number of tuples already processed in the current phase. + </para></entry> </row> + <row> - <entry><structfield>partitions_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partitions_total</structfield> <type>bigint</type> + </para> + <para> When creating an index on a partitioned table, this column is set to the total number of partitions on which the index is to be created. - </entry> + </para></entry> </row> + <row> - <entry><structfield>partitions_done</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>partitions_done</structfield> <type>bigint</type> + </para> + <para> When creating an index on a partitioned table, this column is set to the number of partitions on which the index has been completed. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -4262,98 +5111,130 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, <table id="pg-stat-progress-vacuum-view" xreflabel="pg_stat_progress_vacuum"> <title><structname>pg_stat_progress_vacuum</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of backend.</entry> - </row> - <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the database to which this backend is connected.</entry> - </row> - <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the database to which this backend is connected.</entry> - </row> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the table being vacuumed.</entry> - </row> - <row> - <entry><structfield>phase</structfield></entry> - <entry><type>text</type></entry> - <entry> - Current processing phase of vacuum. See <xref linkend='vacuum-phases'/>. - </entry> - </row> - <row> - <entry><structfield>heap_blks_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of backend. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of the database to which this backend is connected. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of the database to which this backend is connected. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the table being vacuumed. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>phase</structfield> <type>text</type> + </para> + <para> + Current processing phase of vacuum. See <xref linkend="vacuum-phases"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_total</structfield> <type>bigint</type> + </para> + <para> Total number of heap blocks in the table. This number is reported as of the beginning of the scan; blocks added later will not be (and need not be) visited by this <command>VACUUM</command>. - </entry> - </row> - <row> - <entry><structfield>heap_blks_scanned</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_scanned</structfield> <type>bigint</type> + </para> + <para> Number of heap blocks scanned. Because the <link linkend="storage-vm">visibility map</link> is used to optimize scans, some blocks will be skipped without inspection; skipped blocks are included in this total, so that this number will eventually become equal to <structfield>heap_blks_total</structfield> when the vacuum is complete. This counter only advances when the phase is <literal>scanning heap</literal>. - </entry> - </row> - <row> - <entry><structfield>heap_blks_vacuumed</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_vacuumed</structfield> <type>bigint</type> + </para> + <para> Number of heap blocks vacuumed. Unless the table has no indexes, this counter only advances when the phase is <literal>vacuuming heap</literal>. Blocks that contain no dead tuples are skipped, so the counter may sometimes skip forward in large increments. - </entry> - </row> - <row> - <entry><structfield>index_vacuum_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>index_vacuum_count</structfield> <type>bigint</type> + </para> + <para> Number of completed index vacuum cycles. - </entry> - </row> - <row> - <entry><structfield>max_dead_tuples</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of dead tuples that we can store before needing to perform - an index vacuum cycle, based on - <xref linkend="guc-maintenance-work-mem"/>. - </entry> - </row> - <row> - <entry><structfield>num_dead_tuples</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>max_dead_tuples</structfield> <type>bigint</type> + </para> + <para> + Number of dead tuples that we can store before needing to perform + an index vacuum cycle, based on + <xref linkend="guc-maintenance-work-mem"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>num_dead_tuples</structfield> <type>bigint</type> + </para> + <para> Number of dead tuples collected since the last index vacuum cycle. - </entry> - </row> - </tbody> + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -4451,105 +5332,139 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, <table id="pg-stat-progress-cluster-view" xreflabel="pg_stat_progress_cluster"> <title><structname>pg_stat_progress_cluster</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of backend.</entry> - </row> - <row> - <entry><structfield>datid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the database to which this backend is connected.</entry> - </row> - <row> - <entry><structfield>datname</structfield></entry> - <entry><type>name</type></entry> - <entry>Name of the database to which this backend is connected.</entry> - </row> - <row> - <entry><structfield>relid</structfield></entry> - <entry><type>oid</type></entry> - <entry>OID of the table being clustered.</entry> - </row> - <row> - <entry><structfield>command</structfield></entry> - <entry><type>text</type></entry> - <entry> - The command that is running. Either <literal>CLUSTER</literal> or <literal>VACUUM FULL</literal>. - </entry> - </row> - <row> - <entry><structfield>phase</structfield></entry> - <entry><type>text</type></entry> - <entry> - Current processing phase. See <xref linkend='cluster-phases' />. - </entry> - </row> - <row> - <entry><structfield>cluster_index_relid</structfield></entry> - <entry><type>oid</type></entry> - <entry> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of backend. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datid</structfield> <type>oid</type> + </para> + <para> + OID of the database to which this backend is connected. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>datname</structfield> <type>name</type> + </para> + <para> + Name of the database to which this backend is connected. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relid</structfield> <type>oid</type> + </para> + <para> + OID of the table being clustered. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>command</structfield> <type>text</type> + </para> + <para> + The command that is running. Either <literal>CLUSTER</literal> or <literal>VACUUM FULL</literal>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>phase</structfield> <type>text</type> + </para> + <para> + Current processing phase. See <xref linkend="cluster-phases"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>cluster_index_relid</structfield> <type>oid</type> + </para> + <para> If the table is being scanned using an index, this is the OID of the index being used; otherwise, it is zero. - </entry> - </row> - <row> - <entry><structfield>heap_tuples_scanned</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_tuples_scanned</structfield> <type>bigint</type> + </para> + <para> Number of heap tuples scanned. This counter only advances when the phase is <literal>seq scanning heap</literal>, <literal>index scanning heap</literal> or <literal>writing new heap</literal>. - </entry> - </row> - <row> - <entry><structfield>heap_tuples_written</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_tuples_written</structfield> <type>bigint</type> + </para> + <para> Number of heap tuples written. This counter only advances when the phase is <literal>seq scanning heap</literal>, <literal>index scanning heap</literal> or <literal>writing new heap</literal>. - </entry> - </row> - <row> - <entry><structfield>heap_blks_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_total</structfield> <type>bigint</type> + </para> + <para> Total number of heap blocks in the table. This number is reported as of the beginning of <literal>seq scanning heap</literal>. - </entry> - </row> - <row> - <entry><structfield>heap_blks_scanned</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>heap_blks_scanned</structfield> <type>bigint</type> + </para> + <para> Number of heap blocks scanned. This counter only advances when the phase is <literal>seq scanning heap</literal>. - </entry> - </row> - <row> - <entry><structfield>index_rebuild_count</structfield></entry> - <entry><type>bigint</type></entry> - <entry> + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>index_rebuild_count</structfield> <type>bigint</type> + </para> + <para> Number of indexes rebuilt. This counter only advances when the phase is <literal>rebuilding index</literal>. - </entry> - </row> - </tbody> + </para></entry> + </row> + </tbody> </tgroup> </table> @@ -4637,69 +5552,87 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, <table id="pg-stat-progress-basebackup-view" xreflabel="pg_stat_progress_basebackup"> <title><structname>pg_stat_progress_basebackup</structname> View</title> - <tgroup cols="3"> + <tgroup cols="1"> <thead> - <row> - <entry>Column</entry> - <entry>Type</entry> - <entry>Description</entry> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> - <row> - <entry><structfield>pid</structfield></entry> - <entry><type>integer</type></entry> - <entry>Process ID of a WAL sender process.</entry> - </row> - <row> - <entry><structfield>phase</structfield></entry> - <entry><type>text</type></entry> - <entry>Current processing phase. See <xref linkend="basebackup-phases" />.</entry> - </row> - <row> - <entry><structfield>backup_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Total amount of data that will be streamed. This is estimated and - reported as of the beginning of - <literal>streaming database files</literal> phase. Note that - this is only an approximation since the database - may change during <literal>streaming database files</literal> phase - and WAL log may be included in the backup later. This is always - the same value as <structfield>backup_streamed</structfield> - once the amount of data streamed exceeds the estimated - total size. If the estimation is disabled in - <application>pg_basebackup</application> - (i.e., <literal>--no-estimate-size</literal> option is specified), - this is <literal>NULL</literal>. - </entry> - </row> - <row> - <entry><structfield>backup_streamed</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Amount of data streamed. This counter only advances - when the phase is <literal>streaming database files</literal> or - <literal>transferring wal files</literal>. - </entry> - </row> - <row> - <entry><structfield>tablespaces_total</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Total number of tablespaces that will be streamed. - </entry> - </row> - <row> - <entry><structfield>tablespaces_streamed</structfield></entry> - <entry><type>bigint</type></entry> - <entry> - Number of tablespaces streamed. This counter only - advances when the phase is <literal>streaming database files</literal>. - </entry> - </row> - </tbody> + <tbody> + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pid</structfield> <type>integer</type> + </para> + <para> + Process ID of a WAL sender process. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>phase</structfield> <type>text</type> + </para> + <para> + Current processing phase. See <xref linkend="basebackup-phases"/>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backup_total</structfield> <type>bigint</type> + </para> + <para> + Total amount of data that will be streamed. This is estimated and + reported as of the beginning of + <literal>streaming database files</literal> phase. Note that + this is only an approximation since the database + may change during <literal>streaming database files</literal> phase + and WAL log may be included in the backup later. This is always + the same value as <structfield>backup_streamed</structfield> + once the amount of data streamed exceeds the estimated + total size. If the estimation is disabled in + <application>pg_basebackup</application> + (i.e., <literal>--no-estimate-size</literal> option is specified), + this is <literal>NULL</literal>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>backup_streamed</structfield> <type>bigint</type> + </para> + <para> + Amount of data streamed. This counter only advances + when the phase is <literal>streaming database files</literal> or + <literal>transferring wal files</literal>. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablespaces_total</structfield> <type>bigint</type> + </para> + <para> + Total number of tablespaces that will be streamed. + </para></entry> + </row> + + <row> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>tablespaces_streamed</structfield> <type>bigint</type> + </para> + <para> + Number of tablespaces streamed. This counter only + advances when the phase is <literal>streaming database files</literal>. + </para></entry> + </row> + </tbody> </tgroup> </table> diff --git a/doc/src/sgml/pgbuffercache.sgml b/doc/src/sgml/pgbuffercache.sgml index b2b5bce480c..bebbc6b732d 100644 --- a/doc/src/sgml/pgbuffercache.sgml +++ b/doc/src/sgml/pgbuffercache.sgml @@ -38,82 +38,103 @@ <table id="pgbuffercache-columns"> <title><structname>pg_buffercache</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> - <tbody> + <tbody> <row> - <entry><structfield>bufferid</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry>ID, in the range 1..<varname>shared_buffers</varname></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>bufferid</structfield> <type>integer</type> + </para> + <para> + ID, in the range 1..<varname>shared_buffers</varname> + </para></entry> </row> <row> - <entry><structfield>relfilenode</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal>pg_class.relfilenode</literal></entry> - <entry>Filenode number of the relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relfilenode</structfield> <type>oid</type> + (references <link linkend="catalog-pg-class"><structname>pg_class</structname></link>.<structfield>relfilenode</structfield>) + </para> + <para> + Filenode number of the relation + </para></entry> </row> <row> - <entry><structfield>reltablespace</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal>pg_tablespace.oid</literal></entry> - <entry>Tablespace OID of the relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reltablespace</structfield> <type>oid</type> + (references <link linkend="catalog-pg-tablespace"><structname>pg_tablespace</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Tablespace OID of the relation + </para></entry> </row> <row> - <entry><structfield>reldatabase</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal>pg_database.oid</literal></entry> - <entry>Database OID of the relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>reldatabase</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> + Database OID of the relation + </para></entry> </row> <row> - <entry><structfield>relforknumber</structfield></entry> - <entry><type>smallint</type></entry> - <entry></entry> - <entry>Fork number within the relation; see - <filename>include/common/relpath.h</filename></entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relforknumber</structfield> <type>smallint</type> + </para> + <para> + Fork number within the relation; see + <filename>include/common/relpath.h</filename> + </para></entry> </row> <row> - <entry><structfield>relblocknumber</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Page number within the relation</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>relblocknumber</structfield> <type>bigint</type> + </para> + <para> + Page number within the relation + </para></entry> </row> <row> - <entry><structfield>isdirty</structfield></entry> - <entry><type>boolean</type></entry> - <entry></entry> - <entry>Is the page dirty?</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>isdirty</structfield> <type>boolean</type> + </para> + <para> + Is the page dirty? + </para></entry> </row> <row> - <entry><structfield>usagecount</structfield></entry> - <entry><type>smallint</type></entry> - <entry></entry> - <entry>Clock-sweep access count</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>usagecount</structfield> <type>smallint</type> + </para> + <para> + Clock-sweep access count + </para></entry> </row> <row> - <entry><structfield>pinning_backends</structfield></entry> - <entry><type>integer</type></entry> - <entry></entry> - <entry>Number of backends pinning this buffer</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>pinning_backends</structfield> <type>integer</type> + </para> + <para> + Number of backends pinning this buffer + </para></entry> </row> - </tbody> </tgroup> </table> diff --git a/doc/src/sgml/pgstatstatements.sgml b/doc/src/sgml/pgstatstatements.sgml index b1d5f3d1dcb..8eddb6ab79a 100644 --- a/doc/src/sgml/pgstatstatements.sgml +++ b/doc/src/sgml/pgstatstatements.sgml @@ -44,253 +44,310 @@ <table id="pgstatstatements-columns"> <title><structname>pg_stat_statements</structname> Columns</title> - - <tgroup cols="4"> + <tgroup cols="1"> <thead> <row> - <entry>Name</entry> - <entry>Type</entry> - <entry>References</entry> - <entry>Description</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + Column Type + </para> + <para> + Description + </para></entry> </row> </thead> + <tbody> <row> - <entry><structfield>userid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry> - <entry>OID of user who executed the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>userid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of user who executed the statement + </para></entry> </row> <row> - <entry><structfield>dbid</structfield></entry> - <entry><type>oid</type></entry> - <entry><literal><link linkend="catalog-pg-database"><structname>pg_database</structname></link>.oid</literal></entry> - <entry>OID of database in which the statement was executed</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>dbid</structfield> <type>oid</type> + (references <link linkend="catalog-pg-database"><structname>pg_database</structname></link>.<structfield>oid</structfield>) + </para> + <para> + OID of database in which the statement was executed + </para></entry> </row> <row> - <entry><structfield>queryid</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Internal hash code, computed from the statement's parse tree</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>queryid</structfield> <type>bigint</type> + </para> + <para> + Internal hash code, computed from the statement's parse tree + </para></entry> </row> <row> - <entry><structfield>query</structfield></entry> - <entry><type>text</type></entry> - <entry></entry> - <entry>Text of a representative statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>query</structfield> <type>text</type> + </para> + <para> + Text of a representative statement + </para></entry> </row> <row> - <entry><structfield>plans</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Number of times the statement was planned</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>plans</structfield> <type>bigint</type> + </para> + <para> + Number of times the statement was planned + </para></entry> </row> <row> - <entry><structfield>total_plan_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Total time spent planning the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>total_plan_time</structfield> <type>double precision</type> + </para> + <para> + Total time spent planning the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>min_plan_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Minimum time spent planning the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>min_plan_time</structfield> <type>double precision</type> + </para> + <para> + Minimum time spent planning the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>max_plan_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Maximum time spent planning the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>max_plan_time</structfield> <type>double precision</type> + </para> + <para> + Maximum time spent planning the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>mean_plan_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Mean time spent planning the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>mean_plan_time</structfield> <type>double precision</type> + </para> + <para> + Mean time spent planning the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>stddev_plan_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Population standard deviation of time spent planning the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stddev_plan_time</structfield> <type>double precision</type> + </para> + <para> + Population standard deviation of time spent planning the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>calls</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Number of times the statement was executed</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>calls</structfield> <type>bigint</type> + </para> + <para> + Number of times the statement was executed + </para></entry> </row> <row> - <entry><structfield>total_exec_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Total time spent executing the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>total_exec_time</structfield> <type>double precision</type> + </para> + <para> + Total time spent executing the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>min_exec_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Minimum time spent executing the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>min_exec_time</structfield> <type>double precision</type> + </para> + <para> + Minimum time spent executing the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>max_exec_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Maximum time spent executing the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>max_exec_time</structfield> <type>double precision</type> + </para> + <para> + Maximum time spent executing the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>mean_exec_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Mean time spent executing the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>mean_exec_time</structfield> <type>double precision</type> + </para> + <para> + Mean time spent executing the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>stddev_exec_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry>Population standard deviation of time spent executing the statement, in milliseconds</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>stddev_exec_time</structfield> <type>double precision</type> + </para> + <para> + Population standard deviation of time spent executing the statement, in milliseconds + </para></entry> </row> <row> - <entry><structfield>rows</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of rows retrieved or affected by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>rows</structfield> <type>bigint</type> + </para> + <para> + Total number of rows retrieved or affected by the statement + </para></entry> </row> <row> - <entry><structfield>shared_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of shared block cache hits by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>shared_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Total number of shared block cache hits by the statement + </para></entry> </row> <row> - <entry><structfield>shared_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of shared blocks read by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>shared_blks_read</structfield> <type>bigint</type> + </para> + <para> + Total number of shared blocks read by the statement + </para></entry> </row> <row> - <entry><structfield>shared_blks_dirtied</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of shared blocks dirtied by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>shared_blks_dirtied</structfield> <type>bigint</type> + </para> + <para> + Total number of shared blocks dirtied by the statement + </para></entry> </row> <row> - <entry><structfield>shared_blks_written</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of shared blocks written by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>shared_blks_written</structfield> <type>bigint</type> + </para> + <para> + Total number of shared blocks written by the statement + </para></entry> </row> <row> - <entry><structfield>local_blks_hit</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of local block cache hits by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>local_blks_hit</structfield> <type>bigint</type> + </para> + <para> + Total number of local block cache hits by the statement + </para></entry> </row> <row> - <entry><structfield>local_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of local blocks read by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>local_blks_read</structfield> <type>bigint</type> + </para> + <para> + Total number of local blocks read by the statement + </para></entry> </row> <row> - <entry><structfield>local_blks_dirtied</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of local blocks dirtied by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>local_blks_dirtied</structfield> <type>bigint</type> + </para> + <para> + Total number of local blocks dirtied by the statement + </para></entry> </row> <row> - <entry><structfield>local_blks_written</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of local blocks written by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>local_blks_written</structfield> <type>bigint</type> + </para> + <para> + Total number of local blocks written by the statement + </para></entry> </row> <row> - <entry><structfield>temp_blks_read</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of temp blocks read by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>temp_blks_read</structfield> <type>bigint</type> + </para> + <para> + Total number of temp blocks read by the statement + </para></entry> </row> <row> - <entry><structfield>temp_blks_written</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry>Total number of temp blocks written by the statement</entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>temp_blks_written</structfield> <type>bigint</type> + </para> + <para> + Total number of temp blocks written by the statement + </para></entry> </row> <row> - <entry><structfield>blk_read_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry> - Total time the statement spent reading blocks, in milliseconds - (if <xref linkend="guc-track-io-timing"/> is enabled, otherwise zero) - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blk_read_time</structfield> <type>double precision</type> + </para> + <para> + Total time the statement spent reading blocks, in milliseconds + (if <xref linkend="guc-track-io-timing"/> is enabled, otherwise zero) + </para></entry> </row> <row> - <entry><structfield>blk_write_time</structfield></entry> - <entry><type>double precision</type></entry> - <entry></entry> - <entry> - Total time the statement spent writing blocks, in milliseconds - (if <xref linkend="guc-track-io-timing"/> is enabled, otherwise zero) - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>blk_write_time</structfield> <type>double precision</type> + </para> + <para> + Total time the statement spent writing blocks, in milliseconds + (if <xref linkend="guc-track-io-timing"/> is enabled, otherwise zero) + </para></entry> </row> <row> - <entry><structfield>wal_bytes</structfield></entry> - <entry><type>numeric</type></entry> - <entry></entry> - <entry> - Total amount of WAL bytes generated by the statement - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>wal_records</structfield> <type>bigint</type> + </para> + <para> + Total number of WAL records generated by the statement + </para></entry> </row> <row> - <entry><structfield>wal_records</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry> - Total number of WAL records generated by the statement - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>wal_fpi</structfield> <type>bigint</type> + </para> + <para> + Total number of WAL full page images generated by the statement + </para></entry> </row> <row> - <entry><structfield>wal_fpi</structfield></entry> - <entry><type>bigint</type></entry> - <entry></entry> - <entry> - Total number of WAL full page images generated by the statement - </entry> + <entry role="catalog_table_entry"><para role="column_definition"> + <structfield>wal_bytes</structfield> <type>numeric</type> + </para> + <para> + Total amount of WAL bytes generated by the statement + </para></entry> </row> - </tbody> </tgroup> </table> diff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xsl index 52369cd6725..0c4dff92c46 100644 --- a/doc/src/sgml/stylesheet-fo.xsl +++ b/doc/src/sgml/stylesheet-fo.xsl @@ -79,6 +79,16 @@ </fo:block> </xsl:template> +<!-- formatting for entries in tables of catalog/view columns --> +<xsl:template match="entry[@role='catalog_table_entry']/para"> + <fo:block margin-left="4em" text-align="left"> + <xsl:if test="self::para[@role='column_definition']"> + <xsl:attribute name="text-indent">-3.5em</xsl:attribute> + </xsl:if> + <xsl:apply-templates/> + </fo:block> +</xsl:template> + <!-- overrides stylesheet-common.xsl --> <!-- FOP needs us to be explicit about the font to use for right arrow --> <xsl:template match="returnvalue"> diff --git a/doc/src/sgml/stylesheet.css b/doc/src/sgml/stylesheet.css index 11f88cc0be5..6410a479580 100644 --- a/doc/src/sgml/stylesheet.css +++ b/doc/src/sgml/stylesheet.css @@ -96,6 +96,36 @@ td.func_table_entry pre.programlisting { padding-left: 4em; } +/* formatting for entries in tables of catalog/view columns */ + +th.catalog_table_entry p, +td.catalog_table_entry p { + margin-top: 0.1em; + margin-bottom: 0.1em; + padding-left: 4em; + text-align: left; +} + +th.catalog_table_entry p.column_definition { + text-indent: -3.5em; + word-spacing: 0.25em; +} + +td.catalog_table_entry p.column_definition { + text-indent: -3.5em; +} + +p.column_definition code.type { + padding-left: 0.25em; + padding-right: 0.25em; +} + +td.catalog_table_entry pre.programlisting { + margin-top: 0.1em; + margin-bottom: 0.1em; + padding-left: 4em; +} + /* Put these here instead of inside the HTML (see unsetting of admon.style in XSL) so that the web site stylesheet can set its own style. */ @@ -115,6 +145,10 @@ pre.literallayout, .screen, .synopsis, .programlisting { margin-left: 4ex; } +ul.itemizedlist { + margin-left: 2.5rem; +} + .comment { color: red; } var { font-family: monospace; font-style: italic; } |