PySide6.QtSql.QSqlError

class QSqlError

The QSqlError class provides SQL database error information.

Details

A QSqlError object can provide database-specific error data, including the driverText() and databaseText() messages (or both concatenated together as text() ), and the nativeErrorCode() and type() .

Synopsis

Methods

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

class ErrorType

This enum type describes the context in which the error occurred, e.g., a connection error, a statement error, etc.

Constant

Description

QSqlError.ErrorType.NoError

No error occurred.

QSqlError.ErrorType.ConnectionError

Connection error.

QSqlError.ErrorType.StatementError

SQL statement syntax error.

QSqlError.ErrorType.TransactionError

Transaction failed error.

QSqlError.ErrorType.UnknownError

Unknown error.
__init__(other)
Parameters:

other – QSqlError

Creates a copy of other.

__init__([driverText=""[, databaseText=""[, type=QSqlError.ErrorType.NoError[, nativeErrorCode=""]]]])
Parameters:

  • driverText – str

  • databaseText – str

  • type – ErrorType

  • nativeErrorCode – str

Constructs an error containing the driver error text driverText, the database-specific error text databaseText, the type type and the native error code nativeErrorCode.

databaseText()
Return type:

str

Returns the text of the error as reported by the database. This may contain database-specific descriptions; it may be empty.

See also

driverText() text()

driverText()
Return type:

str

Returns the text of the error as reported by the driver. This may contain database-specific descriptions. It may also be empty.

isValid()
Return type:

bool

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

Returns true if an error is set, otherwise false.

Example:

model = QSqlQueryModel()
model.setQuery("select * from myTable")
if model.lastError().isValid():
    print(model.lastError())

See also

type()

nativeErrorCode()
Return type:

str

Returns the database-specific (native) error code, or an empty string if it cannot be determined.

Note

Some drivers (like DB2 or ODBC) may return more than one error code. When this happens, ; is used as separator between the error codes.

__ne__(other)
Parameters:

other – QSqlError

Return type:

bool

Compare the other error’s type() and nativeErrorCode() to this error and returns true if it is not equal.

__eq__(other)
Parameters:

other – QSqlError

Return type:

bool

Compare the other error’s type() and nativeErrorCode() to this error and returns true, if it equal.

swap(other)
Parameters:

other – QSqlError

Swaps this error with other. This operation is very fast and never fails.

text()
Return type:

str

This is a convenience function that returns databaseText() and driverText() concatenated into a single string.

type()
Return type:

ErrorType

Returns the error type, or -1 if the type cannot be determined.