Skip to content

Commit 9fd6469

Browse files
committed
NS feedback
1 parent 10a57c2 commit 9fd6469

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

source/reference/migration.txt

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ application or use case:
4040
- Your application is simple in execution, or you prefer to avoid using asynchronous calls
4141
in your code
4242

43-
- Your application relies on non-concurrent workloads or workloads with very fast
43+
- Your application relies on serial workloads or workloads with very fast
4444
response times
4545

4646
- You prefer the simplicity of synchronous logic when debugging your application
@@ -113,10 +113,15 @@ The following Motor method signatures behave differently in the {+driver-async+}
113113

114114
Motor users may experience a degradation of performance when switching to the
115115
{+driver-async+} driver. This is due to the {+driver-async+} driver using the native
116-
``asyncio`` library instead of thread-based executors.
117-
118-
Users experiencing performance slowdown should consider using synchronous {+driver-short+}
119-
with ``async.loop.run_in_executor()`` for asynchronous compatibility. To learn more, see
116+
``asyncio`` library instead of thread-based executors. Thread-based executors
117+
have similar performance characteristics to the synchronous driver, but slower.
118+
This means they perform better for workloads that do not fit the preceding criteria
119+
for the {+driver-async+} driver.
120+
121+
If you are experiencing performance slowdown, identify whether the {+driver-async+} driver
122+
is necessary for your usecase. If you determine your use case is better served by
123+
synchronous {+driver-short+}, consider using synchronous {+driver-short+}
124+
with ``asyncio.loop.run_in_executor()`` for asynchronous compatibility. To learn more, see
120125
the `Event Loop API documentation <https://docs.python.org/3/library/asyncio-eventloop.html#asyncio.loop.run_in_executor>`__.
121126

122127
.. _pymongo-to-async-guide:

0 commit comments

Comments
 (0)