diff options
| -rw-r--r-- | lib/sqlalchemy/orm/session.py | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/lib/sqlalchemy/orm/session.py b/lib/sqlalchemy/orm/session.py index a7440bf40..a7eedcf34 100644 --- a/lib/sqlalchemy/orm/session.py +++ b/lib/sqlalchemy/orm/session.py @@ -2213,6 +2213,12 @@ class Session(_SessionClassMethods): **before using this method, and fully test and confirm the functionality of all code developed using these systems.** + .. warning:: + + Objects are processed in the order passed. Be sure to group objects + of the same type together (the list is sorted), else they will be + inserted in distinct batches. + :param objects: a list of mapped object instances. The mapped objects are persisted as is, and are **not** associated with the :class:`.Session` afterwards. |