class documentation

class SQLiteDialect_pysqlcipher(SQLiteDialect_pysqlite):

View In Hierarchy

Undocumented

Class Method dbapi Undocumented
Class Method get​_pool​_class Undocumented
Method create​_connect​_args Build DB-API compatible connection arguments.
Method on​_connect​_url return a callable which sets up a newly created DBAPI connection.
Class Variable driver Undocumented
Class Variable pragmas Undocumented
Class Variable supports​_statement​_cache indicates if this dialect supports caching.

Inherited from SQLiteDialect_pysqlite:

Class Method ​_is​_url​_file​_db Undocumented
Method ​_get​_server​_version​_info Retrieve the server version info from the given connection.
Method is​_disconnect Return True if the given DB-API error indicates an invalid connection
Method on​_connect return a callable which sets up a newly created DBAPI connection.
Method set​_isolation​_level Given a DBAPI connection, set its isolation level.
Class Variable ​_isolation​_lookup Undocumented
Class Variable colspecs Undocumented
Class Variable default​_paramstyle Undocumented
Class Variable description​_encoding Undocumented

Inherited from SQLiteDialect (via SQLiteDialect_pysqlite):

Method __init__ Undocumented
Method ​_find​_cols​_in​_sig Undocumented
Method ​_get​_column​_info Undocumented
Method ​_get​_default​_schema​_name Return the string name of the currently selected schema from the given connection.
Method ​_get​_table​_pragma Undocumented
Method ​_get​_table​_sql Undocumented
Method ​_resolve​_type​_affinity Return a data type from a reflected column, using affinity rules.
Method get​_check​_constraints Return information about check constraints in table_name.
Method get​_columns Return information about columns in table_name.
Method get​_foreign​_keys Return information about foreign_keys in table_name.
Method get​_indexes Return information about indexes in table_name.
Method get​_isolation​_level Given a DBAPI connection, return its isolation level.
Method get​_pk​_constraint Return information about the primary key constraint on table_name`.
Method get​_schema​_names Undocumented
Method get​_table​_names Return a list of table names for schema.
Method get​_temp​_table​_names Return a list of temporary table names on the given connection, if supported by the underlying backend.
Method get​_temp​_view​_names Return a list of temporary view names on the given connection, if supported by the underlying backend.
Method get​_unique​_constraints Return information about unique constraints in table_name.
Method get​_view​_definition Return view definition.
Method get​_view​_names Return a list of all view names available in the database.
Method has​_table For internal dialect use, check the existence of a particular table in the database.
Class Variable construct​_arguments Optional set of argument specifiers for various SQLAlchemy constructs, typically schema items.
Class Variable name Undocumented
Class Variable supports​_alter Undocumented
Class Variable supports​_default​_metavalue dialect supports INSERT... VALUES (DEFAULT) syntax
Class Variable supports​_empty​_insert dialect supports INSERT () VALUES ()
Class Variable supports​_unicode​_binds Undocumented
Class Variable supports​_unicode​_statements Undocumented
Class Variable tuple​_in​_values Undocumented
Instance Variable ​_broken​_dotted​_colnames Undocumented
Instance Variable ​_broken​_fk​_pragma​_quotes Undocumented
Instance Variable ​_json​_deserializer Undocumented
Instance Variable ​_json​_serializer Undocumented
Instance Variable isolation​_level Undocumented
Instance Variable native​_datetime Undocumented
Instance Variable supports​_cast Undocumented
Instance Variable supports​_default​_values dialect supports INSERT... DEFAULT VALUES syntax
Instance Variable supports​_multivalues​_insert Undocumented

Inherited from DefaultDialect (via SQLiteDialect_pysqlite, SQLiteDialect):

Class Method load​_provisioning set up the provision.py module for this dialect.
Method connect Establish a connection using this dialect's DBAPI.
Method create​_xid Create a random two-phase transaction ID.
Method denormalize​_name convert the given name to a case insensitive identifier for the backend if it is an all-lowercase name.
Method do​_begin Provide an implementation of connection.begin(), given a DB-API connection.
Method do​_close Provide an implementation of connection.close(), given a DBAPI connection.
Method do​_commit Provide an implementation of connection.commit(), given a DB-API connection.
Method do​_execute Provide an implementation of cursor.execute(statement, parameters).
Method do​_execute​_no​_params Provide an implementation of cursor.execute(statement).
Method do​_executemany Provide an implementation of cursor.executemany(statement, parameters).
Method do​_release​_savepoint Release the named savepoint on a connection.
Method do​_rollback Provide an implementation of connection.rollback(), given a DB-API connection.
Method do​_rollback​_to​_savepoint Rollback a connection to the named savepoint.
Method do​_savepoint Create a savepoint with the given name.
Method get​_default​_isolation​_level Given a DBAPI connection, return its isolation level, or a default isolation level if one cannot be retrieved.
Method get​_driver​_connection Returns the connection object as returned by the external driver package.
Method has​_index Check the existence of a particular index name in the database.
Method initialize Called during strategized creation of the dialect with a connection.
Method normalize​_name convert the given name to lowercase if it is detected as case insensitive.
Method reset​_isolation​_level Given a DBAPI connection, revert its isolation to the default.
Method type​_descriptor Provide a database-specific .TypeEngine object, given the generic object which comes from the types module.
Class Variable dbapi​_exception​_translation​_map mapping used in the extremely unusual case that a DBAPI's published exceptions don't actually have the __name__ that they are linked towards.
Instance Variable returns​_unicode​_strings Undocumented
Instance Variable type​_compiler Undocumented
Method ​_check​_max​_identifier​_length Perform a connection / server version specific check to determine the max_identifier_length.
Method ​_check​_unicode​_description Undocumented
Method ​_check​_unicode​_returns Undocumented
Method ​_ensure​_has​_table​_connection Undocumented
Method ​_reset​_characteristics Undocumented
Method ​_set​_connection​_characteristics Undocumented
Method do​_ping Undocumented
Method get​_dialect​_pool​_class Undocumented
Method set​_connection​_execution​_options Undocumented
Method set​_engine​_execution​_options Undocumented
Method validate​_identifier Undocumented
Class Variable connection​_characteristics Undocumented
Class Variable cte​_follows​_insert Undocumented
Class Variable default​_sequence​_base Undocumented
Class Variable engine​_config​_types Undocumented
Class Variable full​_returning Undocumented
Class Variable inline​_comments Undocumented
Class Variable insert​_executemany​_returning Undocumented
Class Variable is​_async Undocumented
Class Variable max​_constraint​_name​_length Undocumented
Class Variable max​_index​_name​_length Undocumented
Class Variable non​_native​_boolean​_check​_constraint Undocumented
Class Variable postfetch​_lastrowid Undocumented
Class Variable preexecute​_autoincrement​_sequences Undocumented
Class Variable reflection​_options Undocumented
Class Variable requires​_name​_normalize Undocumented
Class Variable sequences​_optional Undocumented
Class Variable server​_side​_cursors Undocumented
Class Variable supports​_comments Undocumented
Class Variable supports​_for​_update​_of Undocumented
Class Variable supports​_identity​_columns Undocumented
Class Variable supports​_is​_distinct​_from Undocumented
Class Variable supports​_native​_decimal Undocumented
Class Variable supports​_native​_enum Undocumented
Class Variable supports​_sane​_multi​_rowcount Undocumented
Class Variable supports​_sane​_rowcount Undocumented
Class Variable supports​_schemas Undocumented
Class Variable supports​_sequences Undocumented
Class Variable supports​_server​_side​_cursors Undocumented
Class Variable supports​_simple​_order​_by​_label Undocumented
Class Variable supports​_views Undocumented
Class Variable use​_setinputsizes Undocumented
Instance Variable ​_decoder Undocumented
Instance Variable ​_description​_decoder Undocumented
Instance Variable ​_encoder Undocumented
Instance Variable ​_ischema Undocumented
Instance Variable ​_user​_defined​_max​_identifier​_length Undocumented
Instance Variable case​_sensitive Undocumented
Instance Variable compiler​_linting Undocumented
Instance Variable convert​_unicode Undocumented
Instance Variable default​_isolation​_level Undocumented
Instance Variable default​_schema​_name Undocumented
Instance Variable encoding Undocumented
Instance Variable identifier​_preparer Undocumented
Instance Variable implicit​_returning Undocumented
Instance Variable label​_length Undocumented
Instance Variable max​_identifier​_length Undocumented
Instance Variable paramstyle Undocumented
Instance Variable positional Undocumented
Instance Variable server​_version​_info Undocumented
Instance Variable supports​_native​_boolean Undocumented
Property ​_dialect​_specific​_select​_one Undocumented
Property ​_supports​_statement​_cache Undocumented
Property ​_type​_memos Undocumented
Property dialect​_description Undocumented
Property supports​_sane​_rowcount​_returning True if this dialect supports sane rowcount even if RETURNING is in use.

Inherited from Dialect (via SQLiteDialect_pysqlite, SQLiteDialect, DefaultDialect):

Class Method engine​_created A convenience hook called before returning the final _engine.Engine.
Class Method get​_dialect​_cls Given a URL, return the .Dialect that will be used.
Method do​_begin​_twophase Begin a two phase transaction on the given connection.
Method do​_commit​_twophase Commit a two phase transaction on the given connection.
Method do​_prepare​_twophase Prepare a two phase transaction on the given connection.
Method do​_recover​_twophase Recover list of uncommitted prepared two phase transaction identifiers on the given connection.
Method do​_rollback​_twophase Rollback a two phase transaction on the given connection.
Method do​_set​_input​_sizes invoke the cursor.setinputsizes() method with appropriate arguments
Method get​_sequence​_names Return a list of all sequence names available in the database.
Method get​_table​_comment Return the "comment" for the table identified by table_name.
Method has​_sequence Check the existence of a particular sequence in the database.
Class Variable ​_has​_events Undocumented
@classmethod
def dbapi(cls):
@classmethod
def get_pool_class(cls, url):
def create_connect_args(self, url):

Build DB-API compatible connection arguments.

Given a .URL object, returns a tuple consisting of a (*args, **kwargs) suitable to send directly to the dbapi's connect function. The arguments are sent to the .Dialect.connect method which then runs the DBAPI-level connect() function.

The method typically makes use of the .URL.translate_connect_args method in order to generate a dictionary of options.

The default implementation is:

def create_connect_args(self, url):
    opts = url.translate_connect_args()
    opts.update(url.query)
    return [[], opts]

See Also

.URL.translate_connect_args

Parameters
urla .URL object
Returns
a tuple of (*args, **kwargs) which will be passed to the .Dialect.connect method.
def on_connect_url(self, url):

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

This method is a new hook that supersedes the _engine.Dialect.on_connect method when implemented by a dialect. When not implemented by a dialect, it invokes the _engine.Dialect.on_connect method directly to maintain compatibility with existing dialects. There is no deprecation for _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 _engine.Dialect.on_connect in that it is passed the _engine.URL object that's relevant to the connect args. Normally the only way to get this is from the _engine.Dialect.on_connect hook is to look on the _engine.Engine itself, however this URL object may have been replaced by plugins.

Note

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

New in version 1.4.3: added _engine.Dialect.on_connect_url which normally calls into _engine.Dialect.on_connect.

See Also

_engine.Dialect.on_connect

Parameters
urla _engine.URL object representing the _engine.URL that was passed to the _engine.Dialect.create_connect_args method.
Returns
a callable that accepts a single DBAPI connection as an argument, or None.
pragmas: tuple[str, ...] =

Undocumented

supports_statement_cache: bool =

indicates if this dialect supports caching.

All dialects that are compatible with statement caching should set this flag to True directly on each dialect class and subclass that supports it. SQLAlchemy tests that this flag is locally present on each dialect subclass before it will use statement caching. This is to provide safety for legacy or new dialects that are not yet fully tested to be compliant with SQL statement caching.

New in version 1.4.5.