Uso de bases de datos SQL con vistas de « Qt Quick »
Modelos SQL
Qt proporciona clases de C++ que admiten modelos de datos SQL. Estas clases operan de forma transparente sobre los datos SQL subyacentes, lo que reduce la necesidad de ejecutar consultas SQL para operaciones básicas como crear, insertar o actualizar. Para obtener más detalles sobre estas clases, consulta Uso de las clases de modelos SQL.
Aunque las clases de C++ proporcionan un conjunto completo de funciones para operar con datos SQL, no facilitan el acceso a los datos desde QML. Por lo tanto, debes implementar un modelo de datos personalizado en C++ como subclase de una de estas clases y exponerlo a QML, ya sea como un tipo o como una propiedad de contexto.
Modelo de datos de solo lectura
El modelo personalizado debe reimplementar los siguientes métodos para permitir el acceso de solo lectura a los datos desde QML:
- roleNames() para exponer los nombres de los roles a la interfaz de QML. Por ejemplo, la siguiente versión devuelve los nombres de los campos de la tabla seleccionada como nombres de roles:
QHash<int, QByteArray> SqlQueryModel::roleNames() const { QHash<int, QByteArray> roles; // record() returns an empty QSqlRecord for (int i = 0; i < this->record().count(); i ++) { roles.insert(Qt::UserRole + i + 1, record().fieldName(i).toUtf8()); } return roles; } - data() para exponer los datos SQL a la interfaz QML. Por ejemplo, la siguiente implementación devuelve los datos correspondientes al índice del modelo dado:
QVariant SqlQueryModel::data(const QModelIndex &index, int role) const { QVariant value; if (index.isValid()) { if (role < Qt::UserRole) { value = QSqlQueryModel::data(index, role); } else { int columnIdx = role - Qt::UserRole - 1; QModelIndex modelIndex = this->index(index.row(), columnIdx); value = QSqlQueryModel::data(modelIndex, Qt::DisplayRole); } } return value; }
La clase ` QSqlQueryModel ` es suficiente para implementar un modelo personalizado de solo lectura que represente datos en una base de datos SQL. El ejemplo del tutorial de chat lo ilustra muy bien al implementar un modelo personalizado para recuperar los datos de contacto de una base de datos SQLite.
Modelo de datos editable
QSqlTableModel proporciona un modelo de datos editable para una única tabla de base de datos e implementa setData() tal y como se describe en la documentación general sobre programación de modelos y vistas.
Dependiendo del ` EditStrategy ` utilizado por el modelo, los cambios se ponen en cola para enviarse más tarde o se envían de inmediato.
También puedes insertar nuevos datos en el modelo llamando a ` QSqlTableModel::insertRecord()`. En el siguiente fragmento de código, se rellena un ` QSqlRecord ` con los detalles de un libro y se añade al modelo:
...
QSqlRecord newRecord = record();
newRecord.setValue("author", "John Grisham");
newRecord.setValue("booktitle", "The Litigators");
insertRecord(rowCount(), newRecord);
...© 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.