-<!-- $PostgreSQL: pgsql/doc/src/sgml/information_schema.sgml,v 1.14 2004/01/24 23:45:13 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/information_schema.sgml,v 1.15 2004/02/29 15:36:46 neilc Exp $ -->
<chapter id="information-schema">
<title>The Information Schema</title>
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the user or group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <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>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table that contains the column</entry>
</row>
<row>
- <entry><literal>column_name</literal</entry>
+ <entry><literal>column_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the column</entry>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Type of the privilege: <literal>SELECT</literal>,
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the schema that contains the table that contains the
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the table that contains the column that is used by some
</row>
<row>
- <entry><literal>column_name</literal</entry>
+ <entry><literal>column_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the column that is used by some constraint
</row>
<row>
- <entry><literal>constraint_schema</literal</entry>
+ <entry><literal>constraint_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the constraint</entry>
</row>
<row>
- <entry><literal>constraint_name</literal</entry>
+ <entry><literal>constraint_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the constraint</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the schema that contains the table that is used by some
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table that is used by some constraint</entry>
</row>
</row>
<row>
- <entry><literal>constraint_schema</literal</entry>
+ <entry><literal>constraint_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the constraint</entry>
</row>
<row>
- <entry><literal>constraint_name</literal</entry>
+ <entry><literal>constraint_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the constraint</entry>
</row>
</row>
<row>
- <entry><literal>object_schema</literal</entry>
+ <entry><literal>object_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the described object</entry>
</row>
<row>
- <entry><literal>object_name</literal</entry>
+ <entry><literal>object_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the described object</entry>
</row>
<row>
- <entry><literal>object_type</literal</entry>
+ <entry><literal>object_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
The type of the described object: one of
</row>
<row>
- <entry><literal>dtd_identifier</literal</entry>
+ <entry><literal>dtd_identifier</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
The identifier of the data type descriptor, which is unique
</row>
<row>
- <entry><literal>constraint_schema</literal</entry>
+ <entry><literal>constraint_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the constraint</entry>
</row>
<row>
- <entry><literal>constraint_name</literal</entry>
+ <entry><literal>constraint_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the constraint</entry>
</row>
</row>
<row>
- <entry><literal>domain_schema</literal</entry>
+ <entry><literal>domain_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the domain</entry>
</row>
<row>
- <entry><literal>domain_name</literal</entry>
+ <entry><literal>domain_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the domain</entry>
</row>
</row>
<row>
- <entry><literal>domain_schema</literal</entry>
+ <entry><literal>domain_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the domain</entry>
</row>
<row>
- <entry><literal>domain_name</literal</entry>
+ <entry><literal>domain_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the domain</entry>
</row>
</row>
<row>
- <entry><literal>domain_schema</literal</entry>
+ <entry><literal>domain_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the domain</entry>
</row>
<row>
- <entry><literal>domain_name</literal</entry>
+ <entry><literal>domain_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the domain</entry>
</row>
</row>
<row>
- <entry><literal>object_schema</literal</entry>
+ <entry><literal>object_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the schema that contains the object that uses the array
</row>
<row>
- <entry><literal>object_name</literal</entry>
+ <entry><literal>object_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the object that uses the array being described
</row>
<row>
- <entry><literal>object_type</literal</entry>
+ <entry><literal>object_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
The type of the object that uses the array being described: one
</row>
<row>
- <entry><literal>array_type_identifier</literal</entry>
+ <entry><literal>array_type_identifier</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
The identifier of the data type descriptor of the array being
</row>
<row>
- <entry><literal>constraint_schema</literal</entry>
+ <entry><literal>constraint_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the constraint</entry>
</row>
<row>
- <entry><literal>constraint_name</literal</entry>
+ <entry><literal>constraint_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the constraint</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the schema that contains the table that contains the
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the table that contains the column that is restricted
</row>
<row>
- <entry><literal>column_name</literal</entry>
+ <entry><literal>column_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the column that is restricted by some constraint
</row>
<row>
- <entry><literal>ordinal_position</literal</entry>
+ <entry><literal>ordinal_position</literal></entry>
<entry><type>cardinal_number</type></entry>
<entry>
Ordinal position of the column within the constraint key (count
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <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>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table that contains the column</entry>
</row>
<row>
- <entry><literal>column_name</literal</entry>
+ <entry><literal>column_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the column</entry>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Type of the privilege: <literal>SELECT</literal>,
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>Always <literal>EXECUTE</literal> (the only privilege type for functions)</entry>
</row>
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the table</entry>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table</entry>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Type of the privilege: <literal>SELECT</literal>,
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>In the future, the name of the group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>Always <literal>USAGE</literal></entry>
</row>
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the user or group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>Always <literal>EXECUTE</literal> (the only privilege type for functions)</entry>
</row>
</row>
<row>
- <entry><literal>constraint_schema</literal</entry>
+ <entry><literal>constraint_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the constraint</entry>
</row>
<row>
- <entry><literal>constraint_name</literal</entry>
+ <entry><literal>constraint_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the constraint</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the table</entry>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table</entry>
</row>
<row>
- <entry><literal>constraint_type</literal</entry>
+ <entry><literal>constraint_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Type of the constraint: <literal>CHECK</literal>,
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the user or group that the privilege was granted to</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the table</entry>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table</entry>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Type of the privilege: <literal>SELECT</literal>,
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the table</entry>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table</entry>
</row>
<row>
- <entry><literal>table_type</literal</entry>
+ <entry><literal>table_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Type of the table: <literal>BASE TABLE</literal> for a
</row>
<row>
- <entry><literal>trigger_schema</literal</entry>
+ <entry><literal>trigger_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the trigger</entry>
</row>
<row>
- <entry><literal>trigger_name</literal</entry>
+ <entry><literal>trigger_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the trigger</entry>
</row>
<row>
- <entry><literal>event_manipulation</literal</entry>
+ <entry><literal>event_manipulation</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Event that fires the trigger (<literal>INSERT</literal>,
</row>
<row>
- <entry><literal>event_object_schema</literal</entry>
+ <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>
</row>
<row>
- <entry><literal>event_object_name</literal</entry>
+ <entry><literal>event_object_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the table that the trigger is defined on</entry>
</row>
<row>
- <entry><literal>action_order</literal</entry>
+ <entry><literal>action_order</literal></entry>
<entry><type>cardinal_number</type></entry>
<entry>Not yet implemented</entry>
</row>
<row>
- <entry><literal>action_condition</literal</entry>
+ <entry><literal>action_condition</literal></entry>
<entry><type>character_data</type></entry>
<entry>Applies to a feature not available in <productname>PostgreSQL</></entry>
</row>
<row>
- <entry><literal>action_statement</literal</entry>
+ <entry><literal>action_statement</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Statement that is executed by the trigger (currently always
</row>
<row>
- <entry><literal>action_orientation</literal</entry>
+ <entry><literal>action_orientation</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Identifies whether the trigger fires once for each processed
</row>
<row>
- <entry><literal>condition_timing</literal</entry>
+ <entry><literal>condition_timing</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Time at which the trigger fires (<literal>BEFORE</literal> or
</row>
<row>
- <entry><literal>condition_reference_old_table</literal</entry>
+ <entry><literal>condition_reference_old_table</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Applies to a feature not available in <productname>PostgreSQL</></entry>
</row>
<row>
- <entry><literal>condition_reference_new_table</literal</entry>
+ <entry><literal>condition_reference_new_table</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Applies to a feature not available in <productname>PostgreSQL</></entry>
</row>
</row>
<row>
- <entry><literal>grantee</literal</entry>
+ <entry><literal>grantee</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Currently always <literal>PUBLIC</literal></entry>
</row>
</row>
<row>
- <entry><literal>privilege_type</literal</entry>
+ <entry><literal>privilege_type</literal></entry>
<entry><type>character_data</type></entry>
<entry>Always <literal>USAGE</literal></entry>
</row>
</row>
<row>
- <entry><literal>view_schema</literal</entry>
+ <entry><literal>view_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the view</entry>
</row>
<row>
- <entry><literal>view_name</literal</entry>
+ <entry><literal>view_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the view</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the schema that contains the table that contains the
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the table that contains the column that is used by the
</row>
<row>
- <entry><literal>column_name</literal</entry>
+ <entry><literal>column_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the column that is used by the view</entry>
</row>
</row>
<row>
- <entry><literal>view_schema</literal</entry>
+ <entry><literal>view_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the view</entry>
</row>
<row>
- <entry><literal>view_name</literal</entry>
+ <entry><literal>view_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the view</entry>
</row>
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the schema that contains the table that is used by the
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>
Name of the table that is used by the view
</row>
<row>
- <entry><literal>table_schema</literal</entry>
+ <entry><literal>table_schema</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the schema that contains the view</entry>
</row>
<row>
- <entry><literal>table_name</literal</entry>
+ <entry><literal>table_name</literal></entry>
<entry><type>sql_identifier</type></entry>
<entry>Name of the view</entry>
</row>
<row>
- <entry><literal>view definition</literal</entry>
+ <entry><literal>view definition</literal></entry>
<entry><type>character_data</type></entry>
<entry>
Query expression defining the view (null if the current user is