QSqlDriver Class Reference

[QtSql module]

该QSqlDriver类是用于访问特定的SQL数据库的抽象基类。More…

继承QObject。

Types

• enum DriverFeature { Transactions, QuerySize, BLOB, Unicode, ..., MultipleResultSets }
• enum IdentifierType { FieldName, TableName }
• enum StatementType { WhereStatement, SelectStatement, UpdateStatement, InsertStatement, DeleteStatement }

Methods

• __init__ (self, QObject parent = None)
• bool beginTransaction (self)
• close (self)
• bool commitTransaction (self)
• QSqlResult createResult (self)
• QString escapeIdentifier (self, QString identifier, IdentifierType type)
• QString formatValue (self, QSqlField field, bool trimStrings = False)
• QVariant handle (self)
• bool hasFeature (self, DriverFeature f)
• bool isIdentifierEscaped (self, QString identifier, IdentifierType type)
• bool isIdentifierEscapedImplementation (self, QString identifier, IdentifierType type)
• bool isOpen (self)
• bool isOpenError (self)
• QSqlError lastError (self)
• QSql.NumericalPrecisionPolicy numericalPrecisionPolicy (self)
• bool open (self, QString db, QString user = QString(), QString password = QString(), QString host = QString(), int port = -1, QString options = QString())
• QSqlIndex primaryIndex (self, QString tableName)
• QSqlRecord record (self, QString tableName)
• bool rollbackTransaction (self)
• setLastError (self, QSqlError e)
• setNumericalPrecisionPolicy (self, QSql.NumericalPrecisionPolicy precisionPolicy)
• setOpen (self, bool o)
• setOpenError (self, bool e)
• QString sqlStatement (self, StatementType type, QString tableName, QSqlRecord rec, bool preparedStatement)
• QString stripDelimiters (self, QString identifier, IdentifierType type)
• QString stripDelimitersImplementation (self, QString identifier, IdentifierType type)
• QStringList subscribedToNotifications (self)
• QStringList subscribedToNotificationsImplementation (self)
• bool subscribeToNotification (self, QString name)
• bool subscribeToNotificationImplementation (self, QString name)
• QStringList tables (self, QSql.TableType tableType)
• bool unsubscribeFromNotification (self, QString name)
• bool unsubscribeFromNotificationImplementation (self, QString name)

Qt Signals

• void notification (const QString&)

Detailed Description

该QSqlDriver类是用于访问特定的SQL数据库的抽象基类。

这个类不应该直接使用。使用QSqlDatabase代替。

如果你想创建自己的SQL驱动程序，你可以继承这个类，并重新实现它的纯虚函数，而且你需要那些虚函数。看How to Write Your Own Database Driver了解更多信息。

Type Documentation

QSqlDriver.DriverFeature

此枚举包含的功能驱动程序可能支持的列表。使用hasFeature（ ）来查询功能是否支持与否。

有关支持的功能的详细信息可以在被发现Qt SQL driver文档。

See also hasFeature（ ） 。

QSqlDriver.IdentifierType

此枚举包含的SQL标识符类型的列表。

QSqlDriver.StatementType

此枚举包含SQL语句（或语句）的列表类型的驱动程序可以创建。

See also sqlStatement（ ） 。

Method Documentation

QSqlDriver.__init__ (self, QObject parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个新的驱动程序给定的parent。

bool QSqlDriver.beginTransaction (self)

这个函数被调用来开始一个事务。如果成功，则返回True，否则返回False 。默认实现不执行任何操作并返回False 。

See also commitTransaction（）和rollbackTransaction（ ） 。

QSqlDriver.close (self)

这种方法是抽象的，应在任何子类中重新实现。

派生类必须以关闭数据库连接重新实现这个纯虚函数。返回成功，假的真失败。

See also open（）和setOpen（ ） 。

bool QSqlDriver.commitTransaction (self)

这个函数被调用来提交事务。如果成功，则返回True，否则返回False 。默认实现不执行任何操作并返回False 。

See also beginTransaction（）和rollbackTransaction（ ） 。

QSqlResult QSqlDriver.createResult (self)

[

这种方法是抽象的，应在任何子类中重新实现。

]($docs-qsqlresult.html)

创建数据库在一个空的SQL结果。派生类必须重新实现这个函数，并返回一个QSqlResult对象适合自己的数据库给调用者。

QString QSqlDriver.escapeIdentifier (self, QString identifier, IdentifierType type)

返回identifier根据数据库的规则逃过一劫。identifier可以是一个表名或字段名，依赖于type。

默认实现不执行任何操作。

See also isIdentifierEscaped（ ） 。

QString QSqlDriver.formatValue (self, QSqlField field, bool trimStrings = False)

返回的字符串表示形式field值的数据库。这被使用，例如，建设INSERT和UPDATE语句时。

缺省的实现返回格式化为根据以下规则的字符串的值：

• If field is character data, the value is returned enclosed in single quotation marks, which is appropriate for many SQL databases. Any embedded single-quote characters are escaped (replaced with two single-quote characters). If trimStrings is true (the default is false), all trailing whitespace is trimmed from the field.
• If field is date/time data, the value is formatted in ISO format and enclosed in single quotation marks. If the date/time data is invalid, “NULL” is returned.
• If field is bytearray data, and the driver can edit binary fields, the value is formatted as a hexadecimal string.
• For any other field type, toString() is called on its value and the result of this is returned.

See also QVariant.toString（ ） 。

QVariant QSqlDriver.handle (self)

返回低水平数据库句柄包裹在一个QVariant或无效的变体，如果没有手柄。

Warning:使用这种具有极处的照顾和只有当你知道你在做什么。

Warning:这里返回的句柄可以成为一个过时的指针，如果连接被修改（例如，如果您关闭了连接） 。

Warning:手柄可以是NULL如果连接尚未打开。

这里返回的句柄是依赖于数据库的，你应该访问它之前，查询变量的类型名称。

本示例检索句柄到sqlite的连接：

 [QSqlDatabase]($docs-qsqldatabase.html) db = ...;
 [QVariant]($docs-qvariant.html) v = db.driver()->handle();
 if (v.isValid() && qstrcmp(v.typeName(), "sqlite3*") == 0) {
     // v.data() returns a pointer to the handle
     sqlite3 *handle = *static_cast<sqlite3 **>(v.data());
     if (handle != 0) { // check that it is not NULL
         ...
     }
 }

这段代码返回的句柄PostgreSQL或MySQL ：

 if (qstrcmp(v.typeName(), "PGconn*") == 0) {
     PGconn *handle = *static_cast<PGconn **>(v.data());
     if (handle != 0) ...
 }
 if (qstrcmp(v.typeName(), "MYSQL*") == 0) {
     MYSQL *handle = *static_cast<MYSQL **>(v.data());
     if (handle != 0) ...
 }

See also QSqlResult.handle（ ） 。

bool QSqlDriver.hasFeature (self, DriverFeature f)

这种方法是抽象的，应在任何子类中重新实现。

如果驱动程序支持功能，则返回Truefeature否则返回False 。

请注意，某些数据库需open（ ）在此之前才能确定。

See also DriverFeature。

bool QSqlDriver.isIdentifierEscaped (self, QString identifier, IdentifierType type)

返回是否identifier根据该数据库的规则逃脱。identifier可以是一个表名或字段名，依赖于type。

Warning:因为二进制兼容性的限制，这个功能是不是虚拟的。如果你想提供自己的实现在你的QSqlDriver子类，重新实现isIdentifierEscapedImplementation（）槽在你的子类来代替。该isIdentifierEscapedFunction （ ）会动态侦测插槽，并调用它。

See also stripDelimiters（）和escapeIdentifier（ ） 。

bool QSqlDriver.isIdentifierEscapedImplementation (self, QString identifier, IdentifierType type)

这种方法也是一个Qt槽与C + +的签名bool isIdentifierEscapedImplementation(const QString&,QSqlDriver::IdentifierType) const。

此插槽是否返回identifier根据该数据库的规则逃脱。identifier可以是一个表名或字段名，依赖于type。

因为二进制兼容性的限制，isIdentifierEscaped（ ）函数（在Qt的4.5中引入）是不是虚拟的。相反，isIdentifierEscaped（ ）将动态检测并调用this插槽。默认实现假设转义/分隔符是双引号。重新实现这个插槽在自己的QSqlDriver如果您的数据库引擎使用不同的分隔符。

此功能被引入Qt的4.6 。

See also isIdentifierEscaped（ ） 。

bool QSqlDriver.isOpen (self)

返回True如果数据库连接处于打开状态，否则返回False 。

bool QSqlDriver.isOpenError (self)

返回True如果有一个错误打开数据库连接，否则返回False 。

QSqlError QSqlDriver.lastError (self)

返回QSqlError对象，该对象包含有关数据库上发生的最后一个错误信息。

See also setLastError（ ） 。

QSql.NumericalPrecisionPolicy QSqlDriver.numericalPrecisionPolicy (self)

[

返回数据库连接的当前默认精度的政策。

此功能被引入Qt的4.6 。

]($docs-qsql.html#NumericalPrecisionPolicy-enum)

See also QSql.NumericalPrecisionPolicy，setNumericalPrecisionPolicy（ ）QSqlQuery.numericalPrecisionPolicy（）和QSqlQuery.setNumericalPrecisionPolicy（ ） 。

bool QSqlDriver.open (self, QString db, QString user = QString(), QString password = QString(), QString host = QString(), int port = -1, QString options = QString())

这种方法是抽象的，应在任何子类中重新实现。

派生类必须重新实现这个纯虚函数打开的数据库的数据库连接db，使用的用户名user，密码password，主机host，端口port和连接选项options。

该函数必须返回成功，假的真失败。

See also setOpen（ ） 。

QSqlIndex QSqlDriver.primaryIndex (self, QString tableName)

返回表的主索引tableName。返回一个空QSqlIndex如果表没有主索引。默认实现返回一个空的索引。

QSqlRecord QSqlDriver.record (self, QString tableName)

返回QSqlRecord填充在表中的字段的名称tableName。如果没有这样的表存在，则返回一个空的记录。默认实现返回一个空的记录。

bool QSqlDriver.rollbackTransaction (self)

这个函数被调用来回滚事务。如果成功，则返回True，否则返回False 。默认实现不执行任何操作并返回False 。

See also beginTransaction（）和commitTransaction（ ） 。

QSqlDriver.setLastError (self, QSqlError e)

这个函数是用来设置的最后一个错误的值，error，发生在数据库上。

See also lastError（ ） 。

QSqlDriver.setNumericalPrecisionPolicy (self, QSql.NumericalPrecisionPolicy precisionPolicy)

设置使用此驱动程序来创建查询的默认数值精度的政策precisionPolicy。

注意：默认精度策略设置来precisionPolicy不影响任何当前活动的查询。

此功能被引入Qt的4.6 。

See also QSql.NumericalPrecisionPolicy，numericalPrecisionPolicy（ ）QSqlQuery.setNumericalPrecisionPolicy（）和QSqlQuery.numericalPrecisionPolicy（ ） 。

QSqlDriver.setOpen (self, bool o)

这个函数设置数据库的打开状态以open。派生类可以使用此功能来报告的状态open（ ） 。

See also open（）和setOpenError（ ） 。

QSqlDriver.setOpenError (self, bool e)

这个函数设置数据库的打开错误状态error。派生类可以使用此功能来报告的状态open（ ） 。注意，如果error是真正的数据库的打开状态设置为关闭（即，isOpen（ ）返回False ） 。

See also isOpenError（ ）open（）和setOpen（ ） 。

QString QSqlDriver.sqlStatement (self, StatementType type, QString tableName, QSqlRecord rec, bool preparedStatement)

返回类型的SQL语句type为表tableName从数值rec。如果preparedStatement为True，则字符串将包含佔位符，而不是价值。

这种方法可以用来处理表，而不必担心依赖于数据库的SQL方言。对于非预处理语句，该值将被正确地转义。

QString QSqlDriver.stripDelimiters (self, QString identifier, IdentifierType type)

返回identifier带的前缘和后分隔符取出，identifier可以是一个表名或字段名，依赖于type。如果identifier没有开头和结尾的分隔符，identifier无需修改被返回。

Warning:因为二进制兼容性的限制，这个功能是不是虚拟的，如果你想提供自己的实现在你的QSqlDriver子类，重新实现stripDelimitersImplementation（）槽在你的子类来代替。该stripDelimiters （ ）函数将动态检测插槽，并调用它。

此功能被引入Qt的4.5 。

See also isIdentifierEscaped（ ） 。

QString QSqlDriver.stripDelimitersImplementation (self, QString identifier, IdentifierType type)

这种方法也是一个Qt槽与C + +的签名QString stripDelimitersImplementation(const QString&,QSqlDriver::IdentifierType) const。

这个插槽回报identifier带的前缘和后分隔符取出，identifier可以是一个表名或字段名，依赖于type。如果identifier没有开头和结尾的分隔符，identifier无需修改被返回。

因为二进制兼容性的限制，在stripDelimiters（ ）函数（在Qt的4.5中引入）是不是虚拟的。相反，stripDelimiters（ ）将动态检测并调用this插槽。它通常不需要重新实现此插槽。

此功能被引入Qt的4.6 。

See also stripDelimiters（ ） 。

QStringList QSqlDriver.subscribedToNotifications (self)

返回当前订阅的事件通知的名称列表。

Warning:因为二进制兼容性的限制，这个功能是不是虚拟的。如果您想提供事件通知的支持在自己的QSqlDriver子类，重新实现subscribedToNotificationsImplementation（）槽在你的子类来代替。该subscribedToNotifications （ ）函数将动态检测插槽，并调用它。

此功能被引入Qt的4.4 。

See also subscribeToNotification（）和unsubscribeFromNotification（ ） 。

QStringList QSqlDriver.subscribedToNotificationsImplementation (self)

这种方法也是一个Qt槽与C + +的签名QStringList subscribedToNotificationsImplementation() const。

返回当前订阅的事件通知的名称列表。

重新实现这个插槽来提供自己的QSqlDriver继承与事件通知的支持，因为二进制兼容性的限制，subscribedToNotifications（ ）函数（在Qt的4.4中引入）是不是虚拟的。相反，subscribedToNotifications（ ）将动态检测并调用this插槽。默认实现返回一个空QStringList。

此功能被引入Qt的4.4 。

See also subscribedToNotifications（ ） 。

bool QSqlDriver.subscribeToNotification (self, QString name)

调用此函数来订阅事件通知从数据库中。name标识事件的通知。

如果成功，则返回True，否则返回False 。

该数据库必须处于打开状态时，此函数被调用。当数据库是通过调用关闭close（ ）所有订阅事件通知将自动取消订阅。请注意，调用open（ ）在一个已经打开的数据库可能会导致隐close（ ）被调用，这将导致驱动程序的所有事件通知退订。

当一个事件通知确定name张贴由数据库的notification（）信号被发射。

Warning:因为二进制兼容性的限制，这个功能是不是虚拟的。如果您想提供事件通知的支持在自己的QSqlDriver子类，重新实现subscribeToNotificationImplementation（）槽在你的子类来代替。该subscribeToNotification （ ）函数将动态检测插槽，并调用它。

此功能被引入Qt的4.4 。

See also unsubscribeFromNotification（ ）subscribedToNotifications（）和QSqlDriver.hasFeature（ ） 。

bool QSqlDriver.subscribeToNotificationImplementation (self, QString name)

这种方法也是一个Qt槽与C + +的签名bool subscribeToNotificationImplementation(const QString&)。

这个槽被调用来订阅事件通知从数据库中。name标识事件的通知。

如果成功，则返回True，否则返回False 。

该数据库必须在此公开slot被调用。当数据库是通过调用关闭close（ ）所有订阅事件通知将自动取消订阅。请注意，调用open（ ）在一个已经打开的数据库可能会导致隐close（ ）被调用，这将导致驱动程序的所有事件通知退订。

当一个事件通知确定name张贴由数据库的notification（）信号被发射。

重新实现这个插槽来提供自己的QSqlDriver继承与事件通知的支持，因为二进制兼容性的限制，subscribeToNotification（ ）函数（在Qt的4.4中引入）是不是虚拟的。相反，subscribeToNotification（ ）将动态检测并调用this插槽。默认实现不执行任何操作并返回False 。

此功能被引入Qt的4.4 。

See also subscribeToNotification（ ） 。

QStringList QSqlDriver.tables (self, QSql.TableType tableType)

返回该数据库中的表的名称的列表。默认实现返回一个空列表。

该tableType参数说明什么类型的表应该返回。由于二进制兼容性，该字符串包含枚举QSql.TableTypes作为文本的价值。一个空字符串应被视为QSql.Tables为了向后兼容。

bool QSqlDriver.unsubscribeFromNotification (self, QString name)

此功能称为从数据库事件通知退订。name标识事件的通知。

如果成功，则返回True，否则返回False 。

该数据库必须处于打开状态时，此函数被调用。所有订阅的事件通知是从时自动取消订阅的close（ ）函数被调用。

后调用this功能notification（）信号将不再当一个事件通知确定了发射name张贴由数据库。

Warning:因为二进制兼容性的限制，这个功能是不是虚拟的。如果您想提供事件通知的支持在自己的QSqlDriver子类，重新实现unsubscribeFromNotificationImplementation（）槽在你的子类来代替。该unsubscribeFromNotification （ ）函数将动态检测插槽，并调用它。

此功能被引入Qt的4.4 。

See also subscribeToNotification（）和subscribedToNotifications（ ） 。

bool QSqlDriver.unsubscribeFromNotificationImplementation (self, QString name)

这种方法也是一个Qt槽与C + +的签名bool unsubscribeFromNotificationImplementation(const QString&)。

这个槽被调用从数据库事件通知退订。name标识事件的通知。

如果成功，则返回True，否则返回False 。

该数据库时，必须打开this槽被调用。所有订阅的事件通知是从时自动取消订阅的close（ ）函数被调用。

后调用this在插槽notification（）信号将不再当一个事件通知确定了发射name张贴由数据库。

重新实现这个插槽来提供自己的QSqlDriver继承与事件通知的支持，因为二进制兼容性的限制，unsubscribeFromNotification（ ）函数（在Qt的4.4中引入）是不是虚拟的。相反，unsubscribeFromNotification（ ）将动态检测并调用this插槽。默认实现不执行任何操作并返回False 。

此功能被引入Qt的4.4 。

See also unsubscribeFromNotification（ ） 。

Qt Signal Documentation

void notification (const QString&)

这是该信号的默认超载。

这个信号被发射时的数据库职位为驾驶员所预订的事件通知。name标识事件的通知。

此功能被引入Qt的4.4 。

See also subscribeToNotification（ ） 。