En esta página

QSqlDatabase Class

La clase QSqlDatabase gestiona la conexión a una base de datos. Más información...

Encabezado: #include <QSqlDatabase>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sql)
target_link_libraries(mytarget PRIVATE Qt6::Sql)
qmake: QT += sql
Heredado de: QSqlDatabaseDefaultConnectionName

Propiedades

Funciones públicas

QSqlDatabase()
QSqlDatabase(const QSqlDatabase &other)
~QSqlDatabase()
void close()
bool commit()
QString connectOptions() const
QString connectionName() const
QString databaseName() const
QSqlDriver *driver() const
QString driverName() const
QString hostName() const
bool isOpen() const
bool isOpenError() const
bool isValid() const
QSqlError lastError() const
(since 6.8) bool moveToThread(QThread *targetThread)
QSql::NumericalPrecisionPolicy numericalPrecisionPolicy() const
bool open()
bool open(const QString &user, const QString &password)
QString password() const
int port() const
QSqlIndex primaryIndex(const QString &tablename) const
QSqlRecord record(const QString &tablename) const
bool rollback()
void setConnectOptions(const QString &options = QString())
void setDatabaseName(const QString &name)
void setHostName(const QString &host)
void setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)
void setPassword(const QString &password)
void setPort(int port)
void setUserName(const QString &name)
QStringList tables(QSql::TableType type = QSql::Tables) const
(since 6.8) QThread *thread() const
bool transaction()
QString userName() const
QSqlDatabase &operator=(const QSqlDatabase &other)

Miembros públicos estáticos

QSqlDatabase addDatabase(const QString &type, const QString &connectionName = defaultConnectionName())
QSqlDatabase addDatabase(QSqlDriver *driver, const QString &connectionName = defaultConnectionName())
QSqlDatabase cloneDatabase(const QSqlDatabase &other, const QString &connectionName)
QSqlDatabase cloneDatabase(const QString &other, const QString &connectionName)
QStringList connectionNames()
bool contains(const QString &connectionName = defaultConnectionName())
QSqlDatabase database(const QString &connectionName = defaultConnectionName(), bool open = true)
QStringList drivers()
bool isDriverAvailable(const QString &name)
void registerSqlDriver(const QString &name, QSqlDriverCreatorBase *creator)
void removeDatabase(const QString &connectionName)

Funciones protegidas

QSqlDatabase(QSqlDriver *driver)
QSqlDatabase(const QString &type)

Descripción detallada

La clase QSqlDatabase proporciona una interfaz para acceder a una base de datos a través de una conexión. Una instancia de QSqlDatabase representa la conexión. La conexión proporciona acceso a la base de datos a través de uno de los controladores de base de datos compatibles, que derivan de QSqlDriver. Como alternativa, puedes crear una subclase de tu propio controlador de base de datos a partir de QSqlDriver. Consulta «Cómo escribir tu propio controlador de base de datos » para obtener más información. Solo debe acceder a una instancia de QSqlDatabase el hilo en el que se creó. Por lo tanto, debes asegurarte de crearlas en el contexto correcto. También puedes cambiar el contexto con QSqlDatabase::moveToThread().

Crea una conexión (es decir, una instancia de `QSqlDatabase`) llamando a una de las funciones estáticas ` addDatabase()`, en las que se especifica el controlador o el tipo de controlador que se va a utilizar (dependiendo del tipo de base de datos) y un nombre de conexión. Una conexión se identifica por su propio nombre, no por el nombre de la base de datos a la que se conecta. Se pueden tener varias conexiones a una misma base de datos. QSqlDatabase también admite el concepto de conexión por defecto, que es la conexión sin nombre. Para crear la conexión por defecto, no se debe pasar el argumento del nombre de conexión al llamar a addDatabase(). Posteriormente, se asumirá la conexión por defecto si se llama a cualquier función miembro estática sin especificar el nombre de la conexión. El siguiente fragmento de código muestra cómo crear y abrir una conexión predeterminada a una base de datos PostgreSQL:

    QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
    db.setHostName("acidalia");
    db.setDatabaseName("customdb");
    db.setUserName("mojito");
    db.setPassword("J0a1m8");
    bool ok = db.open();

Una vez creado el objeto `QSqlDatabase`, configura los parámetros de conexión con ` setDatabaseName()`, ` setUserName()`, ` setPassword()`, ` setHostName()`, ` setPort()` y ` setConnectOptions()`. A continuación, llama a ` open()` para activar la conexión física con la base de datos. La conexión no se puede utilizar hasta que la abras.

La conexión definida anteriormente será la conexión por defecto, ya que no hemos proporcionado un nombre de conexión a ` addDatabase()`. Posteriormente, puede obtener la conexión por defecto llamando a ` database()` sin el argumento del nombre de conexión:

    QSqlDatabase db = QSqlDatabase::database();

QSqlDatabase es una clase de valor. Los cambios realizados en una conexión a la base de datos a través de una instancia de QSqlDatabase afectarán a otras instancias de QSqlDatabase que representen la misma conexión. Utiliza cloneDatabase() para crear una conexión independiente a la base de datos basada en una ya existente.

Advertencia: Se recomienda encarecidamente no mantener una copia de QSqlDatabase como miembro de una clase, ya que esto impedirá que la instancia se libere correctamente al cerrar el programa. Si necesitas acceder a un `QSqlDatabase` existente, debes hacerlo mediante ` database()`. Si decides utilizar una variable miembro de tipo `QSqlDatabase`, esta debe eliminarse antes de que se elimine la instancia de ` QCoreApplication `; de lo contrario, podría dar lugar a un comportamiento indefinido.

Si crea varias conexiones a la base de datos, especifique un nombre de conexión único para cada una de ellas al llamar a ` addDatabase()`. Utilice ` database()` con un nombre de conexión para obtener dicha conexión. Utilice ` removeDatabase()` con un nombre de conexión para eliminar una conexión. QSqlDatabase muestra una advertencia si intentas eliminar una conexión a la que hacen referencia otros objetos QSqlDatabase. Utiliza contains() para comprobar si un nombre de conexión determinado se encuentra en la lista de conexiones.

Algunos métodos de utilidad:
tables()devuelve la lista de tablas
primaryIndex()devuelve el índice primario de una tabla
record()devuelve metainformación sobre los campos de una tabla
transaction()inicia una transacción
commit()guarda y completa una transacción
rollback()cancela una transacción
hasFeature()comprueba si un controlador admite transacciones
lastError()devuelve información sobre el último error
drivers()devuelve los nombres de los controladores SQL disponibles
isDriverAvailable()comprueba si un controlador concreto está disponible
registerSqlDriver()registra un controlador personalizado

Nota: Al utilizar transacciones, debes iniciar la transacción antes de crear la consulta.

Véase también QSqlDriver, QSqlQuery, Qt SQLy «Hilos y el módulo SQL».

Documentación de propiedades

[since 6.8] numericalPrecisionPolicy : QSql::NumericalPrecisionPolicy

Esta propiedad contiene la política de precisión numérica predeterminada que utilizan las consultas creadas en esta conexión a la base de datos.

Nota: Los controladores que no admiten la recuperación de valores numéricos con baja precisión ignorarán la política de precisión. Puedes utilizar QSqlDriver::hasFeature() para averiguar si un controlador admite esta característica.

Nota: Establecer la política de precisión predeterminada en ` precisionPolicy ` no afecta a ninguna consulta actualmente activa.

Esta enumeración se introdujo en Qt 6.8.

Funciones de acceso:

QSql::NumericalPrecisionPolicy numericalPrecisionPolicy() const
void setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)

Véase también QSql::NumericalPrecisionPolicy, QSqlQuery::numericalPrecisionPolicy y QSqlDriver::numericalPrecisionPolicy.

Documentación de las funciones miembro

QSqlDatabase::QSqlDatabase()

Crea un objeto QSqlDatabase vacío y no válido. Utiliza addDatabase(), removeDatabase() y database() para obtener objetos QSqlDatabase válidos.

[explicit protected] QSqlDatabase::QSqlDatabase(QSqlDriver *driver)

Crea una conexión a la base de datos utilizando el driver especificado.

Esta es una función sobrecargada.

[explicit protected] QSqlDatabase::QSqlDatabase(const QString &type)

Crea una conexión QSqlDatabase que utiliza el controlador al que hace referencia type. Si no se reconoce type, la conexión a la base de datos no funcionará.

Los tipos de controladores disponibles actualmente son:

Tipo de controladorDescripción
QDB2IBM DB2
QIBASEControlador Borland InterBase
QMYSQLControlador de MySQL
QOCIControlador de Oracle Call Interface
QODBCControlador ODBC (incluye Microsoft SQL Server)
QPSQLControlador de PostgreSQL
QSQLITESQLite versión 3 o superior
QMIMERMimer SQL 11 o superior

Se pueden cargar dinámicamente controladores adicionales de terceros, incluidos tus propios controladores personalizados.

Esta es una función sobrecargada.

Véase también «Controladores de bases de datos SQL», registerSqlDriver() y drivers().

QSqlDatabase::QSqlDatabase(const QSqlDatabase &other)

Crea una copia de other.

[noexcept] QSqlDatabase::~QSqlDatabase()

Destruye el objeto y libera todos los recursos asignados.

Nota: Cuando se destruye la última conexión, el destructor llama implícitamente a close() para liberar la conexión a la base de datos.

Véase también close().

[static] QSqlDatabase QSqlDatabase::addDatabase(const QString &type, const QString &connectionName = defaultConnectionName())

Añade una base de datos a la lista de conexiones a bases de datos utilizando el controlador type y el nombre de conexión connectionName. Si ya existe una conexión a la base de datos denominada connectionName, dicha conexión se elimina.

La conexión a la base de datos se identifica mediante connectionName. Se devuelve la conexión a la base de datos recién añadida.

Si type no está disponible o no se ha podido cargar, isValid() devuelve false.

Si no se especifica ` connectionName `, la nueva conexión se convierte en la conexión predeterminada para la aplicación, y las llamadas posteriores a ` database()` sin el argumento del nombre de la conexión devolverán la conexión predeterminada. Si se proporciona aquí un ` connectionName `, utilice `database(connectionName)` para recuperar la conexión.

Advertencia: Si se añade una conexión con el mismo nombre que una conexión ya existente, la nueva conexión sustituirá a la anterior. Si se llama a esta función más de una vez sin especificar connectionName, la conexión predeterminada será la que haya sido sustituida.

Antes de utilizar la conexión, es necesario inicializarla. Por ejemplo, llama a algunas o a todas las siguientes funciones: setDatabaseName(), setUserName(), setPassword(), setHostName(), setPort() y setConnectOptions(), y, por último, open().

Nota: Esta función es segura para subprocesos.

Véase también database(), removeDatabase() y «Hilos y el módulo SQL».

[static] QSqlDatabase QSqlDatabase::addDatabase(QSqlDriver *driver, const QString &connectionName = defaultConnectionName())

Esta sobrecarga resulta útil cuando se desea establecer una conexión con una base de datos mediante un ` driver ` que hayas instanciado tú mismo. Puede tratarse de tu propio controlador de base de datos, o quizá simplemente necesites instanciar uno de los controladores de Qt por tu cuenta. Si lo haces, se recomienda que incluyas el código del controlador en tu aplicación. Por ejemplo, puedes crear una conexión a PostgreSQL con tu propio controlador QPSQL de la siguiente manera:

PGconn *con = PQconnectdb("host=server user=bart password=simpson dbname=springfield");
QPSQLDriver *drv = new QPSQLDriver(con);
QSqlDatabase db = QSqlDatabase::addDatabase(drv); // becomes the new default connection
QSqlQuery query;
query.exec("SELECT NAME, ID FROM STAFF");

El código anterior establece una conexión con PostgreSQL e instancia un objeto `QPSQLDriver`. A continuación, se llama a addDatabase() para añadir la conexión a las conexiones conocidas, de modo que pueda ser utilizada por las clases de Qt SQL. Cuando se instancia un controlador con un identificador de conexión (o un conjunto de identificadores), Qt da por hecho que ya has abierto la conexión a la base de datos.

Nota: Suponemos que qtdir es el directorio donde está instalado Qt. Esto incorporará el código necesario para utilizar la biblioteca cliente de PostgreSQL y para instanciar un objeto QPSQLDriver, siempre que tengas los encabezados de PostgreSQL en algún lugar de tu ruta de búsqueda de archivos «include».

Recuerda que debes enlazar tu aplicación con la biblioteca cliente de la base de datos. Asegúrate de que la biblioteca cliente se encuentre en la ruta de búsqueda de tu enlazador y añade líneas como estas a tu archivo .pro:

unix:LIBS += -lpq
win32:LIBS += libpqdll.lib

El método descrito funciona para todos los controladores suministrados. La única diferencia estará en los argumentos del constructor del controlador. A continuación se muestra una tabla con los controladores incluidos en Qt, sus archivos de código fuente y los argumentos de sus constructores:

ControladorNombre de la claseArgumentos del constructorArchivo que hay que incluir
QPSQLQPSQLDriverPGconn *conexiónqsql_psql.cpp
QMYSQLQMYSQLDriverMYSQL *conexiónqsql_mysql.cpp
QOCIQOCIDriverOCIEnv *entorno, OCISvcCtx *contexto de servicioqsql_oci.cpp
QODBCQODBCDriverentorno SQLHANDLE, conexión SQLHANDLEqsql_odbc.cpp
QDB2QDB2Entorno SQLHANDLE, conexión SQLHANDLEqsql_db2.cpp
QSQLITEQSQLiteDriverConexión *sqliteqsql_sqlite.cpp
QMIMERQMimerSQLDriverMimerSession *conexiónqsql_mimer.cpp
QIBASEQIBaseDriverisc_db_handle conexiónqsql_ibase.cpp

Advertencia: Si se añade una conexión a la base de datos con el mismo nombre que una conexión ya existente, la conexión existente quedará sustituida por la nueva.

Advertencia: El marco SQL toma el control de ` driver`. No debe eliminarse. Para eliminar la conexión, utiliza ` removeDatabase()`.

Esta es una función sobrecargada.

Véase también drivers().

[static] QSqlDatabase QSqlDatabase::cloneDatabase(const QSqlDatabase &other, const QString &connectionName)

Clona la conexión a la base de datos other y la almacena como connectionName. Se copian todos los ajustes de la base de datos original, por ejemplo, databaseName(), hostName(), etc. No realiza ninguna acción si other es una base de datos no válida. Devuelve la conexión a la base de datos recién creada.

Nota: La nueva conexión aún no se ha abierto. Antes de utilizar la nueva conexión, debes llamar a open().

Nota: Esta función es reentrante.

[static] QSqlDatabase QSqlDatabase::cloneDatabase(const QString &other, const QString &connectionName)

Clona la conexión a la base de datos other y la almacena como connectionName. Se copian todos los ajustes de la base de datos original, por ejemplo, databaseName(), hostName(), etc. No realiza ninguna acción si other es una base de datos no válida. Devuelve la conexión a la base de datos recién creada.

Nota: La nueva conexión aún no se ha abierto. Antes de utilizar la nueva conexión, debes llamar a open().

Esta sobrecarga resulta útil al clonar la base de datos en un hilo distinto al utilizado por la base de datos representada por other.

Esta es una función sobrecargada.

void QSqlDatabase::close()

Cierra la conexión a la base de datos, liberando los recursos adquiridos e invalidando cualquier objeto ` QSqlQuery ` existente que se utilice con la base de datos.

Esto también afectará a las copias de este objeto ` QSqlDatabase `.

Véase también removeDatabase().

bool QSqlDatabase::commit()

Confirma una transacción en la base de datos si el controlador admite transacciones y se ha iniciado una operación de « transaction()». Devuelve « true » si la operación se ha realizado correctamente. En caso contrario, devuelve « false ».

Nota: En algunas bases de datos, la confirmación fallará y devolverá ` false ` si hay un ` active query ` utilizando la base de datos para un ` SELECT`. Realiza la consulta ` inactive ` antes de llevar a cabo la confirmación.

Llama a ` lastError()` para obtener información sobre los errores.

Véase también QSqlQuery::isActive(), QSqlDriver::hasFeature() y rollback().

QString QSqlDatabase::connectOptions() const

Devuelve la cadena de opciones de conexión utilizada para esta conexión. La cadena puede estar vacía.

Véase también setConnectOptions().

QString QSqlDatabase::connectionName() const

Devuelve el nombre de la conexión, que puede estar vacío.

Nota: El nombre de la conexión no es el database name.

Véase también addDatabase().

[static] QStringList QSqlDatabase::connectionNames()

Devuelve una lista con los nombres de todas las conexiones.

Nota: Esta función es segura para subprocesos.

Véase también contains(), database() y «Hilos y el módulo SQL».

[static] bool QSqlDatabase::contains(const QString &connectionName = defaultConnectionName())

Devuelve ` true ` si la lista de conexiones a la base de datos contiene ` connectionName`; en caso contrario, devuelve ` false`.

Nota: Esta función es segura para subprocesos.

Véase también connectionNames(), database() y «Hilos y el módulo SQL».

[static] QSqlDatabase QSqlDatabase::database(const QString &connectionName = defaultConnectionName(), bool open = true)

Devuelve la conexión a la base de datos denominada « connectionName ». La conexión a la base de datos debe haberse añadido previamente mediante « addDatabase()». Si « open » es «true» (valor por defecto) y la conexión a la base de datos aún no está abierta, se abre en ese momento. Si no se especifica « connectionName », se utiliza la conexión por defecto. Si « connectionName » no existe en la lista de bases de datos, se devuelve una conexión no válida.

Nota: Esta función es segura para subprocesos.

Véase también ` isOpen()` y «Hilos y el módulo SQL».

QString QSqlDatabase::databaseName() const

Devuelve el nombre de la base de datos de la conexión, que puede estar vacío.

Nota: El nombre de la base de datos no es el mismo que el nombre de la conexión.

Véase también setDatabaseName().

QSqlDriver *QSqlDatabase::driver() const

Devuelve el controlador de base de datos utilizado para acceder a la conexión a la base de datos.

Véase también addDatabase() y drivers().

QString QSqlDatabase::driverName() const

Devuelve el nombre del controlador de la conexión.

Véase también addDatabase() y driver().

[static] QStringList QSqlDatabase::drivers()

Devuelve una lista de todos los controladores de bases de datos disponibles.

Véase también registerSqlDriver().

QString QSqlDatabase::hostName() const

Devuelve el nombre de host de la conexión; puede estar vacío.

Véase también setHostName().

[static] bool QSqlDatabase::isDriverAvailable(const QString &name)

Devuelve « true » si hay disponible un controlador llamado « name »; en caso contrario, devuelve « false ».

Véase también drivers().

bool QSqlDatabase::isOpen() const

Devuelve ` true ` si la conexión a la base de datos está abierta en ese momento; en caso contrario, devuelve ` false`.

bool QSqlDatabase::isOpenError() const

Devuelve ` true ` si se ha producido un error al abrir la conexión a la base de datos; en caso contrario, devuelve ` false`. La información sobre el error se puede obtener mediante la función ` lastError()`.

bool QSqlDatabase::isValid() const

Devuelve « true » si el objeto « QSqlDatabase » dispone de un controlador válido.

Ejemplo:

QSqlDatabase db;
qDebug() << db.isValid();    // Returns false

db = QSqlDatabase::base de datos("ventas");
qDebug() << db.isValid();    // Returns \c true if "sales" connection exists

QSqlDatabase::removeDatabase("sales");
qDebug() << db.isValid();    // Returns false

QSqlError QSqlDatabase::lastError() const

Devuelve información sobre el último error que se ha producido en la base de datos.

Los errores que se producen en relación con una consulta concreta se notifican mediante la función ` QSqlQuery::lastError()`.

Véanse también QSqlError y QSqlQuery::lastError().

[since 6.8] bool QSqlDatabase::moveToThread(QThread *targetThread)

Modifica la afinidad de subproceso de QSqlDatabase y su controlador asociado. Esta función devuelve true cuando la operación se realiza correctamente. El procesamiento de eventos continuará en targetThread.

Durante esta operación, debe asegurarse de que no haya ningún ` QSqlQuery ` vinculado a esta instancia; de lo contrario, el ` QSqlDatabase ` no se trasladará al hilo indicado y la función devolverá ` false`.

Dado que el controlador asociado deriva de ` QObject`, todas las restricciones para trasladar un ` QObject ` a otro hilo también se aplican a esta función.

Esta función se introdujo en Qt 6.8.

Véase también ` QObject::moveToThread()` y «Hilos y el módulo SQL».

QSql::NumericalPrecisionPolicy QSqlDatabase::numericalPrecisionPolicy() const

Devuelve la propiedad `numericalPrecisionPolicy`.

Nota: Funcióngetter para la propiedad «numericalPrecisionPolicy».

Véase también ` setNumericalPrecisionPolicy()`.

bool QSqlDatabase::open()

Abre la conexión a la base de datos utilizando los valores de conexión actuales. Devuelve ` true ` si se realiza correctamente; en caso contrario, devuelve ` false`. La información sobre el error se puede obtener mediante ` lastError()`.

Véanse también lastError(), setDatabaseName(), setUserName(), setPassword(), setHostName(), setPort() y setConnectOptions().

bool QSqlDatabase::open(const QString &user, const QString &password)

Abre la conexión a la base de datos utilizando el nombre « user » y « password » indicados. Devuelve « true » si la operación se realiza correctamente; en caso contrario, devuelve « false ». La información sobre el error se puede obtener mediante la función « lastError()».

Esta función no almacena la contraseña que se le proporciona. En su lugar, la contraseña se pasa directamente al controlador para abrir la conexión y, a continuación, se descarta.

Esta es una función sobrecargada.

Véase también lastError().

QString QSqlDatabase::password() const

Devuelve la contraseña de la conexión. Se devolverá una cadena vacía si la contraseña no se ha establecido con ` setPassword()` y si se ha especificado la contraseña en la llamada a ` open()`, o si no se ha utilizado ninguna contraseña.

Véase también setPassword().

int QSqlDatabase::port() const

Devuelve el número de puerto de la conexión. El valor es indefinido si no se ha establecido el número de puerto.

Véase también ` setPort()`.

QSqlIndex QSqlDatabase::primaryIndex(const QString &tablename) const

Devuelve el índice primario de la tabla tablename. Si no existe ningún índice primario, se devuelve un objeto QSqlIndex vacío.

Nota: Algunos controladores, como el controlador QPSQL, pueden requerir que se pase ` tablename ` en minúsculas si la tabla no se puso entre comillas al crearla. Consulte la documentación del controlador `Qt SQL ` para obtener más información.

Véase también tables() y record().

QSqlRecord QSqlDatabase::record(const QString &tablename) const

Devuelve un objeto ` QSqlRecord ` que contiene los nombres de todos los campos de la tabla (o vista) denominada ` tablename`. El orden en el que aparecen los campos en el registro no está definido. Si no existe dicha tabla (o vista), se devuelve un registro vacío.

Nota: Algunos controladores, como el controlador QPSQL, pueden requerir que se pase ` tablename ` en minúsculas si la tabla no se escribió entre comillas al crearla. Consulte la documentación del controlador `Qt SQL ` para obtener más información.

[static] void QSqlDatabase::registerSqlDriver(const QString &name, QSqlDriverCreatorBase *creator)

Esta función registra un nuevo controlador SQL llamado « name » dentro del marco de trabajo de SQL. Esto resulta útil si dispones de un controlador SQL personalizado y no deseas compilarlo como un complemento.

Ejemplo:

QSqlDatabase::registerSqlDriver("MYDRIVER", new QSqlDriverCreator<QSqlDriver>);
QVERIFY(QSqlDatabase::drivers().contains("MYDRIVER"));
QSqlDatabase db = QSqlDatabase::addDatabase("MYDRIVER");
QVERIFY(db.isValid());

QSqlDatabase asume la propiedad del puntero ` creator `, por lo que no debes borrarlo tú mismo.

Véase también drivers().

[static] void QSqlDatabase::removeDatabase(const QString &connectionName)

Elimina la conexión a la base de datos connectionName de la lista de conexiones a bases de datos.

Advertencia: No debehaber ninguna consulta abierta en la conexión a la base de datos cuando se llame a esta función; de lo contrario, se producirá una fuga de recursos.

Ejemplo:

// WRONG
QSqlDatabase db = QSqlDatabase::database("sales");
QSqlQuery query("SELECT NAME, DOB FROM EMPLOYEES", db);
QSqlDatabase::removeDatabase("sales"); // will output a warning
// "db" is now a dangling invalid database connection,
// "query" contains an invalid result set

La forma correcta de hacerlo:

{
    QSqlDatabase db = QSqlDatabase::database("sales");
    QSqlQuery query("SELECT NAME, DOB FROM EMPLOYEES", db);
}
// Both "db" and "query" are destroyed because they are out of scope
QSqlDatabase::removeDatabase("sales"); // correct

Para eliminar la conexión predeterminada, que puede haberse creado mediante una llamada a ` addDatabase()` sin especificar un nombre de conexión, puedes recuperar el nombre de la conexión predeterminada llamando a ` connectionName()` sobre la base de datos devuelta por ` database()`. Ten en cuenta que, si no se ha creado una base de datos predeterminada, se devolverá una base de datos no válida.

Nota: Esta función es segura para subprocesos.

Véase también database(), connectionName() y «Hilos y el módulo SQL».

bool QSqlDatabase::rollback()

Anula una transacción en la base de datos, siempre que el controlador admita transacciones y se haya iniciado una operación ` transaction()`. Devuelve ` true ` si la operación se ha realizado correctamente. En caso contrario, devuelve ` false`.

Nota: En algunas bases de datos, la anulación fallará y devolverá ` false ` si hay una consulta ` active query ` que esté utilizando la base de datos para una consulta ` SELECT`. Asegúrate de que la consulta ` inactive ` antes de realizar la anulación.

Llama a lastError() para obtener información sobre los errores.

Véase también QSqlQuery::isActive(), QSqlDriver::hasFeature() y commit().

void QSqlDatabase::setConnectOptions(const QString &options = QString())

Establece las opciones de conexión específicas de la base de datos ( options). Esto debe hacerse antes de abrir la conexión; de lo contrario, no surtirá efecto. Otra posibilidad es cerrar la conexión, llamar a QSqlDatabase::setConnectOptions() y volver a abrir la conexión con open().

El formato de la cadena ` options ` es una lista, separada por punto y coma, de nombres de opciones o de pares «opción=valor». Las opciones dependen del cliente de base de datos utilizado y se describen para cada complemento en la página «Controladores de bases de datos SQL ».

Ejemplos:

db.setConnectOptions("SSL_KEY=client-key.pem;SSL_CERT=client-cert.pem;SSL_CA=ca-cert.pem;CLIENT_IGNORE_SPACE=1"); // use an SSL connection to the server
if (!db.open()) {
    db.setConnectOptions(); // clears the connect option string
    // ...
}
// ...
// PostgreSQL connection
db.setConnectOptions("requiressl=1"); // enable PostgreSQL SSL connections
if (!db.open()) {
    db.setConnectOptions(); // clear options
    // ...
}
// ...
// ODBC connection
db.setConnectOptions("SQL_ATTR_ACCESS_MODE=SQL_MODE_READ_ONLY;SQL_ATTR_TRACE=SQL_OPT_TRACE_ON"); // set ODBC options
if (!db.open()) {
    db.setConnectOptions(); // don't try to set this option
    // ...
}
}

Consulta la documentación de la biblioteca del cliente para obtener más información sobre las diferentes opciones.

Véase también ` connectOptions()`.

void QSqlDatabase::setDatabaseName(const QString &name)

Establece el nombre de la base de datos de la conexión como « name ». Para que surta efecto, el nombre de la base de datos debe establecerse antes de que la conexión sea « opened ». Como alternativa, puedes llamar a « close()» sobre la conexión, establecer el nombre de la base de datos y volver a llamar a « open()».

Nota: El nombre de la base de datos no es el nombre de la conexión. El nombre de la conexión debe pasarse a ` addDatabase()` en el momento de crear el objeto de conexión.

En el caso del controlador QSQLITE, si el nombre de la base de datos especificado no existe, se creará el archivo automáticamente, a menos que se haya establecido la opción `QSQLITE_OPEN_READONLY`.

Además, name puede establecerse en ":memory:", lo que creará una base de datos temporal que solo estará disponible mientras la aplicación esté en ejecución.

En el caso del controlador QOCI (Oracle), el nombre de la base de datos es el nombre del servicio TNS.

Para el controlador QODBC, el name puede ser un DSN, un nombre de archivo DSN (en cuyo caso el archivo debe tener la extensión .dsn ) o una cadena de conexión.

Por ejemplo, los usuarios de Microsoft Access pueden utilizar la siguiente cadena de conexión para abrir directamente un archivo « .mdb », en lugar de tener que crear una entrada DSN en el gestor ODBC:

// ...
QSqlDatabase db = QSqlDatabase::addDatabase("QODBC");
db.setDatabaseName("DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};FIL={MS Access};DBQ=myaccessfile.mdb");
if (db.open()) {
    // success!
}
// ...

No hay ningún valor por defecto.

Véase también databaseName(), setUserName(), setPassword(), setHostName(), setPort(), setConnectOptions() y open().

void QSqlDatabase::setHostName(const QString &host)

Establece el nombre de host de la conexión en host. Para que surta efecto, el nombre de host debe configurarse antes de que la conexión sea opened. Como alternativa, puedes llamar a ` close()` sobre la conexión, establecer el nombre de host y volver a llamar a ` open()`.

No hay ningún valor por defecto.

Véase también hostName(), setUserName(), setPassword(), setDatabaseName(), setPort(), setConnectOptions() y open().

void QSqlDatabase::setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)

Establece el valor de « numericalPrecisionPolicy » en « precisionPolicy ».

Nota: Funciónde asignación para la propiedad numericalPrecisionPolicy.

Véase también numericalPrecisionPolicy().

void QSqlDatabase::setPassword(const QString &password)

Establece la contraseña de la conexión en password. Para que surta efecto, la contraseña debe establecerse antes de que la conexión sea opened. Como alternativa, puedes llamar a close() sobre la conexión, establecer la contraseña y volver a llamar a open().

No hay ningún valor por defecto.

Advertencia: Esta función almacena la contraseña en texto sin cifrar dentro de Qt. Utiliza la llamada open() que toma una contraseña como parámetro para evitar este comportamiento.

Véase también password(), setUserName(), setDatabaseName(), setHostName(), setPort(), setConnectOptions() y open().

void QSqlDatabase::setPort(int port)

Establece el número de puerto de la conexión en port. Para que surta efecto, el número de puerto debe configurarse antes de que se establezca la conexión opened. Como alternativa, puedes llamar a close() sobre la conexión, establecer el número de puerto y volver a llamar a open().

No hay ningún valor por defecto.

Véanse también port(), setUserName(), setPassword(), setHostName(), setDatabaseName(), setConnectOptions() y open().

void QSqlDatabase::setUserName(const QString &name)

Establece el nombre de usuario de la conexión como name. Para que surta efecto, el nombre de usuario debe establecerse antes de que se establezca la conexión opened. Como alternativa, puedes llamar a close() sobre la conexión, establecer el nombre de usuario y volver a llamar a open().

No hay ningún valor por defecto.

Véanse también userName(), setDatabaseName(), setPassword(), setHostName(), setPort(), setConnectOptions() y open().

QStringList QSqlDatabase::tables(QSql::TableType type = QSql::Tables) const

Devuelve una lista de las tablas, tablas del sistema y vistas de la base de datos, tal y como se especifica en el parámetro type.

Véanse también primaryIndex() y record().

[since 6.8] QThread *QSqlDatabase::thread() const

Devuelve un puntero a la instancia asociada de ` QThread `.

Esta función se introdujo en Qt 6.8.

bool QSqlDatabase::transaction()

Inicia una transacción en la base de datos si el controlador admite transacciones. Devuelve « true » si la operación se ha realizado correctamente. En caso contrario, devuelve « false ».

Véase también QSqlDriver::hasFeature(), commit() y rollback().

QString QSqlDatabase::userName() const

Devuelve el nombre de usuario de la conexión; puede estar vacío.

Véase también setUserName().

QSqlDatabase &QSqlDatabase::operator=(const QSqlDatabase &other)

Asigna « other » a este objeto.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.