Пользовательские интерфейсы доступа к бд qt. Драйверы баз данных SQL

Create and open one or more database connections. Database connections are normally identified by connection name, not by database name. You can have multiple connections to the same database. QSqlDatabase also supports the concept of a default connection, which is an unnamed connection. When calling QSqlQuery or QSqlQueryModel member functions that take a connection name argument, if you don"t pass a connection name, the default connection will be used. Creating a default connection is convenient when your application only requires one database connection.

Note the difference between creating a connection and opening it. Creating a connection involves creating an instance of class QSqlDatabase . The connection is not usable until it is opened. The following snippet shows how to create a default connection and then open it:

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

The first line creates the connection object, and the last line opens it for use. In between, we initialize some connection information, including the database name , the host name , the user name , and the password . In this case, we are connecting to the MySQL database flightdb on the host bigblue . The "QMYSQL" argument to addDatabase() specifies the type of database driver to use for the connection. The set of database drivers included with Qt are shown in the table of supported database drivers .

The connection in the snippet will be the default connection, because we don"t pass the second argument to addDatabase() , which is the connection name. For example, here we establish two MySQL database connections named "first" and "second" :

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

Для исполнения команд SQL, после установления соединения, можно использовать класс QSqlQuery . Запросы (команды) оформляются в виде обычной строки, которая передается в конструктор или в метод QSqlQuery ::exec (). В случае конструктора, запуск команды будет производиться автоматически, при создании объекта.

Класс QSqlQuery предоставляет возможность навигации. Например, после выполнения запроса SELECT можно перемещаться по собранным данным при помощи методов next (), previous (), first (), last () и seek (). С помощью метода next () мы перемещаемся на следующую строку данных, а вызов метода previous () перемещает нас на предыдущую строку данных. При помощи методов first () и last () можно установить первую и последнюю строку данных соответственно. Метод seek () устанавливает строку данных по указанному целочисленному индексу в его параметре. Количество строк данных можно получить вызовом метода size ().

Дополнительные сложности возникают с запросом INSERT . Дело в том, что в запрос нужно внедрять данные. Для достижения этого можно воспользоваться двумя методами: prepare () и bindValue (). В методе prepare () мы задаем шаблон, данные в который подставляются методами bindValue (). Например:

Query.prepare("INSERT INTO addressbook (number, name, phone, email) VALUES(:number, :name, :phone, :email);"); query.bindValue (" :number", "1"); query.bindValue(":name", "Piggy"); query.bindValue(":phone", " + 49 631322187"); query.bindValue(":email", "[email protected]");

Также можно воспользоваться, известным из ODBC, вариантом использования безымянных параметров:

Query.prepare("INSERT INTO addressbook (number, name, phone, email) VALUES(?, ?, ?, ?);"); query.bindValue("1"); query.bindValue("Piggy"); query.bindValue("+ 49 631322187"); query.bindValue("[email protected]");

В качестве третьего варианта — можно воспользоваться классом QString , в частности методом QString ::arg (), с помощью которого можно произвести подстановку значений данных.

Int main(int argc, char** argv) { QCoreApplication app(argc, argv); if (!createConnection()) { return -1; } //Creating of the data base QSqlQuery query; QString str = "CREATE TABLE addressbook (" "number INTEGER PRIMARY KEY NOT NULL, " "name VARCHAR(15), " "phone VARCHAR(12), " "email VARCHAR(15) " ");"; if (!query.exec(str)) { qDebug() << "Unable to create a table"; } //Adding some information QString strF = "INSERT INTO addressbook (number, name, phone, email) " "VALUES(%1, "%2", "%3", "%4");"; str = strF.arg("1") .arg("Piggy") .arg("+49 631322187") .arg("[email protected]"); if (!query.exec(str)) { qDebug() << "Unable to do insert opeation"; } str = strF.arg("2") .arg("Kermit") .arg("+49 631322181") .arg("[email protected]"); if (!query.exec(str)) { qDebug() << "Unable to do insert operation"; } if (!query.exec("SELECT * FROM addressbook;")) { qDebug() << "Unable to execute query - exiting"; return 1; } //Reading of the data QSqlRecord rec = query.record(); int nNumber = 0; QString strName; QString strPhone; QString strEmail; while (query.next()) { nNumber = query.value(rec.indexOf("number")).toInt(); strName = query.value(rec.indexOf("name")).toString(); strPhone = query.value(rec.indexOf("phone")).toString(); strEmail = query.value(rec.indexOf("email")).toString(); qDebug() << nNumber << " " << strName << ";\t" << strPhone << ";\t" << strEmail; } return 0; }

Программа, приведенная выше, демонстрирует исполнение команд SQL. Производится создание базы, запись данных и их опрос. В результате на консоль будут выведены следующие данные:

1 "Piggy" ; "+49 631322187" ; "[email protected]" 2 "Kermit" ; "+49 631322181" ; "[email protected]"

В случае удачного соединения с базой данных с помощью createConnection () создается строка, содержащая команду SQL для создания таблицы. Эта строка передается в метод exec () объекта класса QSqlQuery . Если создать таблицу не удается, то на консоль будет выведено предупреждающее сообщение. Ввиду того, что в таблицу будет внесена не одна строка, в строковой переменной strF при помощи символов спецификации определяется шаблон для команды INSERT. Вызовы методов arg () класса QString подставляют нужные значения используя шаблон.

Затем, когда база данных создана и все данные были внесены в таблицу, выполняется запрос SELECT, помещающий строки и столбцы таблицы в объект query . Вывод значений таблицы на консоль производится в цикле. При первом вызове метода next () этот объект будет указывать на самую первую строку таблицы. Последующие вызовы приведут к перемещению указателя на следующие строки. В том случае, если записей больше нет, метод next () вернет false , что приведет к выходу из цикла. Для получения результата запроса следует вызвать метод QSqlQuery ::value (), в котором необходимо передать номер столбца. Для этого мы воспользуемся методом record (). Этот метод возвращает объект класса QSqlRecord , который содержит информацию, относящуюся к запросу SELECT . С его помощью, вызовом метода QSqlRecord ::indexOf (), мы получаем индекс столбца.

Метод value () возвращает значения типа QVariant . QVariant — это специальный класс, объекты которого могут содержать в себе значения разных типов. Поэтому, в нашем примере, полученное значение нужно преобразовать к требуемому типу, воспользовавшись методами QVariant ::toInt () и QVariant ::toString ().

Qt дает возможность создания платформо-независимых приложений для работы с базами данных, используя стандартные СУБД. Qt включает «родные» драйвера для Oracle, Microsoft SQL Server, Sybase Adaptive Server, IBM DB2, PostgreSQL, MySQL и ODBC-совместимых баз данных. Qt включает специфичные для баз данных виджеты, а также поддерживает расширение для работы с базами данных любых встроенных или отдельно написанных виджетов.

Введение

Работа с базами данных в Qt происходит на различных уровнях:
1.Слой драйверов - Включает классы QSqlDriver, QSqlDriverCreator, QSqlDriverCreatorBase, QSqlDriverPlugin и QSqlResult. Этот слой предоставляет низкоуровневый мост между определенными базами данных и слоем SQL API.
2.Слой SQL API - Этот слой предоставляет доступ к базам данных. Соединения устанавливаются с помощью класса QSqlDatabase. Взаимодействие с базой данных осуществляется с помощью класса QSqlQuery. В дополнение к классам QSqlDatabase и QSqlQuery слой SQL API опирается на классы QSqlError, QSqlField, QSqlIndex и QsqlRecord.
3.Слой пользовательского интерфейса - Этот слой связывает данные из базы данных с дата-ориентироваными виджетами. Сюда входят такие классы, как QSqlQueryModel, QSqlTableModel и QSqlRelationalTableModel.

Соединение с базой данных

Чтобы получить доступ к базе данных с помощью QSqlQuery и QSqlQueryModel, необходимо создать и открыть одно или более соединений с базой данных.
Qt может работать со следующими базами данных (из-за несовместимости с GPL лицензией, не все плагины поставляются с Qt Open Source Edition):

1. QDB2 - IBM DB2 (версия 7.1 и выше
2. QIBASE - Borland InterBase
3. QMYSQL - MySQL
4. QOCI - Драйвер Oracle Call Interface
5. QODBC - Open Database Connectivity (ODBC) - Microsoft SQL Server и другие ODBC-совместимые базы данных
6. QPSQL - PostgreSQL (версия 7.3 и выше)
7. QSQLITE2 - SQLite версии 2
8. QSQLITE - SQLite версии 3
9. QTDS - Драйвер Sybase Adaptive Server

Для сборки плагина драйвера, которые не входят в поставку Qt нужно иметь соответствующую клиентскую библиотеку для используемой СУБД.

Соединиться с базой данных можно вот так:

1. QSqlDatabase db = QsqlDatabase::addDatabase("QMYSQL" , "mydb" );
2. db.setHostName("bigblue" );
3. db.setDatabaseName("flightdb" );
4. db.setUserName("acarlson" );
5. db.setPassword("1uTbSbAs" );
6. bool ok = db.open();

Первая строка создает объект соединения, а последняя открывает его. В промежутке инициализируется некоторая информация о соединении, включая имя соединения, имя базы данных, имя узла, имя пользователя, пароль. В этом примере происходит соединение с базой данных MySQL flightdb на узле bigblue. Аргумент «QMYSQL» в addDatabase() указывает тип драйвера базы данных, чтобы использовать для соединения, а «mydb» - имя соединения.
Как только соединение установлено, можно вызвать статическую функцию QSqlDatabase::database() из любого места программы с указанием имени соединения, чтобы получить указатель на это соединение. Если не передать имя соединения, она вернет соединение по умолчанию.
Если open() потерпит неудачу, он вернет false. В этом случае, можно получить информацию об ошибке, вызвав QSqlDatabase::lastError().
Для удаления соединения с базой данных, надо сначала закрыть базу данных с помощью QSqlDatabase::close(), а затем, удалить соединение с помощью статического метода QSqlDatabase::removeDatabase().

Выполнение инструкций SQL

Класс QSqlQuery обеспечивает интерфейс для выполнения SQL запросов и навигации по результирующей выборке.
Для выполнения SQL запросов, просто создают объект QSqlQuery и вызывают QSqlQuery::exec(). Например, вот так:

1. QSqlQuery query;
2. query.exec("SELECT name, salary FROM employee WHERE salary > 50000" );

* This source code was highlighted with Source Code Highlighter .

Конструктор QSqlQuery принимает необязательный аргумент QSqlDatabase, который уточняет, какое соединение с базой данных используется. Если его не указать, то используется соединение по умолчанию.
Если возникает ошибка, exec() возвращает false. Доступ к ошибке можно получить с помощью QSqlQuery::lastError().
QSqlQuery предоставляет единовременный доступ к результирующей выборке одного запроса. После вызова exec(), внутренний указатель QSqlQuery указывает на позицию перед первой записью. Если вызвать метод QSqlQuery::next() один раз, то он переместит указатель к первой записи. После этого необходимо повторять вызов next(), чтобы получать доступ к другим записям, до тех пор пока он не вернет false. Вот типичный цикл, перебирающий все записи по порядку:

1. while (query.next()) {
2. QString name = query.value (0).toString();
3. int salary = query.value (1).toInt();
4. qDebug() << name << salary;

* This source code was highlighted with Source Code Highlighter .

QSqlQuery может выполнять не только SELECT, но также и любые другие запросы. Следующий пример вставляет запись в таблицу, используя INSERT:

1. QSqlQuery query;
2. query.exec(
3. "VALUES (1001, "Thad Beaumont", 65000)" );

* This source code was highlighted with Source Code Highlighter .

Если надо одновременно вставить множество записей, то зачастую эффективней отделить запрос от реально вставляемых значений. Это можно сделать с помощью вставки значений через параметры. Qt поддерживает два синтаксиса вставки значений: поименованые параметры и позиционные параметры. В следующем примере показана вставка с помощью поименованного параметра:

1. QSqlQuery query;
2. query.prepare("INSERT INTO employee (id, name, salary) "
3. "VALUES (:id, :name, :salary)" );
4. query.bindValue(":id" , 1001);
5. query.bindValue(":name" , "Thad Beaumont" );
6. query.bindValue(":salary" , 65000);
7. query.exec();

* This source code was highlighted with Source Code Highlighter .

В этом примере показана вставка с помощью позиционного параметра:

1. QSqlQuery query;
2. query.prepare("INSERT INTO employee (id, name, salary) "
3. "VALUES (?, ?, ?)" );
4. query.addBindValue(1001);
5. query.addBindValue("Thad Beaumont" );
6. query.addBindValue(65000);
7. query.exec();

* This source code was highlighted with Source Code Highlighter .

При вставке множества записей требуется вызвать QSqlQuery::prepare() только однажды. Далее можно вызвать bindValue() или addBindValue() с последующим вызовом exec() столько раз, сколько потребуется.

Отображение данных в таблице-представлении

Классы QSqlQueryModel, QSqlTableModel и QSqlRelationalTableModel могут использоваться в качестве источников данных для классов представлений Qt, таких как QListView, QTableView и QTreeView. На практике наиболее часто используется QTableView в связи с тем, что результирующая SQL выборка, по существу, представляет собой двумерную структуру данных.
В следующем примере создается представление основанное на модели данных SQL:

1. QSqlTableModel model;
2. model.setTable("employee" );
3. QTableView *view = new QTableView;
4. view->setModel(&model);
5. view->show();

* This source code was highlighted with Source Code Highlighter .

Если модель является моделью для чтения-записи (например, QSqlTableModel), то представление позволяет редактировать поля. Это можно отключить с помощью следующего кода

В таблице ниже представлен список драйверов, поставляемых с Qt. Due to license incompatibilities with the GPL, not all of the plugins are provided with Open Source Versions of Qt.

Имя драйверовDBMS IBM DB2 (версия 7.1 и выше) Borland InterBase MySQL Драйвер Oracle Call Interface Open Database Connectivity (ODBC) - Microsoft SQL Server и другие ODBC-совместимые базы данных PostgreSQL (версия 7.3 и выше) SQLite версии 2 SQLite версии 3 Sybase Adaptive Server Note: obsolete from Qt 4.7

SQLite is the in-process database system with the best test coverage and support on all platforms. Oracle via OCI, and PostreSQL and MySQL through either ODBC or a native driver are well-tested on Windows and Linux. The completeness of the support for other systems depends on the availability and quality of client libraries.

Замечание: для сборки плагина драйвера вам нужно иметь соответствующую клиентскую библиотеку для вашей системы управления базами данных (СУБД). Это обеспечивает доступ к API СУБД, и, как правило, поставляется вместе с ней. Большинство программ установки также позволяют установить "библиотеки для разработки", это то, что вам нужно. Эти библиотеки отвечают за низкоуровневое взаимодействие с СУБД.

Сборка драйверов при запуске configure

Под Unix и Mac OS X, скрипт Qt configure пытается автоматически обнаружить доступные библиотеки на вашей машине. Запустив configure -help можно увидеть, какие драйвера могут быть собраны. Вы получите подобный список, подобный следующему:

No-sql- ... Выключить SQL полностью. -qt-sql- ... Включить SQL в Qt библиотеку, по умолчанию не включенную. -plugin-sql- Включить SQL как плагин для подключения во время выполнения программы. Доступные значения для : [ db2 ibase mysql oci odbc psql sqlite sqlite2 tds ]

Скрипт configure не может обнаружить необходимые библиотеки и подключаемые (include) файлы, если они находятся не в стандартных директориях, вам может понадобиться указать путь к ним, используя опции командной строки -I и -L . Например, если MySQL включаемые файлы установлены в /usr/local/mysql (или в C:\mysql\include под Windows), тогда добавьте следующий параметр: -I/usr/local/mysql (или -I C:\mysql\include под Windows).

Под Windows параметр -I не поддерживает пробелы в пути, при необходимости применяйте 8.3 имена; например, используйте C:\progra~1\mysql вместо C:\Program Files\mysql .

Используйте параметр -qt-sql- для статической сборки БД драйвера с Qt библиотекой или -plugin-sql- для сборки драйвера в виде плагина. Для дополнительной информации о необходимых библиотеках смотрите разделы ниже.

Сборка плагинов вручную

QMYSQL для MySQL 4 и выше

Поддержка хранимых процедур в QMYSQL

В MySQL 5 введена поддержка хранимых процедур SQL уровня, но нет API контроля для IN, OUT и INOUT параметров. Поэтому, параметры должны быть установлены и прочитаны с использованием QSqlQuery::bindValue ().

Пример хранимой процедуры:

Create procedure qtestproc (OUT param1 INT, OUT param2 INT) BEGIN set param1 = 42; set param2 = 43; END

Исходный код получения доступа к OUT значениям:

QSqlQuery q; q. exec("call qtestproc (@outval1, @outval2)" ); q. exec("select @outval1, @outval2" ); q. next(); qDebug() < < q. value(0 ) < < q. value(1 ); // outputs "42" and "43"

Замечание: @outval1 и @outval2 - локальные переменные текущего соединения, они не будут участвовать в запросах, отправленных с другого компьютера или соединения.

Встроенные MySQL сервер

Встроенный MySQL сервер является лёгкой заменой обычной клиентской библиотеке. Чтобы использовать функциональность MySQL со встроенным MySQL-сервером, сервер MySQL не нужен.

Чтобы использовать встроенный сервер MySQL, просто слинкуйте Qt плагин с libmysqld вместо libmysqlclient. Это может быть сделано путем замены -lmysqlclient_r на -lmysqld в команде qmake в разделе ниже.

Пожалуйста, обратитесь к документации MySQL, глава "libmysqld, the Embedded MySQL Server Library", чтобы получить дополнительную информацию о встроенном сервере MySQL.

Как собрать QMYSQL плагин под Unix и Mac OS X

Вам понадобятся заголовочные файлы MySQL с соответствующей им динамической библиотекой libmysqlclient.so . В зависимости от вашего дистрибутива вам может потребоваться установка пакета, который обычно называется "mysql-devel".

Поддержка OCI BLOB/LOB

Вставка BLOB должна быть совершена либо с помощью подготовленного запроса, где BLOB-ы должны быть ограничены шаблоном, либо с помощью QSqlTableModel , которая использует подготовленные запросы внутри.

Как собрать OCI плагин под Unix и Mac OS X

Для Oracle 10g всё, что вам нужно, - это "Instant Client Package - Basic" и "Instant Client Package - SDK". Для Oracle до 10g вам необходим стандартный клиент Oracle и SDK пакеты.

Библиотеки Oracle, необходимые для сборки драйвера:

• libclntsh.so (все версии)
• libwtc9.so (только Oracle 9)

Задайте qmake , где найти заголовочные файлы Oracle и библиотеки, затем запустите make:

Для Oracle версии 9:

Cd $QTDIR/src/plugins/sqldrivers/oci qmake "INCLUDEPATH+=$ORACLE_HOME/rdbms/public $ORACLE_HOME/rdbms/demo" "LIBS+=-L$ORACLE_HOME/lib -lclntsh -lwtc9" oci.pro make

Для Oracle версии 10 мы полагаем, что вы установили RPM пакеты Instant Client Package SDK (вы должны настроить соответствующий номер версии):

Cd $QTDIR/src/plugins/sqldrivers/oci qmake "INCLUDEPATH+=/usr/include/oracle/10.1.0.3/client/" "LIBS+=-L/usr/lib/oracle/10.1.0.3/client/lib -lclntsh" oci.pro make

Note: If you are using the Oracle Instant Client package, you will need to set LD_LIBRARY_PATH when building the OCI SQL plugin and when running an applicaiton that uses the OCI SQL plugin. You can avoid this requirement by setting and RPATH and listing all of the libraries to link to. Вот пример:

Configure -I /usr/include/oracle/10.1.0.3/client -L /usr/lib/oracle/10.1.0.3/client/lib -R /usr/lib/oracle/10.1.0.3/client/lib -lclntsh -lnnz10 make

If you wish to build the OCI plugin manually with this method the procedure looks like this:

Cd $QTDIR/src/plugins/sqldrivers/oci qmake "INCLUDEPATH+=/usr/include/oracle/10.1.0.3/client" "LIBS+=-L/usr/lib/oracle/10.1.0.3/client/lib -Wl,-rpath,/usr/lib/oracle/10.1.0.3/client/lib -lclntsh -lnnz10" oci.pro make

Как собрать OCI плагин под Windows

Choosing the option "Programmer" in the Oracle Client Installer from the Oracle Client Installation CD is generally sufficient to build the plugin. For some versions of Oracle Client, you may also need to select the "Call Interface (OCI)" option if it is available.

Соберите плагин следующим образом (здесь мы полагаем, что клиент Oracle установлен в C:\oracle):

Set INCLUDE=%INCLUDE%;c:\oracle\oci\include set LIB=%LIB%;c:\oracle\oci\lib\msvc cd %QTDIR%\src\plugins\sqldrivers\oci qmake oci.pro nmake

Когда вы запускаете ваше приложение, вам необходимо добавить путь до oci.dll в переменную окружения PATH:

Set PATH=%PATH%;c:\oracle\bin

Замечание:

QODBC для Open Database Connectivity (ODBC)

Общая информация о ODBC плагине

ODBC - это общий интерфейс, который позволяет вам соединяться с множеством СУБД. Драйвер QODBC позволяет вам соединяться с "Источником данных ODBC" и получать доступ к имеющимся источникам данных. Заметьте, что вы так же нуждаетесь в установке и настройке драйверов ODBC для "Источника данных ODBC", который установлен на вашей системе. Плагин QODBC позволит вам использовать эти источники данных в ваших Qt приложениях.

Замечание: вы должны использовать родные драйверы, предпочитая их драйверу ODBC, там, где это возможно. Поддержка ODBC может быть использована как обходной путь для баз данных, если родной драйвер не доступен.

На Windows "Источник данных ODBC" должен быть установлен по умолчанию. Для Unix систем есть несколько реализаций, которые должны быть сначала установлены. Заметьте, что каждый клиент, который использует ваше приложение, требует наличия установленного "Источника данных ODBC", в противном случае плагин QODBC не будет работать.

Помните, что при подключении к ODBC данных вы должны ввести имя ODBC источника данных в функцию QSqlDatabase::setDatabaseName (), а не имя БД.

Для работы плагину QODBC нужен совместимый ODBC менеджер драйвера версии 2.0 или позже. Некоторые ODBC драйверы обозначаются версией 2.0, но не поддерживают необходимую функциональность. The QODBC plugin therefore checks whether the data source can be used after a connection has been established and refuses to work if the check fails. If you don"t like this behavior, you can remove the #define ODBC_CHECK_DRIVER line from the file qsql_odbc.cpp . Do this at your own risk!

By default, Qt instructs the ODBC driver to behave as an ODBC 2.x driver. However, for some driver-manager/ODBC 3.x-driver combinations (e.g., unixODBC/MaxDB ODBC ), telling the ODBC driver to behave as a 2.x driver can cause the driver plugin to have unexpected behavior. To avoid this problem, instruct the ODBC driver to behave as a 3.x driver by setting the connect option "SQL_ATTR_ODBC_VERSION=SQL_OV_ODBC3" before you open your database connection . Note that this will affect multiple aspects of ODBC driver behavior, e.g., the SQLSTATEs. Before setting this connect option, consult your ODBC documentation about behavior differences you can expect.

If you experience very slow access of the ODBC datasource, make sure that ODBC call tracing is turned off in the ODBC datasource manager.

Some drivers don"t support scrollable cursors. In that case case only queries in forwardOnly mode can be used successfully.

Поддержка хранимых процедур в ODBC

With Microsoft SQL Server the result set returned by a stored procedure that uses the return statement, or returns multiple result sets, will be accessible only if you set the query"s forward only mode to forward using QSqlQuery::setForwardOnly ().

// STORED_PROC uses the return statement or returns multiple result sets QSqlQuery query; query. setForwardOnly(true ); query. exec("{call STORED_PROC}" );

Note: The value returned by the stored procedure"s return statement is discarded.

Поддержка Unicode в ODBC

The QODBC Plugin will use the Unicode API if UNICODE is defined. On Windows NT based systems, this is the default. Note that the ODBC driver and the DBMS must also support Unicode.

Some driver managers and drivers don"t support UNICODE. To use the QODBC plugin with such drivers it has to be compiled with the Q_ODBC_VERSION_2 defined.

For the Oracle 9 ODBC driver (Windows), it is neccessary to check "SQL_WCHAR support" in the ODBC driver manager otherwise Oracle will convert all Unicode strings to local 8-bit.

Как собрать ODBC плагин под Unix и Mac OS X

It is recommended that you use unixODBC. You can find the latest version and ODBC drivers at http://www.unixodbc.org . You need the unixODBC header files and shared libraries.

Tell qmake where to find the unixODBC header files and shared libraries (here it is assumed that unixODBC is installed in /usr/local/unixODBC) and run make:

Cd $QTDIR/src/plugins/sqldrivers/odbc qmake "INCLUDEPATH+=/usr/local/unixODBC/include" "LIBS+=-L/usr/local/unixODBC/lib -lodbc" make

Как собрать ODBC плагин под Windows

The ODBC header and include files should already be installed in the right directories. You just have to build the plugin as follows:

Cd %QTDIR%\src\plugins\sqldrivers\odbc qmake odbc.pro nmake

Если вы используете компилятор не от Microsoft, замените nmake на make .

Note: This database plugin is not officially supported for Windows CE.

QPSQL для PostgreSQL (Версия 7.3 и выше)

Общая информация о QPSQL драйвере

The QPSQL driver supports version 7.3 and higher of the PostgreSQL server. We recommend that you use a client library from version 7.3.15, 7.4.13, 8.0.8, 8.1.4 or more recent as these versions contain security fixes, and as the QPSQL driver might not build with older versions of the client library depending on your platform.

Поддержка Unicode в QPSQL

The QPSQL driver automatically detects whether the PostgreSQL database you are connecting to supports Unicode or not. Unicode is automatically used if the server supports it. Note that the driver only supports the UTF-8 encoding. If your database uses any other encoding, the server must be compiled with Unicode conversion support.

Unicode support was introduced in PostgreSQL version 7.1 and it will only work if both the server and the client library have been compiled with multibyte support. More information about how to set up a multibyte enabled PostgreSQL server can be found in the PostgreSQL Administrator Guide, Chapter 5.

Поддержка BLOB в QPSQL

Binary Large Objects are supported through the BYTEA field type in PostgreSQL server versions >= 7.1.

Как собрать QPSQL плагин под Unix и Mac OS X

You need the PostgreSQL client library and headers installed.

To make qmake find the PostgreSQL header files and shared libraries, run qmake the following way (assuming that the PostgreSQL client is installed in /usr):

Cd $QTDIR/src/plugins/sqldrivers/psql qmake "INCLUDEPATH+=/usr/include/pgsql" "LIBS+=-L/usr/lib -lpq" psql.pro make

Замечание: Этот плагин базы данных не поддерживается для Windows CE.

QTDS для Sybase Adaptive Server

Note: TDS is no longer used by MS Sql Server, and is superceded by . QTDS устарел начиная с Qt 4.7.

Общая информация о QTDS

Как собрать QDB2 плагин под Unix и Mac OS X

cd $QTDIR/src/plugins/sqldrivers/db2 qmake "INCLUDEPATH+=$DB2DIR/include" "LIBS+=-L$DB2DIR/lib -ldb2" make

In SQLite any column, with the exception of an INTEGER PRIMARY KEY column, may be used to store any type of value. For instance, a column declared as INTEGER may contain an integer value in one row and a text value in the next. This is due to SQLite associating the type of a value with the value itself rather than with the column it is stored in. A consequence of this is that the type returned by QSqlField::type () only indicates the field"s recommended type. No assumption of the actual type should be made from this and the type of the individual values should be checked.

The driver is locked for updates while a select is executed. This may cause problems when using QSqlTableModel because Qt"s item views fetch data as needed (with QSqlQuery::fetchMore() in the case of QSqlTableModel).

Как собрать QSQLITE плагин

SQLite version 3 is included as a third-party library within Qt. It can be built by passing the following parameters to the configure script: -plugin-sql-sqlite (build as a plugin) or -qt-sql-sqlite (linked directly into the Qt library).

If you don"t want to use the SQLite library included with Qt, you can build it manually (replace $SQLITE by the directory where SQLite resides):

Cd $QTDIR/src/plugins/sqldrivers/sqlite qmake "INCLUDEPATH+=$SQLITE/include" "LIBS+=-L$SQLITE/lib -lsqlite" make

After installing Qt, as described in the Installing Qt for X11 Platforms document, you also need to install the plugin in the standard location:

Cd $QTDIR/src/plugins/sqldrivers/sqlite make install

Cd %QTDIR%\src\plugins\sqldrivers\sqlite qmake "INCLUDEPATH+=C:\SQLITE\INCLUDE" "LIBS+=C:\SQLITE\LIB\SQLITE3.LIB" sqlite.pro nmake

Совместимость файловых форматов QSQLITE

SQLite minor releases sometimes break file format forward compatibility. For example, SQLite 3.3 can read database files created with SQLite 3.2, but databases created with SQLite 3.3 cannot be read by SQLite 3.2. Please refer to the SQLite documentation and change logs for information about file format compatibility between versions.

Qt minor releases usually follow the SQLite minor releases, while Qt patch releases follow SQLite patch releases. Patch releases are therefore both backward and forward compatible.

To force SQLite to use a specific file format, it is neccessary to build and ship your own database plugin with your own SQLite library as illustrated above. Some versions of SQLite can be forced to write a specific file format by setting the SQLITE_DEFAULT_FILE_FORMAT define when building SQLite.

QIBASE для Borland InterBase

Общая информация о QIBASE

The Qt InterBase plugin makes it possible to access the InterBase and Firebird databases. InterBase can either be used as a client/server or without a server in which case it operates on local files. The database file must exist before a connection can be established. Firebird must be used with a server configuration.

Note that InterBase requires you to specify the full path to the database file, no matter whether it is stored locally or on another server.

Db. setHostName("MyServer" ); db. setDatabaseName("C:\\test.gdb" );

You need the InterBase/Firebird development headers and libraries to build this plugin.

Due to license incompatibilities with the GPL, users of the Qt Open Source Edition are not allowed to link this plugin to the commercial editions of InterBase. Please use Firebird or the free edition of InterBase.

Поддержка Unicode в QIBASE и кодировка текста

By default the driver connects to the database using UNICODE_FSS. This can be overridden by setting the ISC_DPB_LC_CTYPE parameter with QSqlDatabase::setConnectOptions () before opening the connection.

// connect to database using the Latin-1 character set db. setConnectOptions("ISC_DPB_LC_CTYPE=Latin1" ); db. open();

If Qt doesn"t support the given text encoding the driver will issue a warning message and connect to the database using UNICODE_FSS.

Note that if the text encoding set when connecting to the database is not the same as in the database, problems with transliteration might arise.

Хранимые процедуры в QIBASE

InterBase/Firebird return OUT values as result set, so when calling stored procedure, only IN values need to be bound via QSqlQuery::bindValue (). The RETURN/OUT values can be retrieved via QSqlQuery::value (). Пример:

QSqlQuery q; q. exec("execute procedure my_procedure" ); q. next(); qDebug() < < q. value(0 ); // outputs the first RETURN/OUT value

Как собрать QIBASE плагин под Unix и Mac OS X

Ниже полагается, что InterBase или Firebird установлены в /opt/interbase:

Cd $QTDIR/src/plugins/sqldrivers/ibase qmake "INCLUDEPATH+=/opt/interbase/include" "LIBS+=-L/opt/interbase/lib" ibase.pro make

If you are using Firebird, the Firebird library has to be set explicitly:

Cd $QTDIR/src/plugins/sqldrivers/ibase qmake "INCLUDEPATH+=/opt/interbase/include" "LIBS+=-L/opt/interbase/lib -lfbclient" ibase.pro make

Как собрать QIBASE плагин под Windows

Ниже полагается, что InterBase или Firebird установлены в C:\interbase:

Если вы используете InterBase:

Cd %QTDIR%\src\plugins\sqldrivers\ibase qmake "INCLUDEPATH+=C:\interbase\include" ibase.pro nmake

Если вы используете Firebird, то библиотека Firebird должна устанавливаться явно:

Cd %QTDIR%\src\plugins\sqldrivers\ibase qmake "INCLUDEPATH+=C:\interbase\include" "LIBS+=-lfbclient" ibase.pro nmake

Если вы используете компилятор не от Microsoft, замените nmake на make .

Помните, что C:\interbase\bin должен быть в PATH .

Замечание: Этот плагин базы данных не поддерживается для Windows CE.

Решение проблем

Вы должны всегда использовать библиотеки клиента, которые были собраны тем же компилятором, который вы используете для своего проекта. Если вы не можете получить описание источника сборки библиотеки клиента самостоятельно, попробуйте удостовериться, что предсобранная библиотека совместима с вашим компилятором, иначе вы получите множество ошибок "undefined symbols". Некоторые компиляторы имеют инструменты для преобразования библиотек, например, Borland предоставляет инструмент COFF2OMF.EXE для преобразования библиотек, которые были собраны в Microsoft Visual C++.

Если компиляция плагина прошла успешно, но он не может быть загружен, убедитесь в том, что следующие требования выполнены:

• Убедитесь, что вы используете Qt библиотеку динамически; вы не может использовать плагины в статической сборке.
• Убедитесь, что плагин в правильной директории. Можно использовать QApplication::libraryPaths (), чтобы определить, где Qt ищет плагины.
• Убедитесь, что клиентские библиотеки СУБД доступны. Под Unix, выполните команду ldd и введите имя плагина в качестве параметра, например: ldd libqsqlmysql.so . Вы получите предупреждение, если какая-то из клиентских библиотек не найдена. Под Windows, вы можете использовать Visual Studio dependency walker.
• Скомпилируйте Qt с установленным QT_DEBUG_COMPONENT , чтобы получить более подробную отладочную информацию во время загрузки плагинов.

Make sure you have followed the guide to Deploying Plugins . If you experience plugin load problems and see output like this:

() и QSqlDriver и QSqlResult близко связаны. Когда используется Qt SQL драйвер, оба этих класса должны быть унаследованы в подклассах, причём все абстрактные виртуальные методы каждого класса должны быть реализованы.

Для применения Qt SQL драйвера в качестве плагина (чтобы он был распознан и загружен в Qt во время выполнения программы), он должен использовать макрос Q_EXPORT_PLUGIN2 (). Для того, чтобы получить больше информации, прочитайте Как создавать плагины . Вы можете также проверить, как это реализовано в Qt в директориях QTDIR/src/plugins/sqldrivers и QTDIR/src/sql/drivers .

Код ниже можно использовать в качестве основы для SQL драйвера:

class XyzResult: public QSqlResult { public : XyzResult(const QSqlDriver * driver) : QSqlResult { & /* options */ ) { return false ; } void close() {} QSqlResult * createResult() const { return new XyzResult(this ); } };