diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 6e3e27bed76..81cacdcbe40 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -5047,7 +5047,7 @@ ANY num_sync ( the autovacuum launcher diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 2f44113caa5..87b6e5fb5e8 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -200,7 +200,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser Cumulative statistics are collected in shared memory. Every - PostgreSQL process collects statistics locally + PostgreSQL process collects statistics locally, then updates the shared data at appropriate intervals. When a server, including a physical replica, shuts down cleanly, a permanent copy of the statistics data is stored in the pg_stat subdirectory, diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml index d8dc7155874..1901736e600 100644 --- a/doc/src/sgml/postgres-fdw.sgml +++ b/doc/src/sgml/postgres-fdw.sgml @@ -491,7 +491,7 @@ OPTIONS (ADD password_required 'false'); For a foreign server with this option enabled, if many remote (sub)transactions are opened on the foreign server in a local - (sub)transaction, this option might increase the remote server’s load + (sub)transaction, this option might increase the remote server's load when the local (sub)transaction commits, so be careful when using this option. @@ -1040,7 +1040,7 @@ postgres=# SELECT postgres_fdw_disconnect_all(); %C - Cluster name in local server + Cluster name on local server (see for details) diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml index 255ad3a1ce0..0b32e7ecf99 100644 --- a/doc/src/sgml/ref/create_database.sgml +++ b/doc/src/sgml/ref/create_database.sgml @@ -132,7 +132,7 @@ CREATE DATABASE name available. This strategy writes a small record to the write-ahead log for each tablespace used by the target database. Each such record represents copying an entire directory to a new location at the - filesystem level. While this does reduce the write-ahed + filesystem level. While this does reduce the write-ahead log volume substantially, especially if the template database is large, it also forces the system to perform a checkpoint both before and after the creation of the new database. In some situations, this may @@ -278,11 +278,11 @@ CREATE DATABASE name The object identifier to be used for the new database. If this - parameter is not specified, the database will choose a suitable - OID automatically. This parameter is primarily intended for internal - use by pg_upgrade, and only - pg_upgrade can specify a value less - than 16384. + parameter is not specified, PostgreSQL + will choose a suitable OID automatically. This parameter is primarily + intended for internal use by pg_upgrade, + and only pg_upgrade can specify a value + less than 16384. diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml index 659fe2d984d..1a630f020bd 100644 --- a/doc/src/sgml/ref/pgbench.sgml +++ b/doc/src/sgml/ref/pgbench.sgml @@ -541,15 +541,15 @@ pgbench options d skipped. - When the option is used, the transaction with - serialization or deadlock error cannot be retried if the total time of - all its tries is greater than limit ms. To - limit only the time of tries and not their number, use - --max-tries=0. By default option - is set to 1 and transactions with - serialization/deadlock errors are not retried. See for more information about retrying - such transactions. + When the option is used, a transaction + which fails due to a serialization anomaly or from a deadlock will not + be retried if the total time of all its tries is greater than + limit ms. To limit only the time of tries + and not their number, use --max-tries=0. By + default, the option is set to 1 and + transactions with serialization/deadlock errors are not retried. See + for more information about + retrying such transactions. @@ -622,7 +622,7 @@ pgbench options d throttling (), the latency is computed with respect to the transaction scheduled start time, not the actual transaction beginning time, thus it also includes the average schedule lag time. - When is used to enable transactions retries + When is used to enable transaction retries after serialization/deadlock errors, the report includes the number of retried transactions and the sum of all retries. @@ -818,7 +818,7 @@ pgbench options d Print messages about all errors and failures (errors without retrying) - including which limit for retries was violated and how far it was + including which limit for retries was exceeded and how far it was exceeded for the serialization/deadlock failures. (Note that in this case the output can be significantly increased.). See for more information. @@ -2433,7 +2433,7 @@ END; - If option is used, the type of + If the option is used, the type of failure is reported in the time like this: 3 0 47423 0 1499414498 34501 3 @@ -2773,12 +2773,12 @@ statement latencies in milliseconds, failures and retries: Errors of the main program. They are the most serious and always result - in an immediate exit from the pgbench with - the corresponding error message. They include: + in an immediate exit from pgbench with the + corresponding error message. They include: - errors at the beginning of the pgbench + errors at the beginning of pgbench (e.g. an invalid option value); @@ -2790,8 +2790,8 @@ statement latencies in milliseconds, failures and retries: - errors before starting threads (e.g. we could not connect to the - database server / the syntax error in the meta command / thread + errors before starting threads (e.g. could not connect to the + database server, syntax error in the meta command, thread creation failure); @@ -2813,7 +2813,7 @@ statement latencies in milliseconds, failures and retries: - Direct client errors. They lead to immediate exit from the + Direct client errors. They lead to immediate exit from pgbench with the corresponding error message only in the case of an internal pgbench error (which are supposed to never occur...). Otherwise in the worst @@ -2829,11 +2829,11 @@ statement latencies in milliseconds, failures and retries: - Client's run is aborted in case of a serious error, for example, the - connection with the database server was lost or the end of script reached - without completing the last transaction. In addition, if an execution of SQL + A client's run is aborted in case of a serious error; for example, the + connection with the database server was lost or the end of script was reached + without completing the last transaction. In addition, if execution of an SQL or meta command fails for reasons other than serialization or deadlock errors, - the client is aborted. Otherwise, if an SQL fails with serialization or + the client is aborted. Otherwise, if an SQL command fails with serialization or deadlock errors, the client is not aborted. In such cases, the current transaction is rolled back, which also includes setting the client variables as they were before the run of this transaction (it is assumed that one @@ -2845,21 +2845,21 @@ statement latencies in milliseconds, failures and retries: time of retries (specified by the option) / the end of benchmark (specified by the option). If the last trial run fails, this transaction will be reported as failed but - the client is not aborted and continue to work. + the client is not aborted and continues to work. - Without specifying the option a transaction will + Without specifying the option, a transaction will never be retried after a serialization or deadlock error because its default - values is 1. Use an unlimited number of tries (--max-tries=0) + value is 1. Use an unlimited number of tries (--max-tries=0) and the option to limit only the maximum time of tries. You can also use the option to limit the benchmark duration under an unlimited number of tries. Be careful when repeating scripts that contain multiple transactions: the - script is always retried completely, so the successful transactions can be + script is always retried completely, so successful transactions can be performed several times. @@ -2879,7 +2879,7 @@ statement latencies in milliseconds, failures and retries: The main report contains the number of failed transactions. If the option is not equal to 1, the main report also - contains the statistics related to retries: the total number of retried + contains statistics related to retries: the total number of retried transactions and total number of retries. The per-script report inherits all these fields from the main report. The per-statement report displays retry statistics only if the option is not equal to 1. @@ -2890,7 +2890,7 @@ statement latencies in milliseconds, failures and retries: aggregation logs, as well as in the main and per-script reports, use the option. If you also want to distinguish all errors and failures (errors without retrying) by type including which - limit for retries was violated and how far it was exceeded for the + limit for retries was exceeded and how much it was exceeded by for the serialization/deadlock failures, use the option.