Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit262c439

Browse files
Marina PolyakovaLiudmila Mantrova
Marina Polyakova
authored and
Liudmila Mantrova
committed
Pgbench Fix documentation from Liudmila Mantrova 2
1 parentb441724 commit262c439

File tree

1 file changed

+43
-44
lines changed

1 file changed

+43
-44
lines changed

‎doc/src/sgml/ref/pgbench.sgml

Lines changed: 43 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -479,11 +479,12 @@ pgbench <optional> <replaceable>options</> </optional> <replaceable>dbname</>
479479
</para>
480480
<note>
481481
<para>
482-
The total sum of retries can be greater than the number of retried
483-
transactions multiplied by the maximum retries number
484-
(<option>max_tries</> - 1). See
485-
<xref linkend="transactions-and-scripts"
486-
endterm="transactions-and-scripts-title"> for more information.
482+
If a custom script contains multiple transactions, its run is reported
483+
as failed if any of its transactions ended with a
484+
serialization/deadlock failure. The run of this script is reported as
485+
retried if any of its transactions was retried after a
486+
serialization/deadlock failure. The total sum of retries includes the
487+
retries for all transactions in this script.
487488
</para>
488489
</note>
489490
</listitem>
@@ -544,21 +545,6 @@ pgbench <optional> <replaceable>options</> </optional> <replaceable>dbname</>
544545
separately.
545546
</para>
546547

547-
<para>
548-
The execution time of transactions with serialization or deadlock
549-
failures is excluded from the report, as if these transactions were
550-
skipped.
551-
</para>
552-
553-
<note>
554-
<para>
555-
In scripts with several transactions, both serialization and deadlock
556-
failures can occur. For more information, see
557-
<xref linkend="transactions-and-scripts"
558-
endterm="transactions-and-scripts-title">.
559-
</para>
560-
</note>
561-
562548
<para>
563549
A high schedule lag time is an indication that the system cannot
564550
process transactions at the specified rate, with the chosen number of
@@ -781,8 +767,8 @@ pgbench <optional> <replaceable>options</> </optional> <replaceable>dbname</>
781767
<refsect1>
782768
<title>Notes</title>
783769

784-
<refsect2 id="transactions-and-scripts">
785-
<title id="transactions-and-scripts-title">What is the <quote>Transaction</> Actually Performed in <application>pgbench</application>?</title>
770+
<refsect2>
771+
<title>What is the <quote>Transaction</> Actually Performed in <application>pgbench</application>?</title>
786772

787773
<para>
788774
<application>pgbench</> executes test scripts chosen randomly
@@ -1257,6 +1243,14 @@ END;
12571243
for more information).
12581244
</para>
12591245

1246+
<note>
1247+
<para>
1248+
If a custom script contains multiple transactions, its <replaceable>time</>
1249+
will be reported as <literal>failed</> if any of its transactions ended
1250+
with a serialization/deadlock failure.
1251+
</para>
1252+
</note>
1253+
12601254
<para>
12611255
Here is a snippet of the log file generated:
12621256
<screen>
@@ -1344,10 +1338,15 @@ END;
13441338
</para>
13451339

13461340
<note>
1347-
<para>The total sum of retries can be greater than the number of retried
1348-
transactions multiplied by the maximum retries number
1349-
(<option>max_tries</> - 1). See <xref linkend="transactions-and-scripts"
1350-
endterm="transactions-and-scripts-title"> for more information.
1341+
<para>
1342+
If a custom script contains multiple transactions and any of its
1343+
transactions ended with a serialization/deadlock failure, its run is counted
1344+
in <replaceable>failures</replaceable> only once. Similarly, if any of these
1345+
transactions was retried, the <replaceable>retried_transactions</>
1346+
statistics is increased by one, regardless of the number of retried
1347+
transactions. However, the <replaceable>serialization_retries</> and
1348+
<replaceable>deadlock_retries</> include the sum of all retries after the
1349+
corresponding failures for all transactions in this script.
13511350
</para>
13521351
</note>
13531352

@@ -1408,10 +1407,10 @@ END;
14081407

14091408
<note>
14101409
<para>
1411-
The total sum of per-command failures can be greater than the number of
1412-
failed transactions. The same for retries. See
1413-
<xref linkend="transactions-and-scripts"
1414-
endterm="transactions-and-scripts-title"> for more information.
1410+
If a custom script contains multiple transactions, each failed or retried
1411+
transaction is counted. Thus, the total sum of per-command failures and/or
1412+
retries can be greater than the number of failedand/or retried transaction
1413+
scripts correspondingly.
14151414
</para>
14161415
</note>
14171416

@@ -1533,22 +1532,22 @@ script statistics:
15331532
</para>
15341533

15351534
<para>
1536-
The main report contains the number of failed transactions if it is non-zero
1537-
(see <xref linkend="transactions-and-scripts"
1538-
endterm="transactions-and-scripts-title"> for more information). If the total
1539-
number of retried transactions is non-zero, the main report also contains
1540-
the total number of retried transactions, the total number of retries, and
1541-
the number of retries after each kind of
1542-
failure (use option <option>--max-tries</> to make it possible). The
1543-
per-statement report inherits all columns from the main report.
1535+
The main report contains the number of failed transactions if it is non-zero.
1536+
If the total number of retried transactions is non-zero, the main report also
1537+
contains the statistics related to retries: the total number of retried
1538+
transactions, the total number of retries, and the number of retries after
1539+
each kind of failure (use option <option>--max-tries</> to make it possible).
1540+
The per-statement report inherits all columns from the main report.
15441541
</para>
15451542
<note>
1546-
<para>The total sum of retries can be greater than the number of
1547-
retried transactions multiplied by the maximum retries number
1548-
(<option>max_tries</> - 1). See <xref linkend="transactions-and-scripts"
1549-
endterm="transactions-and-scripts-title"> for more information.
1550-
</para>
1551-
</note>
1543+
<para>
1544+
If a custom script contains multiple transactions, its run is reported as
1545+
failed if any of its transactions ended with a serialization/deadlock
1546+
failure. The run of this script is reported as retried if any of its
1547+
transactions was retried after a serialization/deadlock failure. The total
1548+
sum of retries includes the retries for all transactions in this script.
1549+
</para>
1550+
</note>
15521551
</refsect2>
15531552

15541553
<refsect2>

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp