Uso de las clases del modelo SQL
Además de ` QSqlQuery`, Qt ofrece tres clases de nivel superior para acceder a bases de datos. Estas clases son ` QSqlQueryModel`, ` QSqlTableModel` y ` QSqlRelationalTableModel`.
| QSqlQueryModel | Un modelo de solo lectura basado en una consulta SQL arbitraria. |
| QSqlTableModel | Un modelo de lectura y escritura que funciona con una sola tabla. |
| QSqlRelationalTableModel | Una subclase de ` QSqlTableModel ` con soporte para claves externas. |
Estas clases derivan de ` QAbstractTableModel ` (que a su vez hereda de ` QAbstractItemModel`) y facilitan la presentación de datos de una base de datos en una clase de vista de elemento, como ` QListView ` y ` QTableView`. Esto se explica con detalle en la sección «Presentación de datos en una vista de tabla ».
Otra ventaja de utilizar estas clases es que pueden facilitar la adaptación de tu código a otras fuentes de datos. Por ejemplo, si utilizas QSqlTableModel y más adelante decides utilizar archivos XML para almacenar datos en lugar de una base de datos, básicamente solo tendrás que sustituir un modelo de datos por otro.
El modelo de consulta SQL
QSqlQueryModel ofrece un modelo de solo lectura basado en una consulta SQL.
Ejemplo:
QSqlQueryModel model;
model.setQuery("SELECT * FROM employee");
for (int i = 0; i < model.rowCount();++i) {
int id = model.record(i).value("id").toInt();
QString name = model.record(i).value("name").toString();
qDebug() << id << name;
}Tras configurar la consulta mediante ` QSqlQueryModel::setQuery()`, puedes utilizar ` QSqlQueryModel::record(int)` para acceder a los registros individuales. También puedes utilizar ` QSqlQueryModel::data()` y cualquiera de las demás funciones heredadas de ` QAbstractItemModel`.
También existe una sobrecarga de setQuery() que toma un objeto QSqlQuery y opera sobre su conjunto de resultados. Esto permite utilizar cualquier característica de QSqlQuery para configurar la consulta (por ejemplo, consultas preparadas).
El modelo de tabla SQL
QSqlTableModel ofrece un modelo de lectura y escritura que opera sobre una única tabla SQL a la vez.
Ejemplo:
QSqlTableModel modelo;
modelo.setTable("employee");
modelo.setFilter("salary > 50000");
modelo.setSort(2, Qt::DescendingOrder);
model.select();
for (int i = 0; i < model.rowCount();++i) {
QString nombre = modelo.registro(i).valor("nombre").toString();
int salario = modelo.registro(i).valor("salario").toInt();
qDebug() << name << salary;
}QSqlTableModel es una alternativa de alto nivel a QSqlQuery para navegar y modificar tablas SQL individuales. Por lo general, requiere menos código y no es necesario tener conocimientos de sintaxis SQL.
Utiliza ` QSqlTableModel::record()` para recuperar una fila de la tabla y ` QSqlTableModel::setRecord()` para modificarla. Por ejemplo, el siguiente código aumentará el sueldo de todos los empleados en un 10 por ciento:
for (int i = 0; i < model.rowCount(); ++i) {
QSqlRecord record = model.record(i);
double salary = record.value("salary").toInt();
salary *= 1.1;
record.setValue("salary", salary);
model.setRecord(i, record);
}
model.submitAll();También puedes utilizar ` QSqlTableModel::data()` y ` QSqlTableModel::setData()`, que se heredan de ` QAbstractItemModel`, para acceder a los datos. Por ejemplo, así es como se actualiza un registro utilizando ` setData()`:
model.setData(model.index(row, column), 75000);
model.submitAll();A continuación se explica cómo insertar una fila y rellenarla:
model.insertRows(row, 1);
model.setData(model.index(row, 0), 1013);
model.setData(model.index(row, 1), "Peter Gordon");
model.setData(model.index(row, 2), 68500);
model.submitAll();A continuación te explicamos cómo eliminar cinco filas consecutivas:
model.removeRows(row, 5);
model.submitAll();El primer argumento de la función QSqlTableModel::removeRows() es el índice de la primera fila que se va a eliminar.
Cuando termines de modificar un registro, debes llamar siempre a QSqlTableModel::submitAll() para asegurarte de que los cambios se guarden en la base de datos.
El momento y la necesidad de llamar a `submitAll()` dependen de la propiedad ` edit strategy` de la tabla. La estrategia por defecto es ` QSqlTableModel::OnRowChange`, que especifica que los cambios pendientes se aplican a la base de datos cuando el usuario selecciona una fila diferente. Otras estrategias son QSqlTableModel::OnManualSubmit (en la que todos los cambios se almacenan en caché en el modelo hasta que se llama a `submitAll()`) y QSqlTableModel::OnFieldChange (en la que no se almacena ningún cambio en caché). Estas resultan especialmente útiles cuando se utiliza QSqlTableModel con una vista.
QSqlTableModel::OnFieldChange Parece cumplir la promesa de que nunca es necesario llamar a `submitAll()` de forma explícita. Sin embargo, hay dos inconvenientes:
- Sin almacenamiento en caché, el rendimiento puede reducirse significativamente.
- Si modificas una clave primaria, el registro podría escaparse mientras intentas rellenarlo.
El modelo de tabla relacional SQL
QSqlRelationalTableModel amplía el modelo « QSqlTableModel » para ofrecer compatibilidad con las claves externas. Una clave externa es una correspondencia 1 a 1 entre un campo de una tabla y el campo de clave primaria de otra tabla. Por ejemplo, si una tabla « book » tiene un campo llamado « authorid » que hace referencia al campo « id » de la tabla «author», decimos que « authorid » es una clave externa.
![]() | ![]() |
La captura de pantalla de la izquierda muestra un « QSqlTableModel » sin formato en un « QTableView ». Las claves externas (city y country) no se resuelven en valores legibles para el usuario. La captura de pantalla de la derecha muestra un « QSqlRelationalTableModel », con las claves externas resueltas en cadenas de texto legibles para el usuario.
El siguiente fragmento de código muestra cómo se configuró el QSqlRelationalTableModel:
model->setTable("employee");
model->setRelation(2, QSqlRelation("city", "id", "name"));
model->setRelation(3, QSqlRelation("country", "id", "name"));Consulta la documentación de QSqlRelationalTableModel para obtener más detalles.
© 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.

