Index: doc/src/sgml/monitoring.sgml =================================================================== RCS file: /var/lib/cvs/pgsql-server/doc/src/sgml/monitoring.sgml,v retrieving revision 1.25 diff -c -r1.25 monitoring.sgml *** a/doc/src/sgml/monitoring.sgml 29 Nov 2003 19:51:37 -0000 1.25 --- b/doc/src/sgml/monitoring.sgml 26 Mar 2004 02:23:33 -0000 *************** *** 28,34 **** but one should not neglect regular Unix monitoring programs such as ps and top. Also, once one has identified a poorly-performing query, further investigation may be needed using ! PostgreSQL's EXPLAIN command. discusses EXPLAIN and other methods for understanding the behavior of an individual query. --- 28,35 ---- but one should not neglect regular Unix monitoring programs such as ps and top. Also, once one has identified a poorly-performing query, further investigation may be needed using ! PostgreSQL's command. discusses EXPLAIN and other methods for understanding the behavior of an individual query. *************** *** 126,153 **** ! The parameter stats_start_collector must be set to ! true for the statistics collector to ! be launched at all. This is the default and recommended setting, ! but it may be turned off if you have no interest in statistics and ! want to squeeze out every last drop of overhead. (The savings is ! likely to be small, however.) Note that this option ! cannot be changed while the server is running. ! The parameters stats_command_string, ! stats_block_level, ! and stats_row_level control how much information is actually sent to the collector and thus determine how much run-time ! overhead occurs. These respectively determine whether a server process ! sends its current command string, disk-block-level access statistics, and ! row-level access statistics to the collector. Normally these parameters are ! set in postgresql.conf so that they apply to all server ! processes, but it is possible to turn them on or off in individual sessions ! using the SET command. (To prevent ordinary users ! from hiding their activity from the administrator, only superusers are ! allowed to change these parameters with SET.) --- 127,156 ---- ! The parameter must be ! set to true for the statistics collector to be launched ! at all. This is the default and recommended setting, but it may be ! turned off if you have no interest in statistics and want to ! squeeze out every last drop of overhead. (The savings is likely to ! be small, however.) Note that this option cannot be changed while ! the server is running. ! The parameters , ! , and control how much information is actually sent to the collector and thus determine how much run-time ! overhead occurs. These respectively determine whether a server ! process sends its current command string, disk-block-level access ! statistics, and row-level access statistics to the collector. ! Normally these parameters are set in postgresql.conf ! so that they apply to all server processes, but it is possible to ! turn them on or off in individual sessions using the command. (To prevent ! ordinary users from hiding their activity from the administrator, ! only superusers are allowed to change these parameters with ! SET.) Index: doc/src/sgml/plpgsql.sgml =================================================================== RCS file: /var/lib/cvs/pgsql-server/doc/src/sgml/plpgsql.sgml,v retrieving revision 1.36 diff -c -r1.36 plpgsql.sgml *** a/doc/src/sgml/plpgsql.sgml 27 Feb 2004 03:59:23 -0000 1.36 --- b/doc/src/sgml/plpgsql.sgml 26 Mar 2004 03:06:45 -0000 *************** *** 128,134 **** The PL/pgSQL EXECUTE statement is not related to the ! EXECUTE statement supported by the PostgreSQL server. The server's EXECUTE statement cannot be used within PL/pgSQL functions (and is not needed). --- 128,135 ---- The PL/pgSQL EXECUTE statement is not related to the ! SQL ! statement supported by the PostgreSQL server. The server's EXECUTE statement cannot be used within PL/pgSQL functions (and is not needed). Index: doc/src/sgml/runtime.sgml =================================================================== RCS file: /var/lib/cvs/pgsql-server/doc/src/sgml/runtime.sgml,v retrieving revision 1.254 diff -c -r1.254 runtime.sgml *** a/doc/src/sgml/runtime.sgml 24 Mar 2004 22:40:28 -0000 1.254 --- b/doc/src/sgml/runtime.sgml 26 Mar 2004 03:16:35 -0000 *************** *** 521,532 **** Furthermore, it is possible to assign a set of option settings to a user or a database. Whenever a session is started, the default settings for the user and database involved are loaded. The ! commands ALTER DATABASE and ALTER ! USER, respectively, are used to configure these ! settings. Per-database settings override anything received ! from the postmaster command-line or the ! configuration file, and in turn are overridden by per-user ! settings; both are overridden by per-session options. --- 521,534 ---- Furthermore, it is possible to assign a set of option settings to a user or a database. Whenever a session is started, the default settings for the user and database involved are loaded. The ! commands and , ! respectively, are used to configure these settings. Per-database ! settings override anything received from the ! postmaster command-line or the configuration ! file, and in turn are overridden by per-user settings; both are ! overridden by per-session options. *************** *** 652,658 **** server is to listen for connections from client applications. The default is normally /tmp, but can be changed at build time. ! This parameter can only be set at server start. --- 654,660 ---- server is to listen for connections from client applications. The default is normally /tmp, but can be changed at build time. ! This parameter can only be set at server start. *************** *** 711,720 **** rendezvous_name (string) ! Specifies the Rendezvous broadcast name. By default, the ! computer name is used, specified as an empty string ''. ! This option is only meaningful on platforms that support Rendezvous. ! This option can only be set at server start. --- 713,723 ---- rendezvous_name (string) ! Specifies the Rendezvous broadcast ! name. By default, the computer name is used, specified as an ! empty string ''. This option is only meaningful on platforms ! that support Rendezvous. This ! option can only be set at server start. *************** *** 759,768 **** password_encryption (boolean) ! When a password is specified in CREATE USER or ! ALTER USER without writing either ENCRYPTED or ! UNENCRYPTED, this option determines whether the password is to be ! encrypted. The default is on (encrypt the password). --- 762,774 ---- password_encryption (boolean) ! When a password is specified in or ! ! without writing either ENCRYPTED or ! UNENCRYPTED, this option determines whether the ! password is to be encrypted. The default is on (encrypt the ! password). *************** *** 1010,1022 **** Cost-Based Vacuum Delay ! During the execution of VACUUM ! and ANALYZE commands, ! the system maintains an internal counter that keeps track of the ! estimated cost of the various I/O operations that are performed. ! When the accumulated cost reaches a limit ! (specified by vacuum_cost_limit), the process ! performing the operation will sleep for a while (specified by vacuum_cost_naptime). Then it will reset the counter and continue execution. --- 1016,1029 ---- Cost-Based Vacuum Delay ! During the execution of and commands, the system maintains an ! internal counter that keeps track of the estimated cost of the ! various I/O operations that are performed. When the accumulated ! cost reaches a limit (specified by ! vacuum_cost_limit), the process performing ! the operation will sleep for a while (specified by vacuum_cost_naptime). Then it will reset the counter and continue execution. *************** *** 1306,1315 **** choose a better plan. Other ways to improve the quality of the plans chosen by the optimizer include configuring the , running ! ANALYZE more frequently, and increasing the ! amount of statistics collected for a particular column using ! ALTER TABLE SET STATISTICS. --- 1313,1325 ---- choose a better plan. Other ways to improve the quality of the plans chosen by the optimizer include configuring the , running more ! frequently, increasing the value of the configuration parameter, ! and increasing the amount of statistics collected for a ! particular column using ALTER TABLE SET ! STATISTICS. *************** *** 2115,2127 **** log_statement (boolean) ! Causes each SQL statement to be logged. The default is off. ! EXECUTE only displays the plan name, not the ! prepared query. Server-side languages like ! PL/pgSQL that store functions in a cache only ! display their queries on first function call. Only superusers can ! turn off this option if it is enabled by the administrator. --- 2125,2151 ---- log_statement (boolean) ! Causes each SQL statement to be logged. The default is ! off. Only superusers can disable this option if it has been ! enabled by an administrator. + + + + When the EXECUTE statement is logged, only + the name of the prepared statement is recorded, not the + entire prepared statement. + + + + When a function is defined in a server-side language like + PL/pgSQL, any queries executed by + the function will only be logged the first time that the + function is invoked in a particular session. This is because + the PL/pgSQL keeps a cache of the + query plans produced for the SQL statements in the function. + + *************** *** 2202,2215 **** ! stats_block_level (boolean) stats_row_level (boolean) ! These enable the collection of block-level and row-level statistics ! on database activity, respectively. These options are off by ! default. This data can be accessed via the pg_stat and pg_statio family of system views; refer to for more information. --- 2226,2252 ---- ! stats_block_level (boolean) + + + Enables the collection of block-level statistics on database + activity. This option is disabled by default. If this option + is enabled, the data that is produced can be accessed via the + pg_stat and + pg_statio family of system views; + refer to for more information. + + + + + stats_row_level (boolean) ! Enables the collection of row-level statistics on database ! activity. This option is disabled by default. If this option ! is enabled, the data that is produced can be accessed via the pg_stat and pg_statio family of system views; refer to for more information. *************** *** 2311,2320 **** check_function_bodies (boolean) ! This parameter is normally true. When set false, it disables ! validation of the function body string in CREATE FUNCTION. ! Disabling validation is occasionally useful to avoid problems such as ! forward references when restoring function definitions from a dump. --- 2348,2359 ---- check_function_bodies (boolean) ! This parameter is normally true. When set to false, it disables ! validation of the function body string in . Disabling validation is ! occasionally useful to avoid problems such as forward ! references when restoring function definitions from a dump. *************** *** 2503,2509 **** Sets the locale to use for formatting numbers, for example ! with the to_char() family of functions. Acceptable values are system-dependent; see for more information. If this variable is set to the empty string (which is the default) then the value --- 2542,2548 ---- Sets the locale to use for formatting numbers, for example ! with the to_char family of functions. Acceptable values are system-dependent; see for more information. If this variable is set to the empty string (which is the default) then the value