[DRIVERS-2096] Document usability of async methods with sessions (ex: ReplaceOneAsync) Created: 12/Dec/19  Updated: 01/Sep/22

Status: Backlog
Project: Drivers
Component/s: Sessions
Fix Version/s: None

Type: Spec Change Priority: Major - P3
Reporter: Pavithra Vetriselvan Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
Duplicate
Related
is related to DRIVERS-2165 Consider allowing (async) drivers to ... Closed
Driver Changes: Needed

 Description   

This came out of an investigation for SERVER-43889, where the reporter was misusing the ReplaceOneAsync method with retryable writes. In this case, they were trying to run multiple concurrent retryable writes on the same session before waiting for the previous write to complete.

The documentation doesn't mention the overloaded version of ReplaceOneAsync, which can take a session.

We should document the proper way to use this (and similar async methods?) with sessions since they can produce undesirable results otherwise.



 Comments   
Comment by Jeffrey Yemin [ 12/Dec/19 ]

This would be appropriate for all async clients.

Comment by Bernie Hackett [ 12/Dec/19 ]

jeff.yemin this seems like a .NET ticket, but I'm curious if there is documentation work to be done here for other async clients?

Generated at Thu Feb 08 08:24:43 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.