Further doc improvements.

This commit is contained in:
Anthony Tuininga 2023-05-09 16:50:04 -06:00
parent c59e6a2750
commit e4768951b9
1 changed files with 8 additions and 5 deletions

View File

@ -288,13 +288,16 @@ Also see `Avoiding Premature Prefetching`_.
Database Round-trips Database Round-trips
==================== ====================
A round-trip is defined as the trip from the Oracle Client libraries (used by A round-trip is defined as the travel of a message from python-oracledb to the
python-oracledb) to the database and back. Calling each python-oracledb function, or database and back. Calling each python-oracledb function, or accessing each
accessing each attribute, will require zero or more round-trips. Along with attribute, will require zero or more round-trips. For example, inserting a
tuning an application's architecture and `tuning its SQL statements simple row involves sending data to the database and getting a success response
back. This is a round-trip. Along with tuning an application's architecture
and `tuning its SQL statements
<https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=TGSQL>`__, a general <https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=TGSQL>`__, a general
performance and scalability goal is to minimize `round-trips performance and scalability goal is to minimize `round-trips
<https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-9B2F05F9-D841-4493-A42D-A7D89694A2D1>`__. <https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-9B2F05F9-D841-4493-A42D-A7D89694A2D1>`__
because they impact application performance and overall system scalability.
Some general tips for reducing round-trips are: Some general tips for reducing round-trips are: