mirror of
https://git.postgresql.org/git/postgresql.git
synced 2025-02-23 19:39:53 +08:00
Update docs for new INFO, NOTICE, WARNING elog() levels.
This commit is contained in:
parent
4e15b9233d
commit
92b1ab75d4
@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/maintenance.sgml,v 1.11 2002/01/20 22:19:56 petere Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/maintenance.sgml,v 1.12 2002/03/06 06:44:31 momjian Exp $
|
||||
-->
|
||||
|
||||
<chapter id="maintenance">
|
||||
@ -335,7 +335,7 @@ SELECT datname, age(datfrozenxid) FROM pg_database;
|
||||
<informalexample>
|
||||
<programlisting>
|
||||
play=# vacuum;
|
||||
NOTICE: Some databases have not been vacuumed in 1613770184 transactions.
|
||||
WARNING: Some databases have not been vacuumed in 1613770184 transactions.
|
||||
Better vacuum them within 533713463 transactions,
|
||||
or you may have a wraparound failure.
|
||||
VACUUM
|
||||
|
@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/perform.sgml,v 1.16 2002/01/20 22:19:56 petere Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/perform.sgml,v 1.17 2002/03/06 06:44:31 momjian Exp $
|
||||
-->
|
||||
|
||||
<chapter id="performance-tips">
|
||||
@ -96,7 +96,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/perform.sgml,v 1.16 2002/01/20 22:19:56 pet
|
||||
|
||||
<programlisting>
|
||||
regression=# EXPLAIN SELECT * FROM tenk1;
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Seq Scan on tenk1 (cost=0.00..333.00 rows=10000 width=148)
|
||||
</programlisting>
|
||||
@ -120,7 +120,7 @@ SELECT * FROM pg_class WHERE relname = 'tenk1';
|
||||
|
||||
<programlisting>
|
||||
regression=# EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 1000;
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Seq Scan on tenk1 (cost=0.00..358.00 rows=1007 width=148)
|
||||
</programlisting>
|
||||
@ -145,7 +145,7 @@ Seq Scan on tenk1 (cost=0.00..358.00 rows=1007 width=148)
|
||||
|
||||
<programlisting>
|
||||
regression=# EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 50;
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Index Scan using tenk1_unique1 on tenk1 (cost=0.00..181.09 rows=49 width=148)
|
||||
</programlisting>
|
||||
@ -164,7 +164,7 @@ Index Scan using tenk1_unique1 on tenk1 (cost=0.00..181.09 rows=49 width=148)
|
||||
<programlisting>
|
||||
regression=# EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 50 AND
|
||||
regression-# stringu1 = 'xxx';
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Index Scan using tenk1_unique1 on tenk1 (cost=0.00..181.22 rows=1 width=148)
|
||||
</programlisting>
|
||||
@ -179,7 +179,7 @@ Index Scan using tenk1_unique1 on tenk1 (cost=0.00..181.22 rows=1 width=148)
|
||||
<programlisting>
|
||||
regression=# EXPLAIN SELECT * FROM tenk1 t1, tenk2 t2 WHERE t1.unique1 < 50
|
||||
regression-# AND t1.unique2 = t2.unique2;
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Nested Loop (cost=0.00..330.41 rows=49 width=296)
|
||||
-> Index Scan using tenk1_unique1 on tenk1 t1
|
||||
@ -227,7 +227,7 @@ regression=# set enable_nestloop = off;
|
||||
SET VARIABLE
|
||||
regression=# EXPLAIN SELECT * FROM tenk1 t1, tenk2 t2 WHERE t1.unique1 < 50
|
||||
regression-# AND t1.unique2 = t2.unique2;
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Hash Join (cost=181.22..564.83 rows=49 width=296)
|
||||
-> Seq Scan on tenk2 t2
|
||||
@ -260,7 +260,7 @@ Hash Join (cost=181.22..564.83 rows=49 width=296)
|
||||
regression=# EXPLAIN ANALYZE
|
||||
regression-# SELECT * FROM tenk1 t1, tenk2 t2
|
||||
regression-# WHERE t1.unique1 < 50 AND t1.unique2 = t2.unique2;
|
||||
NOTICE: QUERY PLAN:
|
||||
INFO: QUERY PLAN:
|
||||
|
||||
Nested Loop (cost=0.00..330.41 rows=49 width=296) (actual time=1.31..28.90 rows=50 loops=1)
|
||||
-> Index Scan using tenk1_unique1 on tenk1 t1
|
||||
|
@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.105 2002/03/02 21:39:15 momjian Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.106 2002/03/06 06:44:32 momjian Exp $
|
||||
-->
|
||||
|
||||
<Chapter Id="runtime">
|
||||
@ -139,13 +139,13 @@ postgres$ <userinput>initdb -D /usr/local/pgsql/data</userinput>
|
||||
One surprise you might encounter while running <command>initdb</command> is
|
||||
a notice similar to this one:
|
||||
<screen>
|
||||
NOTICE: Initializing database with en_US collation order.
|
||||
WARNING: Initializing database with en_US collation order.
|
||||
This locale setting will prevent use of index optimization for
|
||||
LIKE and regexp searches. If you are concerned about speed of
|
||||
such queries, you may wish to set LC_COLLATE to "C" and
|
||||
re-initdb. For more information see the Administrator's Guide.
|
||||
</screen>
|
||||
This notice is intended to warn you that the currently selected locale
|
||||
This is intended to warn you that the currently selected locale
|
||||
will cause indexes to be sorted in an order that prevents them from
|
||||
being used for LIKE and regular-expression searches. If you need
|
||||
good performance of such searches, you should set your current locale
|
||||
@ -821,10 +821,10 @@ env PGOPTIONS='-c geqo=off' psql
|
||||
default is <literal>NOTICE</>. Valid values are <literal>DEBUG5</>,
|
||||
<literal>DEBUG4</>, <literal>DEBUG3</>, <literal>DEBUG2</>,
|
||||
<literal>DEBUG1</>, <literal>INFO</>, <literal>NOTICE</>,
|
||||
<literal>ERROR</>, <literal>LOG</>, <literal>FATAL</>,
|
||||
<literal>PANIC</>. Later values send less detail to the logs.
|
||||
<literal>LOG</> has a different precedence here than in
|
||||
<literal>CLIENT_MIN_MESSAGES</>.
|
||||
<literal>WARNING</>, <literal>ERROR</>, <literal>LOG</>,
|
||||
<literal>FATAL</>, and <literal>PANIC</>. Later values send less
|
||||
detail to the logs. <literal>LOG</> has a different precedence
|
||||
here than in <literal>CLIENT_MIN_MESSAGES</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@ -834,13 +834,13 @@ env PGOPTIONS='-c geqo=off' psql
|
||||
<listitem>
|
||||
<para>
|
||||
This controls how much detail is written to the client. The
|
||||
default is <literal>INFO</>. Valid values are
|
||||
default is <literal>NOTICE</>. Valid values are
|
||||
<literal>DEBUG5</>, <literal>DEBUG4</>, <literal>DEBUG3</>,
|
||||
<literal>DEBUG2</>, <literal>DEBUG1</>, <literal>LOG</>,
|
||||
<literal>INFO</>, <literal>NOTICE</>, <literal>ERROR</>,
|
||||
<literal>FATAL</>, <literal>PANIC</>. Later values send less
|
||||
information to the user. literal>LOG</> has a different
|
||||
precedence here than in <literal>SERVER_MIN_MESSAGES</>.
|
||||
<literal>NOTICE</>, <literal>WARNING</>, and <literal>ERROR</>.
|
||||
Later values send less information to the user. <literal>LOG</>
|
||||
has a different precedence here than in
|
||||
<literal>SERVER_MIN_MESSAGES</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/spi.sgml,v 1.20 2001/11/21 06:09:45 thomas Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/spi.sgml,v 1.21 2002/03/06 06:44:33 momjian Exp $
|
||||
-->
|
||||
|
||||
<Chapter id="spi">
|
||||
@ -3801,7 +3801,7 @@ execq(text *sql, int cnt)
|
||||
proc = SPI_processed;
|
||||
/*
|
||||
* If this is SELECT and some tuple(s) fetched -
|
||||
* returns tuples to the caller via elog (NOTICE).
|
||||
* returns tuples to the caller via elog (INFO).
|
||||
*/
|
||||
if ( ret == SPI_OK_SELECT && SPI_processed > 0 )
|
||||
{
|
||||
@ -3818,7 +3818,7 @@ execq(text *sql, int cnt)
|
||||
sprintf(buf + strlen (buf), " %s%s",
|
||||
SPI_getvalue(tuple, tupdesc, i),
|
||||
(i == tupdesc->natts) ? " " : " |");
|
||||
elog (NOTICE, "EXECQ: %s", buf);
|
||||
elog (INFO, "EXECQ: %s", buf);
|
||||
}
|
||||
}
|
||||
|
||||
@ -3850,9 +3850,9 @@ execq
|
||||
vac=> INSERT INTO a VALUES (execq('INSERT INTO a VALUES (0)',0));
|
||||
INSERT 167631 1
|
||||
vac=> SELECT execq('SELECT * FROM a',0);
|
||||
NOTICE:EXECQ: 0 <<< inserted by execq
|
||||
INFO: EXECQ: 0 <<< inserted by execq
|
||||
|
||||
NOTICE:EXECQ: 1 <<< value returned by execq and inserted by upper INSERT
|
||||
INFO: EXECQ: 1 <<< value returned by execq and inserted by upper INSERT
|
||||
|
||||
execq
|
||||
-----
|
||||
@ -3866,11 +3866,11 @@ execq
|
||||
(1 row)
|
||||
|
||||
vac=> SELECT execq('SELECT * FROM a', 10);
|
||||
NOTICE:EXECQ: 0
|
||||
INFO: EXECQ: 0
|
||||
|
||||
NOTICE:EXECQ: 1
|
||||
INFO: EXECQ: 1
|
||||
|
||||
NOTICE:EXECQ: 2 <<< 0 + 2, only one tuple inserted - as specified
|
||||
INFO: EXECQ: 2 <<< 0 + 2, only one tuple inserted - as specified
|
||||
|
||||
execq
|
||||
-----
|
||||
@ -3888,7 +3888,7 @@ x
|
||||
(1 row)
|
||||
|
||||
vac=> INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1);
|
||||
NOTICE:EXECQ: 0
|
||||
INFO: EXECQ: 0
|
||||
INSERT 167713 1
|
||||
vac=> SELECT * FROM a;
|
||||
x
|
||||
@ -3900,11 +3900,11 @@ x
|
||||
-- This demonstrates data changes visibility rule:
|
||||
|
||||
vac=> INSERT INTO a SELECT execq('SELECT * FROM a', 0) * x FROM a;
|
||||
NOTICE:EXECQ: 1
|
||||
NOTICE:EXECQ: 2
|
||||
NOTICE:EXECQ: 1
|
||||
NOTICE:EXECQ: 2
|
||||
NOTICE:EXECQ: 2
|
||||
INFO: EXECQ: 1
|
||||
INFO: EXECQ: 2
|
||||
INFO: EXECQ: 1
|
||||
INFO: EXECQ: 2
|
||||
INFO: EXECQ: 2
|
||||
INSERT 0 2
|
||||
vac=> SELECT * FROM a;
|
||||
x
|
||||
|
@ -1,5 +1,5 @@
|
||||
<!--
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/trigger.sgml,v 1.19 2001/12/04 02:07:11 tgl Exp $
|
||||
$Header: /cvsroot/pgsql/doc/src/sgml/trigger.sgml,v 1.20 2002/03/06 06:44:33 momjian Exp $
|
||||
-->
|
||||
|
||||
<chapter id="triggers">
|
||||
@ -487,7 +487,7 @@ trigf(PG_FUNCTION_ARGS)
|
||||
|
||||
/* Connect to SPI manager */
|
||||
if ((ret = SPI_connect()) < 0)
|
||||
elog(NOTICE, "trigf (fired %s): SPI_connect returned %d", when, ret);
|
||||
elog(INFO, "trigf (fired %s): SPI_connect returned %d", when, ret);
|
||||
|
||||
/* Get number of tuples in relation */
|
||||
ret = SPI_exec("SELECT count(*) FROM ttest", 0);
|
||||
@ -535,7 +535,7 @@ vac=> CREATE TRIGGER tafter AFTER INSERT OR UPDATE OR DELETE ON ttest
|
||||
FOR EACH ROW EXECUTE PROCEDURE trigf();
|
||||
CREATE
|
||||
vac=> INSERT INTO ttest VALUES (NULL);
|
||||
NOTICE:trigf (fired before): there are 0 tuples in ttest
|
||||
WARNING: trigf (fired before): there are 0 tuples in ttest
|
||||
INSERT 0 0
|
||||
|
||||
-- Insertion skipped and AFTER trigger is not fired
|
||||
@ -546,8 +546,8 @@ x
|
||||
(0 rows)
|
||||
|
||||
vac=> INSERT INTO ttest VALUES (1);
|
||||
NOTICE:trigf (fired before): there are 0 tuples in ttest
|
||||
NOTICE:trigf (fired after ): there are 1 tuples in ttest
|
||||
INFO: trigf (fired before): there are 0 tuples in ttest
|
||||
INFO: trigf (fired after ): there are 1 tuples in ttest
|
||||
^^^^^^^^
|
||||
remember what we said about visibility.
|
||||
INSERT 167793 1
|
||||
@ -558,8 +558,8 @@ x
|
||||
(1 row)
|
||||
|
||||
vac=> INSERT INTO ttest SELECT x * 2 FROM ttest;
|
||||
NOTICE:trigf (fired before): there are 1 tuples in ttest
|
||||
NOTICE:trigf (fired after ): there are 2 tuples in ttest
|
||||
INFO: trigf (fired before): there are 1 tuples in ttest
|
||||
INFO: trigf (fired after ): there are 2 tuples in ttest
|
||||
^^^^^^^^
|
||||
remember what we said about visibility.
|
||||
INSERT 167794 1
|
||||
@ -571,11 +571,11 @@ x
|
||||
(2 rows)
|
||||
|
||||
vac=> UPDATE ttest SET x = null WHERE x = 2;
|
||||
NOTICE:trigf (fired before): there are 2 tuples in ttest
|
||||
INFO: trigf (fired before): there are 2 tuples in ttest
|
||||
UPDATE 0
|
||||
vac=> UPDATE ttest SET x = 4 WHERE x = 2;
|
||||
NOTICE:trigf (fired before): there are 2 tuples in ttest
|
||||
NOTICE:trigf (fired after ): there are 2 tuples in ttest
|
||||
INFO: trigf (fired before): there are 2 tuples in ttest
|
||||
INFO: trigf (fired after ): there are 2 tuples in ttest
|
||||
UPDATE 1
|
||||
vac=> SELECT * FROM ttest;
|
||||
x
|
||||
@ -585,10 +585,10 @@ x
|
||||
(2 rows)
|
||||
|
||||
vac=> DELETE FROM ttest;
|
||||
NOTICE:trigf (fired before): there are 2 tuples in ttest
|
||||
NOTICE:trigf (fired after ): there are 1 tuples in ttest
|
||||
NOTICE:trigf (fired before): there are 1 tuples in ttest
|
||||
NOTICE:trigf (fired after ): there are 0 tuples in ttest
|
||||
INFO: trigf (fired before): there are 2 tuples in ttest
|
||||
INFO: trigf (fired after ): there are 1 tuples in ttest
|
||||
INFO: trigf (fired before): there are 1 tuples in ttest
|
||||
INFO: trigf (fired after ): there are 0 tuples in ttest
|
||||
^^^^^^^^
|
||||
remember what we said about visibility.
|
||||
DELETE 2
|
||||
|
Loading…
Reference in New Issue
Block a user