sqlalchemy.engine.characteristics.ConnectionCharacteristic

class documentation

class ConnectionCharacteristic(ABC):

Known subclasses: sqlalchemy.databases.postgresql.PGDeferrableConnectionCharacteristic, sqlalchemy.databases.postgresql.PGReadOnlyConnectionCharacteristic, sqlalchemy.engine.characteristics.IsolationLevelCharacteristic

View In Hierarchy

An abstract base for an object that can set, get and reset a per-connection characteristic, typically one that gets reset when the connection is returned to the connection pool.

transaction isolation is the canonical example, and the IsolationLevelCharacteristic implementation provides this for the DefaultDialect.

The ConnectionCharacteristic class should call upon the Dialect for the implementation of each method. The object exists strictly to serve as a dialect visitor that can be placed into the DefaultDialect.connection_characteristics dictionary where it will take effect for calls to _engine.Connection.execution_options and related APIs.

New in version 1.4.

Method	`get_characteristic`	Given a DBAPI connection, get the current value of the characteristic.
Method	`reset_characteristic`	Reset the characteristic on the connection to its default value.
Method	`set_characteristic`	set characteristic on the connection to a given value.
Class Variable	`__slots__`	Undocumented
Class Variable	`transactional`	Undocumented

@abc.abstractmethod
def get_characteristic(self, dialect, dbapi_conn):

overridden in sqlalchemy.databases.postgresql.PGDeferrableConnectionCharacteristic, sqlalchemy.databases.postgresql.PGReadOnlyConnectionCharacteristic, sqlalchemy.engine.characteristics.IsolationLevelCharacteristic

Given a DBAPI connection, get the current value of the characteristic.

@abc.abstractmethod
def reset_characteristic(self, dialect, dbapi_conn):

Reset the characteristic on the connection to its default value.

@abc.abstractmethod
def set_characteristic(self, dialect, dbapi_conn, value):

set characteristic on the connection to a given value.

__slots__: tuple =

Undocumented

transactional: bool =

Undocumented