diff options
Diffstat (limited to 'lib/sqlalchemy/orm/session.py')
| -rw-r--r-- | lib/sqlalchemy/orm/session.py | 24 |
1 files changed, 18 insertions, 6 deletions
diff --git a/lib/sqlalchemy/orm/session.py b/lib/sqlalchemy/orm/session.py index c76ece5de..8be5fbee7 100644 --- a/lib/sqlalchemy/orm/session.py +++ b/lib/sqlalchemy/orm/session.py @@ -1001,10 +1001,10 @@ class Session(_SessionClassMethods): described at :meth:`.Session.get_bind`. Usage looks like:: Session = sessionmaker(binds={ - SomeMappedClass: create_engine('postgresql://engine1'), - SomeDeclarativeBase: create_engine('postgresql://engine2'), - some_mapper: create_engine('postgresql://engine3'), - some_table: create_engine('postgresql://engine4'), + SomeMappedClass: create_engine('postgresql+psycopg2://engine1'), + SomeDeclarativeBase: create_engine('postgresql+psycopg2://engine2'), + some_mapper: create_engine('postgresql+psycopg2://engine3'), + some_table: create_engine('postgresql+psycopg2://engine4'), }) .. seealso:: @@ -1086,7 +1086,7 @@ class Session(_SessionClassMethods): :param autocommit: the "autocommit" keyword is present for backwards compatibility but must remain at its default value of ``False``. - """ + """ # noqa # considering allowing the "autocommit" keyword to still be accepted # as long as it's False, so that external test suites, oslo.db etc @@ -2042,6 +2042,18 @@ class Session(_SessionClassMethods): """Return a new :class:`_query.Query` object corresponding to this :class:`_orm.Session`. + Note that the :class:`_query.Query` object is legacy as of + SQLAlchemy 2.0; the :func:`_sql.select` construct is now used + to construct ORM queries. + + .. seealso:: + + :ref:`unified_tutorial` + + :ref:`queryguide_toplevel` + + :ref:`query_api_toplevel` - legacy API doc + """ return self._query_cls(entities, self, **kwargs) @@ -3906,7 +3918,7 @@ class sessionmaker(_SessionClassMethods): # an Engine, which the Session will use for connection # resources - engine = create_engine('postgresql://scott:tiger@localhost/') + engine = create_engine('postgresql+psycopg2://scott:tiger@localhost/') Session = sessionmaker(engine) |