Conexión a bases de datos

Para acceder a una base de datos con QSqlQuery o QSqlQueryModel, crea y abre una o varias conexiones a la base de datos. Las conexiones a la base de datos se identifican normalmente por el nombre de la conexión, no por el nombre de la base de datos. Puedes tener varias conexiones a la misma base de datos. « QSqlDatabase » también admite el concepto de conexión por defecto, que es una conexión sin nombre. Al llamar a las funciones miembro de « QSqlQuery » o « QSqlQueryModel » que admiten un argumento de nombre de conexión, si no pasas un nombre de conexión, se utilizará la conexión por defecto. Crear una conexión por defecto resulta práctico cuando tu aplicación solo requiere una conexión a la base de datos.

Ten en cuenta la diferencia entre crear una conexión y abrirla. Crear una conexión implica crear una instancia de la clase ` QSqlDatabase`. La conexión no se puede utilizar hasta que se abra. El siguiente fragmento de código muestra cómo crear una conexión por defecto y, a continuación, abrirla:

    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
    db.setHostName("bigblue");
    db.setDatabaseName("flightdb");
    db.setUserName("acarlson");
    db.setPassword("1uTbSbAs");
    bool ok = db.open();

La primera línea crea el objeto de conexión y la última línea lo abre para su uso. Entre medias, inicializamos cierta información de la conexión, incluyendo database name, host name, user name y password. En este caso, nos conectamos a la base de datos MySQL flightdb en el host bigblue. El argumento "QMYSQL" de addDatabase() especifica el tipo de controlador de base de datos que se utilizará para la conexión. El conjunto de controladores de base de datos incluidos con Qt se muestra en la tabla de controladores de base de datos compatibles.

La conexión del fragmento de código será la conexión predeterminada, ya que no pasamos el segundo argumento a ` addDatabase()`—,que es el nombre de la conexión—. Por ejemplo, aquí establecemos dos conexiones a bases de datos MySQL denominadas ` "first" ` y ` "second"`:

    QSqlDatabase firstDB = QSqlDatabase::addDatabase("QMYSQL", "first");
    QSqlDatabase secondDB = QSqlDatabase::addDatabase("QMYSQL", "second");

Una vez inicializadas estas conexiones, se llama a ` open()` para cada una de ellas con el fin de establecer las conexiones activas. Si ` open()` falla, devuelve ` false`. En ese caso, se debe llamar a ` QSqlDatabase::lastError()` para obtener información sobre el error.

Una vez establecida la conexión, podemos llamar a la función estática ` QSqlDatabase::database()` desde cualquier lugar, indicando un nombre de conexión, para obtener un puntero a dicha conexión de base de datos. Si no se pasa ningún nombre de conexión, devolverá la conexión por defecto. Por ejemplo:

    QSqlDatabase defaultDB = QSqlDatabase::database();
    QSqlDatabase firstDB = QSqlDatabase::database("first");
    QSqlDatabase secondDB = QSqlDatabase::database("second");

Para eliminar una conexión a la base de datos, primero cierra la base de datos mediante QSqlDatabase::close(), y a continuación elimínala utilizando el método estático QSqlDatabase::removeDatabase().

© 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.