Participer au site avec un Tip
Rechercher
 

Améliorations / Corrections

Vous avez des améliorations (ou des corrections) à proposer pour ce document : je vous remerçie par avance de m'en faire part, cela m'aide à améliorer le site.

Emplacement :

Description des améliorations :

Vous êtes un professionnel et vous avez besoin d'une formation ? Coder avec une
Intelligence Artificielle
Voir le programme détaillé
Classe « Dialect »

Méthode sqlalchemy.Dialect.on_connect_url

Signature de la méthode on_connect_url

def on_connect_url(self, url: 'URL') -> 'Optional[Callable[[Any], Any]]' 

Description

help(Dialect.on_connect_url)

return a callable which sets up a newly created DBAPI connection.

This method is a new hook that supersedes the
:meth:`_engine.Dialect.on_connect` method when implemented by a
dialect.   When not implemented by a dialect, it invokes the
:meth:`_engine.Dialect.on_connect` method directly to maintain
compatibility with existing dialects.   There is no deprecation
for :meth:`_engine.Dialect.on_connect` expected.

The callable should accept a single argument "conn" which is the
DBAPI connection itself.  The inner callable has no
return value.

E.g.::

    class MyDialect(default.DefaultDialect):
        # ...

        def on_connect_url(self, url):
            def do_on_connect(connection):
                connection.execute("SET SPECIAL FLAGS etc")

            return do_on_connect

This is used to set dialect-wide per-connection options such as
isolation modes, Unicode modes, etc.

This method differs from :meth:`_engine.Dialect.on_connect` in that
it is passed the :class:`_engine.URL` object that's relevant to the
connect args.  Normally the only way to get this is from the
:meth:`_engine.Dialect.on_connect` hook is to look on the
:class:`_engine.Engine` itself, however this URL object may have been
replaced by plugins.

.. note::

    The default implementation of
    :meth:`_engine.Dialect.on_connect_url` is to invoke the
    :meth:`_engine.Dialect.on_connect` method. Therefore if a dialect
    implements this method, the :meth:`_engine.Dialect.on_connect`
    method **will not be called** unless the overriding dialect calls
    it directly from here.

.. versionadded:: 1.4.3 added :meth:`_engine.Dialect.on_connect_url`
   which normally calls into :meth:`_engine.Dialect.on_connect`.

:param url: a :class:`_engine.URL` object representing the
 :class:`_engine.URL` that was passed to the
 :meth:`_engine.Dialect.create_connect_args` method.

:return: a callable that accepts a single DBAPI connection as an
 argument, or None.

.. seealso::

    :meth:`_engine.Dialect.on_connect`



Vous êtes un professionnel et vous avez besoin d'une formation ? Sensibilisation à
l'Intelligence Artificielle
Voir le programme détaillé