1
1
<!--
2
- $PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.291 2004/11/05 19:15:49 tgl Exp $
2
+ $PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.292 2004/11/14 19:35:28 tgl Exp $
3
3
-->
4
4
5
5
<Chapter Id="runtime">
@@ -2150,7 +2150,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2150
2150
to the log. The default is <literal>NOTICE</>. Note that
2151
2151
<literal>LOG</> has a different rank here than in
2152
2152
<varname>client_min_messages</>.
2153
- Only superusers can increase this option .
2153
+ Only superusers can change this setting .
2154
2154
</para>
2155
2155
</listitem>
2156
2156
</varlistentry>
@@ -2186,7 +2186,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2186
2186
SQL statements causing errors, fatal errors, or panics will be
2187
2187
logged. Enabling this option can be helpful in tracking down
2188
2188
the source of any errors that appear in the server log.
2189
- Only superusers can increase this option .
2189
+ Only superusers can change this setting .
2190
2190
</para>
2191
2191
</listitem>
2192
2192
</varlistentry>
@@ -2204,8 +2204,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2204
2204
<literal>250</literal> then all SQL statements that run 250ms
2205
2205
or longer will be logged. Enabling this option can be
2206
2206
useful in tracking down unoptimized queries in your applications.
2207
- Only superusers can increase this or set it to minus-one if this
2208
- option is set by the administrator.
2207
+ Only superusers can change this setting.
2209
2208
</para>
2210
2209
</listitem>
2211
2210
</varlistentry>
@@ -2332,7 +2331,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2332
2331
these displays to produce a more readable but much longer
2333
2332
output format. <varname>client_min_messages</varname> or
2334
2333
<varname>log_min_messages</varname> must be
2335
- <literal>DEBUG1</literal> or lower to send output to the
2334
+ <literal>DEBUG1</literal> or lower to send the output to the
2336
2335
client or server logs. These options are off by default.
2337
2336
</para>
2338
2337
</listitem>
@@ -2372,10 +2371,9 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2372
2371
<varname>log_statement</> to be logged. When using this option,
2373
2372
if you are not using <application>syslog</>, it is recommended
2374
2373
that you log the PID or session ID using <varname>log_line_prefix</>
2375
- or log the session ID so that you can link the statement to the
2374
+ so that you can link the statement to the
2376
2375
duration using the process ID or session ID. The default is off.
2377
- Only superusers can turn off this option if it is enabled by the
2378
- administrator.
2376
+ Only superusers can change this setting.
2379
2377
</para>
2380
2378
</listitem>
2381
2379
</varlistentry>
@@ -2487,35 +2485,35 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2487
2485
<listitem>
2488
2486
<para>
2489
2487
Controls which SQL statements are logged. Valid values are
2490
- <literal>all </>, <literal>ddl</>, <literal>mod</>, and
2491
- <literal>none </>. <literal>ddl</> logs all data definition
2488
+ <literal>none </>, <literal>ddl</>, <literal>mod</>, and
2489
+ <literal>all </>. <literal>ddl</> logs all data definition
2492
2490
commands like <literal>CREATE</>, <literal>ALTER</>, and
2493
2491
<literal>DROP</> commands. <literal>mod</> logs all
2494
2492
<literal>ddl</> statements, plus <literal>INSERT</>,
2495
2493
<literal>UPDATE</>, <literal>DELETE</>, <literal>TRUNCATE</>,
2496
2494
and <literal>COPY FROM</>. <literal>PREPARE</> and
2497
- <literal>EXPLAIN ANALYZE</> statements are also considered for
2498
- appropriate commands.
2495
+ <literal>EXPLAIN ANALYZE</> statements are also logged if their
2496
+ contained command is of an appropriate type.
2499
2497
</para>
2500
2498
<para>
2501
- The default is <literal>none</>. Only superusers can reduce
2502
- the detail of this option if it has been set by an administrator .
2499
+ The default is <literal>none</>. Only superusers can change this
2500
+ setting .
2503
2501
</para>
2504
2502
2505
2503
<note>
2506
2504
<para>
2507
- The <command>EXECUTE</command> statement not considered a
2505
+ The <command>EXECUTE</command> statement is not considered a
2508
2506
<literal>ddl</> or <literal>mod</> statement. When it is logged,
2509
2507
only the name of the prepared statement is reported, not the
2510
2508
actual prepared statement.
2511
2509
</para>
2512
2510
2513
2511
<para>
2514
- When a function is defined in a server-side language like
2515
- <application>PL/pgSQL</application>, any queries executed by
2516
- the function will only be logged the first time that the
2512
+ When a function is defined in the
2513
+ <application>PL/pgSQL</application>server-side language , any queries
2514
+ executed by the function will only be logged the first time that the
2517
2515
function is invoked in a particular session. This is because
2518
- the <application>PL/pgSQL</application> keeps a cache of the
2516
+ <application>PL/pgSQL</application> keeps a cache of the
2519
2517
query plans produced for the SQL statements in the function.
2520
2518
</para>
2521
2519
</note>
@@ -2556,11 +2554,10 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Win32
2556
2554
For each query, write performance statistics of the respective
2557
2555
module to the server log. This is a crude profiling
2558
2556
instrument. <varname>log_statement_stats</varname> reports total
2559
- statement statistics, while the others report per-state statistics.
2560
- <varname>log_statement_stats</varname> can not be enabled with
2561
- the other options. All of these options are disabled by default.
2562
- Only superusers can turn off any of these options if they have
2563
- been enabled by the administrator.
2557
+ statement statistics, while the others report per-module statistics.
2558
+ <varname>log_statement_stats</varname> cannot be enabled together with
2559
+ any of the per-module options. All of these options are disabled by
2560
+ default. Only superusers can change these settings.
2564
2561
</para>
2565
2562
</listitem>
2566
2563
</varlistentry>
0 commit comments