Skip to content

Commit dbaa170

Browse files
authored
DOCSP-35213 Transaction Error Handling & Retry Logic (#6366) (#6682)
* DOCSP-35213 Transaction Error Handling & Retry Logic * build errors * * * ref text * external feedback * revert to original * revert to externally approved version
1 parent 100c1ea commit dbaa170

File tree

1 file changed

+11
-6
lines changed

1 file changed

+11
-6
lines changed

source/core/transactions-in-applications.txt

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -338,6 +338,8 @@ labeled:
338338
To handle :ref:`unknown-transaction-commit-result`,
339339
applications should explicitly incorporate retry logic for the error.
340340

341+
.. _txn-core-api-retry:
342+
341343
Example
342344
~~~~~~~
343345

@@ -389,17 +391,18 @@ the transaction as a whole can be retried.
389391
- The core transaction API does not incorporate retry logic
390392
for ``"TransientTransactionError"``. To handle
391393
``"TransientTransactionError"``, applications should explicitly
392-
incorporate retry logic for the error.
394+
incorporate retry logic for the error. To view an example that incorporates
395+
retry logic for transient errors, see :ref:`Core API Example
396+
<txn-core-api-retry>`.
393397

394398
.. _unknown-transaction-commit-result:
395399

396400
``"UnknownTransactionCommitResult"``
397401
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
398402

399-
The commit operations are :doc:`retryable write operations
400-
</core/retryable-writes>`. If the commit operation encounters an error,
401-
MongoDB drivers retry the commit regardless of the value of
402-
:urioption:`retryWrites`.
403+
Commit operations are :ref:`retryable write operations <retryable-writes>`. If
404+
the commit operation encounters an error, MongoDB drivers retry the commit
405+
regardless of the value of :urioption:`retryWrites`.
403406

404407
If the commit operation encounters an error labeled
405408
``"UnknownTransactionCommitResult"``, the commit can be retried.
@@ -410,7 +413,9 @@ If the commit operation encounters an error labeled
410413
- The core transaction API does not incorporate retry logic for
411414
``"UnknownTransactionCommitResult"``. To handle
412415
``"UnknownTransactionCommitResult"``, applications should explicitly
413-
incorporate retry logic for the error.
416+
incorporate retry logic for the error. To view an example that incorporates
417+
retry logic for unknown commit errors, see :ref:`Core API Example
418+
<txn-core-api-retry>`.
414419

415420

416421
Driver Version Errors

0 commit comments

Comments
 (0)