AWS documentdb: DocumentDB retryable writes support updated for engine 8.0.2
Summary
Rewrites the transactions page to state that retryable writes (and retryable commit/abort) are now supported starting with engine version 8.0.2 outside of transactions, replacing prior text that said retryable writes are unsupported and must be disabled; also updates the navigation entry from 'Using collation' to 'Retryable writes' and links to a new retryable-writes page.
Security assessment
The change is a functional-capability update (retryable writes availability by engine version) in transaction documentation. It contains no vulnerability, credential, encryption, IAM, or exposure content; retryable writes affect resilience, not the security posture described here.
Evidence
- * Retryable writes, retryable commit, and retryable abort commands are not supported in Amazon DocumentDB. If you are using legacy mongo shell (not mongosh), do not include the `retryWrites=false` command in any code string. By default, retryable writes are disabled. Including `retryWrites=false` might cause a failure in normal read commands.
Diff
diff --git a/documentdb/latest/devguide/transactions.md b/documentdb/latest/devguide/transactions.md index 831ff5b2d..4bbab757e 100644 --- a//documentdb/latest/devguide/transactions.md +++ b//documentdb/latest/devguide/transactions.md @@ -70 +70 @@ Here are some best practices so that you can get the most using transactions wit - * Retryable writes, retryable commit, and retryable abort commands are not supported in Amazon DocumentDB. If you are using legacy mongo shell (not mongosh), do not include the `retryWrites=false` command in any code string. By default, retryable writes are disabled. Including `retryWrites=false` might cause a failure in normal read commands. + * On engine versions earlier than 8.0.2, retryable writes are not supported. Starting with engine version 8.0.2, retryable writes are supported outside of transactions for write operations in which each individual write affects at most one document, and transaction commit and abort operations are retryable. For more information, see [Retryable writes in Amazon DocumentDB](./retryable-writes.html). @@ -1671 +1671 @@ MongoDB sessions are a framework that is used to support retryable writes, causa -Amazon DocumentDB supports the use of sessions to enable transactions, but does not support causal consistency or retryable writes. +Amazon DocumentDB supports the use of sessions to enable transactions, but does not support causal consistency. Starting with engine version 8.0.2, Amazon DocumentDB supports retryable writes outside of transactions for write operations in which each individual write affects at most one document. On earlier engine versions, retryable writes are not supported. For more information, see [Retryable writes in Amazon DocumentDB](./retryable-writes.html). @@ -1711,5 +1711 @@ You can disable causal consistency within a session. Note that doing so will ena -Retryable writes is a capability in which the client will attempt to retry write operations, one time, when network errors occur or if the client is unable to find the primary. In Amazon DocumentDB, retryable writes are not supported and must be disabled. You can disable it with the command (`retryWrites=false`) in the connection string. - -###### Note - -If you are using legacy mongo shell (not mongosh), do not include the `retryWrites=false` command in any code string. By default, retryable writes are disabled. Including `retryWrites=false` might cause a failure in normal read commands. +With retryable writes, your driver automatically retries a write operation one time if a network error occurs or the driver can't find the primary. Starting with engine version 8.0.2, Amazon DocumentDB supports retryable writes. On earlier engine versions, retryable writes must be disabled by setting `retryWrites=false` in the connection string. For more information, see [Retryable writes in Amazon DocumentDB](./retryable-writes.html). @@ -1747 +1743 @@ Using change streams -Using collation +Retryable writes