<!--
Documentation of the system catalogs, directed toward PostgreSQL developers
- $PostgreSQL: pgsql/doc/src/sgml/catalogs.sgml,v 2.116 2006/01/08 07:00:24 neilc Exp $
+ $PostgreSQL: pgsql/doc/src/sgml/catalogs.sgml,v 2.117 2006/01/16 18:15:30 neilc Exp $
-->
<chapter id="catalogs">
<entry>
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.
+ representation. If this field is NULL, the transition state
+ value starts out NULL.
</entry>
</row>
</tbody>
</table>
<para>
- New aggregate functions are registered with the <command>CREATE
- AGGREGATE</command> command. See <xref linkend="xaggr"> for more
- information about writing aggregate functions and the meaning of
- the transition functions, etc.
+ New aggregate functions are registered with the <xref
+ linkend="sql-createaggregate" endterm="sql-createaggregate-title">
+ command. See <xref linkend="xaggr"> for more information about
+ writing aggregate functions and the meaning of the transition
+ functions, etc.
</para>
</sect1>
<entry><type>bool</type></entry>
<entry></entry>
<entry>
- Role may log in, that is, this role can be given as the initial
+ Role may log in. That is, this role can be given as the initial
session authorization identifier.
</entry>
</row>
<entry><structfield>relukeys</structfield></entry>
<entry><type>int2</type></entry>
<entry></entry>
- <entry>unused (<emphasis>not</emphasis> the number of unique keys)</entry>
+ <entry>Unused (<emphasis>not</emphasis> the number of unique keys)</entry>
</row>
<row>
<entry><structfield>relfkeys</structfield></entry>
<entry><type>int2</type></entry>
<entry></entry>
- <entry>unused (<emphasis>not</emphasis> the number of foreign keys on the table)</entry>
+ <entry>Unused (<emphasis>not</emphasis> the number of foreign keys on the table)</entry>
</row>
<row>
<entry><structfield>relrefs</structfield></entry>
<entry><type>int2</type></entry>
<entry></entry>
- <entry>unused</entry>
+ <entry>Unused</entry>
</row>
<row>
<entry><type>bool</type></entry>
<entry></entry>
<entry>
- True if we generate an OID for each row of the relation.
+ True if we generate an OID for each row of the relation
</entry>
</row>
<entry><type>bool</type></entry>
<entry></entry>
<entry>
- True if the table has (or once had) a primary key.
+ True if the table has (or once had) a primary key
</entry>
</row>
<entry><type>bool</type></entry>
<entry></entry>
<entry>True if table has rules; see
- <structname>pg_rewrite</structname> catalog.
+ <structname>pg_rewrite</structname> catalog
</entry>
</row>
<entry><structfield>relhassubclass</structfield></entry>
<entry><type>bool</type></entry>
<entry></entry>
- <entry>True if table has (or once had) any inheritance children.</entry>
+ <entry>True if table has (or once had) any inheritance children</entry>
</row>
<row>
Access privileges; see
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title">
- for details.
+ for details
</entry>
</row>
</tbody>
Access privileges; see
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title">
- for details.
+ for details
</entry>
</row>
</tbody>
<entry><type>char</type></entry>
<entry></entry>
<entry>
- A code defining the specific semantics of this dependency relationship; see text.
+ A code defining the specific semantics of this dependency relationship; see text
</entry>
</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>Arbitrary text that serves as the description of this object</entry>
</row>
</tbody>
</tgroup>
<entry><structfield>indisunique</structfield></entry>
<entry><type>bool</type></entry>
<entry></entry>
- <entry>If true, this is a unique index.</entry>
+ <entry>If true, this is a unique index</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>If true, the table was last clustered on this index</entry>
</row>
<row>
<entry>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</>.
- Null if all index attributes are simple references.</entry>
+ NULL if all index attributes are simple references.</entry>
</row>
<row>
<entry><type>text</type></entry>
<entry></entry>
<entry>Expression tree (in <function>nodeToString()</function> representation)
- for partial index predicate. Null if not a partial index.</entry>
+ for partial index predicate. NULL if not a partial index.</entry>
</row>
</tbody>
</tgroup>
<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 child table.
+ The OID of the child table
</entry>
</row>
<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 parent table.
+ The OID of the parent table
</entry>
</row>
Access privileges; see
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title">
- for details.
+ for details
</entry>
</row>
</tbody>
<entry><structfield>listenerpid</structfield></entry>
<entry><type>int4</type></entry>
<entry></entry>
- <entry>PID of the server process that created this entry.</entry>
+ <entry>PID of the server process that created this entry</entry>
</row>
<row>
Access privileges; see
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title">
- for details.
+ for details
</entry>
</row>
</tbody>
</table>
<para>
- Unused column contain zeroes, for example <structfield>oprleft</structfield> is zero for a
- prefix operator.
+ Unused column contain zeroes. For example, <structfield>oprleft</structfield>
+ is zero for a prefix operator.
</para>
</sect1>
<para>
There are not currently any commands that manipulate procedural language
templates; to change the built-in information, a superuser must modify
- the table using ordinary INSERT, DELETE, or UPDATE commands. It is
- likely that a future release of <productname>PostgreSQL</productname>
- will offer commands to change the entries in a cleaner fashion.
+ the table using ordinary <command>INSERT</command>, <command>DELETE</command>,
+ or <command>UPDATE</command> commands. It is likely that a future
+ release of <productname>PostgreSQL</productname> will offer
+ commands to change the entries in a cleaner fashion.
</para>
<para>
Access privileges; see
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title">
- for details.
+ for details
</entry>
</row>
</tbody>
<entry><type>char</type></entry>
<entry></entry>
<entry>
- A code defining the specific semantics of this dependency relationship; see text.
+ A code defining the specific semantics of this dependency relationship; see text
</entry>
</row>
<entry></entry>
<entry>
Numerical statistics of the appropriate kind for the
- <replaceable>N</>th <quote>slot</quote>, or null if the slot
- kind does not involve numerical values.
+ <replaceable>N</>th <quote>slot</quote>, or NULL if the slot
+ kind does not involve numerical values
</entry>
</row>
<entry></entry>
<entry>
Column data values of the appropriate kind for the
- <replaceable>N</>th <quote>slot</quote>, or null if the slot
+ <replaceable>N</>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, so there
is no way to define these columns' type more specifically than
Access privileges; see
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title">
- for details.
+ for details
</entry>
</row>
</tbody>
<entry><structfield>tgargs</structfield></entry>
<entry><type>bytea</type></entry>
<entry></entry>
- <entry>Argument strings to pass to trigger, each null-terminated</entry>
+ <entry>Argument strings to pass to trigger, each NULL-terminated</entry>
</row>
</tbody>
</tgroup>
<row>
<entry><link linkend="view-pg-prepared-statements"><structname>pg_prepared_statements</structname></link></entry>
- <entry>current prepared statements</entry>
+ <entry>prepared statements</entry>
</row>
<row>
<entry><link linkend="view-pg-prepared-xacts"><structname>pg_prepared_xacts</structname></link></entry>
- <entry>currently prepared transactions</entry>
+ <entry>prepared transactions</entry>
</row>
<row>
<entry><type>xid</type></entry>
<entry></entry>
<entry>
- ID of the transaction that is holding or awaiting this lock.
+ ID of the transaction that is holding or awaiting this lock
</entry>
</row>
<row>
<entry></entry>
<entry>
Process ID of the server process holding or awaiting this
- lock. Null if the lock is held by a prepared transaction.
+ lock. NULL if the lock is held by a prepared transaction.
</entry>
</row>
<row>
<para>
<structname>pg_prepared_statements</structname> contains one row
for each prepared statement. Rows are added to the view when a new
- prepared statement is created, and removed when a prepared
- statement is released (for example, via the <xref
- linkend="sql-deallocate" endterm="sql-deallocate-title">
- command).
+ prepared statement is created and removed when a prepared statement
+ is released (for example, via the <xref linkend="sql-deallocate"
+ endterm="sql-deallocate-title"> command).
</para>
<table>
<entry><type>text</type></entry>
<entry></entry>
<entry>
- The identifier of the prepared statement.
+ The identifier of the prepared statement
</entry>
</row>
<row>
<entry><type>timestamptz</type></entry>
<entry></entry>
<entry>
- The time at which the prepared statement was created.
+ The time at which the prepared statement was created
</entry>
</row>
<row>
<entry><structfield>parameter_types</structfield></entry>
- <entry><type>oid[]</type></entry>
+ <entry><type>regtype[]</type></entry>
<entry></entry>
<entry>
- The expected parameter types for the prepared statement in the form of
- an array of type OIDs.
+ 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>
</row>
<row>
<literal>true</literal> if the prepared statement was created
via the <command>PREPARE</command> SQL statement;
<literal>false</literal> if the statement was prepared via the
- frontend/backend protocol.
+ frontend/backend protocol
</entry>
</row>
</tbody>
<entry><structfield>definition</structfield></entry>
<entry><type>text</type></entry>
<entry></entry>
- <entry>view definition (a reconstructed SELECT query)</entry>
+ <entry>view definition (a reconstructed <command>SELECT</command> query)</entry>
</row>
</tbody>
</tgroup>
* Copyright (c) 2002-2005, PostgreSQL Global Development Group
*
* IDENTIFICATION
- * $PostgreSQL: pgsql/src/backend/commands/prepare.c,v 1.45 2006/01/08 07:00:25 neilc Exp $
+ * $PostgreSQL: pgsql/src/backend/commands/prepare.c,v 1.46 2006/01/16 18:15:30 neilc Exp $
*
*-------------------------------------------------------------------------
*/
static void InitQueryHashTable(void);
static ParamListInfo EvaluateParams(EState *estate,
List *params, List *argtypes);
-static Datum build_oid_array(List *oid_list);
+static Datum build_regtype_array(List *oid_list);
/*
* Implements the 'PREPARE' utility statement.
/*
* This set returning function reads all the prepared statements and
- * returns a set of (name, statement, prepare_time, param_types).
+ * returns a set of (name, statement, prepare_time, param_types, from_sql).
*/
Datum
pg_prepared_statement(PG_FUNCTION_ARGS)
TupleDescInitEntry(tupdesc, (AttrNumber) 3, "prepare_time",
TIMESTAMPTZOID, -1, 0);
TupleDescInitEntry(tupdesc, (AttrNumber) 4, "parameter_types",
- OIDARRAYOID, -1, 0);
+ REGTYPEARRAYOID, -1, 0);
TupleDescInitEntry(tupdesc, (AttrNumber) 5, "from_sql",
BOOLOID, -1, 0);
CStringGetDatum(prep_stmt->query_string));
values[2] = TimestampTzGetDatum(prep_stmt->prepare_time);
- values[3] = build_oid_array(prep_stmt->argtype_list);
+ values[3] = build_regtype_array(prep_stmt->argtype_list);
values[4] = BoolGetDatum(prep_stmt->from_sql);
tuple = heap_form_tuple(funcctx->tuple_desc, values, nulls);
/*
* This utility function takes a List of Oids, and returns a Datum
- * pointing to a Postgres array containing those OIDs. The empty list
- * is returned as a zero-element array, not NULL.
+ * pointing to a one-dimensional Postgres array of regtypes. The empty
+ * list is returned as a zero-element array, not NULL.
*/
static Datum
-build_oid_array(List *oid_list)
+build_regtype_array(List *oid_list)
{
- ListCell *lc;
- int len;
- int i;
- Datum *tmp_ary;
- ArrayType *ary;
+ ListCell *lc;
+ int len;
+ int i;
+ Datum *tmp_ary;
+ ArrayType *result;
len = list_length(oid_list);
tmp_ary = (Datum *) palloc(len * sizeof(Datum));
i = 0;
foreach(lc, oid_list)
- tmp_ary[i++] = ObjectIdGetDatum(lfirst_oid(lc));
+ {
+ Oid oid;
+ Datum oid_str;
+
+ oid = lfirst_oid(lc);
+ oid_str = DirectFunctionCall1(oidout, ObjectIdGetDatum(oid));
+ tmp_ary[i++] = DirectFunctionCall1(regtypein, oid_str);
+ }
- /* XXX: this hardcodes assumptions about the OID type... */
- ary = construct_array(tmp_ary, len, OIDOID, sizeof(Oid), true, 'i');
- return PointerGetDatum(ary);
+ /* XXX: this hardcodes assumptions about the regtype type */
+ result = construct_array(tmp_ary, len, REGTYPEOID, 4, true, 'i');
+ return PointerGetDatum(result);
}
pg_group | SELECT pg_authid.rolname AS groname, pg_authid.oid AS grosysid, ARRAY(SELECT pg_auth_members.member FROM pg_auth_members WHERE (pg_auth_members.roleid = pg_authid.oid)) AS grolist FROM pg_authid WHERE (NOT pg_authid.rolcanlogin);
pg_indexes | SELECT n.nspname AS schemaname, c.relname AS tablename, i.relname AS indexname, t.spcname AS "tablespace", pg_get_indexdef(i.oid) AS indexdef FROM ((((pg_index x JOIN pg_class c ON ((c.oid = x.indrelid))) JOIN pg_class i ON ((i.oid = x.indexrelid))) LEFT JOIN pg_namespace n ON ((n.oid = c.relnamespace))) LEFT JOIN pg_tablespace t ON ((t.oid = i.reltablespace))) WHERE ((c.relkind = 'r'::"char") AND (i.relkind = 'i'::"char"));
pg_locks | SELECT l.locktype, l."database", l.relation, l.page, l.tuple, l.transactionid, l.classid, l.objid, l.objsubid, l."transaction", l.pid, l."mode", l."granted" FROM pg_lock_status() l(locktype text, "database" oid, relation oid, page integer, tuple smallint, transactionid xid, classid oid, objid oid, objsubid smallint, "transaction" xid, pid integer, "mode" text, "granted" boolean);
- pg_prepared_statements | SELECT p.name, p."statement", p.prepare_time, p.parameter_types, p.from_sql FROM pg_prepared_statement() p(name text, "statement" text, prepare_time timestamp with time zone, parameter_types oid[], from_sql boolean);
+ pg_prepared_statements | SELECT p.name, p."statement", p.prepare_time, p.parameter_types, p.from_sql FROM pg_prepared_statement() p(name text, "statement" text, prepare_time timestamp with time zone, parameter_types regtype[], from_sql boolean);
pg_prepared_xacts | SELECT p."transaction", p.gid, p."prepared", u.rolname AS "owner", d.datname AS "database" FROM ((pg_prepared_xact() p("transaction" xid, gid text, "prepared" timestamp with time zone, ownerid oid, dbid oid) LEFT JOIN pg_authid u ON ((p.ownerid = u.oid))) LEFT JOIN pg_database d ON ((p.dbid = d.oid)));
pg_roles | SELECT pg_authid.rolname, pg_authid.rolsuper, pg_authid.rolinherit, pg_authid.rolcreaterole, pg_authid.rolcreatedb, pg_authid.rolcatupdate, pg_authid.rolcanlogin, pg_authid.rolconnlimit, '********'::text AS rolpassword, pg_authid.rolvaliduntil, pg_authid.rolconfig, pg_authid.oid FROM pg_authid;
pg_rules | SELECT n.nspname AS schemaname, c.relname AS tablename, r.rulename, pg_get_ruledef(r.oid) AS definition FROM ((pg_rewrite r JOIN pg_class c ON ((c.oid = r.ev_class))) LEFT JOIN pg_namespace n ON ((n.oid = c.relnamespace))) WHERE (r.rulename <> '_RETURN'::name);
projects / users / bernd / postgres.git / commitdiff