diff options
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/catalogs.sgml | 25 | ||||
| -rw-r--r-- | doc/src/sgml/monitoring.sgml | 42 | ||||
| -rw-r--r-- | doc/src/sgml/ref/create_index.sgml | 7 |
3 files changed, 69 insertions, 5 deletions
diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index 68ff0921481..98cd438618a 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -1,4 +1,4 @@ -<!-- $PostgreSQL: pgsql/doc/src/sgml/catalogs.sgml,v 2.157 2007/09/05 18:10:47 tgl Exp $ --> +<!-- $PostgreSQL: pgsql/doc/src/sgml/catalogs.sgml,v 2.158 2007/09/20 17:56:30 tgl Exp $ --> <!-- Documentation of the system catalogs, directed toward PostgreSQL developers --> @@ -2566,6 +2566,29 @@ </row> <row> + <entry><structfield>indcheckxmin</structfield></entry> + <entry><type>bool</type></entry> + <entry></entry> + <entry> + If true, queries must not use the index until the <structfield>xmin</> + of this <structname>pg_index</> row is below their TransactionXmin + event horizon, because the table may contain broken HOT chains with + incompatible rows that they can see + </entry> + </row> + + <row> + <entry><structfield>indisready</structfield></entry> + <entry><type>bool</type></entry> + <entry></entry> + <entry> + If true, the index is currently ready for inserts. False means the + index must be ignored by <command>INSERT</>/<command>UPDATE</> + operations + </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> diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 42816bd5d2d..c00d1a0d5a9 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -1,4 +1,4 @@ -<!-- $PostgreSQL: pgsql/doc/src/sgml/monitoring.sgml,v 1.51 2007/06/28 00:02:37 tgl Exp $ --> +<!-- $PostgreSQL: pgsql/doc/src/sgml/monitoring.sgml,v 1.52 2007/09/20 17:56:30 tgl Exp $ --> <chapter id="monitoring"> <title>Monitoring Database Activity</title> @@ -276,6 +276,8 @@ postgres: <replaceable>user</> <replaceable>database</> <replaceable>host</> <re scans, number of index scans initiated (over all indexes belonging to the table), number of live rows fetched by index scans, numbers of row insertions, updates, and deletions, + number of row updates that were HOT (i.e., no separate index update), + numbers of live and dead rows, the last time the table was vacuumed manually, the last time it was vacuumed by the autovacuum daemon, the last time it was analyzed manually, @@ -580,7 +582,7 @@ postgres: <replaceable>user</> <replaceable>database</> <replaceable>host</> <re <entry><literal><function>pg_stat_get_tuples_updated</function>(<type>oid</type>)</literal></entry> <entry><type>bigint</type></entry> <entry> - Number of rows updated in table + Number of rows updated in table (includes HOT updates) </entry> </row> @@ -593,6 +595,30 @@ postgres: <replaceable>user</> <replaceable>database</> <replaceable>host</> <re </row> <row> + <entry><literal><function>pg_stat_get_tuples_hot_updated</function>(<type>oid</type>)</literal></entry> + <entry><type>bigint</type></entry> + <entry> + Number of rows HOT-updated in table + </entry> + </row> + + <row> + <entry><literal><function>pg_stat_get_live_tuples</function>(<type>oid</type>)</literal></entry> + <entry><type>bigint</type></entry> + <entry> + Number of live rows in table + </entry> + </row> + + <row> + <entry><literal><function>pg_stat_get_dead_tuples</function>(<type>oid</type>)</literal></entry> + <entry><type>bigint</type></entry> + <entry> + Number of dead rows in table + </entry> + </row> + + <row> <entry><literal><function>pg_stat_get_blocks_fetched</function>(<type>oid</type>)</literal></entry> <entry><type>bigint</type></entry> <entry> @@ -717,6 +743,18 @@ postgres: <replaceable>user</> <replaceable>database</> <replaceable>host</> <re </row> <row> + <entry><literal><function>pg_stat_get_backend_xact_start</function>(<type>integer</type>)</literal></entry> + <entry><type>timestamp with time zone</type></entry> + <entry> + The time at which the given server process' currently + executing transaction was started, but only if the + current user is a superuser or the same user as that of + the session being queried (and + <varname>stats_command_string</varname> is on) + </entry> + </row> + + <row> <entry><literal><function>pg_stat_get_backend_start</function>(<type>integer</type>)</literal></entry> <entry><type>timestamp with time zone</type></entry> <entry> diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml index 0fe40c775f8..8e81fed4a38 100644 --- a/doc/src/sgml/ref/create_index.sgml +++ b/doc/src/sgml/ref/create_index.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/create_index.sgml,v 1.64 2007/09/07 00:58:56 tgl Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/create_index.sgml,v 1.65 2007/09/20 17:56:30 tgl Exp $ PostgreSQL documentation --> @@ -329,7 +329,10 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] <replaceable class="parameter">name</re </para> <para> - If a problem arises during the second scan of the table, such as a + In a concurrent index build, the index is actually entered into the + system catalogs in one transaction, then the two table scans occur in a + second and third transaction. + If a problem arises while scanning the table, such as a uniqueness violation in a unique index, the <command>CREATE INDEX</> command will fail but leave behind an <quote>invalid</> index. This index will be ignored for querying purposes because it might be incomplete; |