Класс QSqlDatabase

Класс QSqlDatabase управляет подключением к базе данных. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Статические открытые члены

Защищенные функции

Подробное описание

Класс QSqlDatabase предоставляет интерфейс для доступа к базе данных через подключение. Экземпляр QSqlDatabase представляет подключение. Подключение обеспечивает доступ к базе данных через один из поддерживаемых драйверов баз данных, которые являются производными от QSqlDriver. В качестве альтернативы можно создать свой собственный драйвер базы данных, унаследовав его от QSqlDriver. См. Как создать собственный драйвер базы данных для получения дополнительной информации.

Создайте подключение (т.е., экземпляр QSqlDatabase) вызвав одну из статических функций addDatabase(), где вы указываете драйвер или тип драйвера для использования (в зависимости от типа базы данных) и имя подключения. Подключение известно по своему имени, а не по имени базы данных, к которой оно подключено. Вы можете иметь несколько подключений к одной базе данных. QSqlDatabase также поддерживает понятие по умолчанию подключения, которое является безымянным подключением. Чтобы создать подключение по умолчанию, не передавайте аргумент имени подключения при вызове addDatabase(). Впоследствии, подключение по умолчанию будет предполагаться, если вы вызываете любую статическую функцию, не указывая имя подключения. Следующий фрагмент кода демонстрирует, как создать и открыть подключение по умолчанию к базе данных PostgreSQL:

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

После создания объекта QSqlDatabase, установите параметры подключения с помощью setDatabaseName(), setUserName(), setPassword(), setHostName(), setPort() и setConnectOptions(). Затем вызовите open(), чтобы активировать физическое подключение к базе данных. Подключение недоступно до тех пор, пока вы его не откроете.

Определенное выше подключение будет подключением по умолчанию, потому что мы не указали имя подключения для addDatabase(). Впоследствии вы можете получить подключение по умолчанию, вызвав database() без аргумента имени подключения:

    QSqlDatabase db = QSqlDatabase::database();

QSqlDatabase — это класс-значение. Изменения, внесенные в подключение к базе данных через один экземпляр QSqlDatabase, повлияют на другие экземпляры QSqlDatabase, которые представляют то же самое подключение. Используйте cloneDatabase(), чтобы создать независимое подключение к базе данных на основе существующего.

Предупреждение: Настоятельно рекомендуется не хранить копию QSqlDatabase в качестве члена класса, так как это помешает экземпляру правильно очиститься при завершении работы. Если вам необходимо получить доступ к существующему QSqlDatabase, необходимо получить к нему доступ с помощью database(). Если вы выбрали в качестве члена переменную QSqlDatabase, её необходимо удалить до удаления экземпляра QCoreApplication, иначе это может привести к неопределённому поведению.

Если вы создаете несколько подключений к базам данных, укажите уникальное имя подключения для каждого из них при вызове addDatabase(). Используйте database() с именем подключения, чтобы получить это подключение. Используйте removeDatabase() с именем подключения, чтобы удалить подключение. QSqlDatabase выведет предупреждение, если вы попытаетесь удалить подключение, на которое ссылаются другие объекты QSqlDatabase. Используйте contains(), чтобы проверить, существует ли данное имя подключения в списке подключений.

Примечание: QSqlDatabase::exec() устарело. Используйте QSqlQuery::exec() вместо этого.

Примечание: При использовании транзакций необходимо начать транзакцию до создания запроса.

См. также QSqlDriver, QSqlQuery, Qt SQL и Модули потоков и модуль SQL.

Документация по функциям-членам

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

Это перегруженная функция.

Создает подключение к базе данных, используя указанный драйвер.

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

Это перегруженная функция.

Создает подключение QSqlDatabase, которое использует драйвер, указанный в type. Если type не распознан, подключение к базе данных не будет функциональным.

Доступные типы драйверов:

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

См. также SQL-драйверы баз данных, registerSqlDriver() и drivers().

QSqlDatabase::QSqlDatabase(const QSqlDatabase &other)

Создает копию other.

QSqlDatabase::QSqlDatabase()

Создает пустой, недействительный объект QSqlDatabase. Используйте addDatabase(), removeDatabase() и database() для получения действительных объектов QSqlDatabase.

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

Присваивает other этому объекту.

QSqlDatabase::~QSqlDatabase()

Уничтожает объект и освобождает выделенные ресурсы.

Примечание: При уничтожении последнего подключения деструктор неявно вызывает close() для освобождения подключения к базе данных.

См. также close().

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

Добавляет базу данных в список подключений к базам данных, используя драйвер type и имя подключения connectionName. Если уже существует подключение к базе данных с именем connectionName, это подключение удаляется.

Подключение к базе данных обозначается именем connectionName. Возвращается вновь добавленное подключение к базе данных.

Если type недоступен или не может быть загружен, isValid() возвращает false.

Если connectionName не указан, новое подключение становится подключением по умолчанию для приложения, и последующие вызовы database() без аргумента имени подключения вернут подключение по умолчанию. Если connectionName указан, используйте database(connectionName) для получения подключения.

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

Перед использованием подключения оно должно быть инициализировано. Например, вызовите некоторые или все из setDatabaseName(), setUserName(), setPassword(), setHostName(), setPort() и setConnectOptions(), а затем open().

Примечание: Эта функция безопасна для потоков.

См. также database(), removeDatabase() и Модули потоков и модуль SQL.

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

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

#include "qtdir/src/sql/drivers/psql/qsql_psql.cpp"

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");
...

Вышеприведенный код настраивает подключение к PostgreSQL и создаёт объект QPSQLDriver. Затем вызывается addDatabase(), чтобы добавить подключение в список известных подключений, что позволит использовать его классами Qt SQL. Если драйвер создаётся с дескриптором подключения (или набором дескрипторов), Qt предполагает, что вы уже открыли подключение к базе данных.

Примечание: Мы предполагаем, что qtdir является каталогом, где установлен Qt. Это позволит подключить необходимый код для использования PostgreSQL клиентской библиотеки и для создания объекта QPSQLDriver, при условии, что у вас есть заголовки PostgreSQL в пути поиска включений.

Помните, что вы должны связать своё приложение с клиентской библиотекой базы данных. Убедитесь, что клиентская библиотека находится в пути поиска компоновщика и добавьте такие строки в свой файл .pro:

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

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

Имя хоста (или имя службы) требуется при создании QTDSDriver для создания новых подключений для внутренних запросов. Это предотвращает блокировку при одновременном использовании нескольких объектов QSqlQuery.

Предупреждение: Добавление подключения к базе данных с тем же именем подключения, что и существующее подключение, приводит к замене существующего подключения новым.

Предупреждение: Фреймворк SQL принимает на себя владение драйвером. Его нельзя удалять. Чтобы удалить подключение, используйте removeDatabase().

См. также drivers().

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

Клонирует подключение к базе данных other и сохраняет его как connectionName. Все настройки из исходной базы данных, например databaseName(), hostName() и т.д., копируются. Ничего не делает, если other — некорректная база данных. Возвращает новое подключение к базе данных.

Примечание: Новое подключение не открыто. Перед использованием нового подключения необходимо вызвать open().

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

Это перегруженный метод.

Клонирует подключение к базе данных other и сохраняет его как connectionName. Все настройки из исходной базы данных, например databaseName(), hostName() и т.д., копируются. Ничего не делает, если other — некорректная база данных. Возвращает новое подключение к базе данных.

Примечание: Новое подключение не открыто. Перед использованием нового подключения необходимо вызвать open().

Этот перегруз полезен при клонировании базы данных в другом потоке, отличном от потока, используемого базой данных, представленной other.

Эта функция была добавлена в Qt 5.13.

void QSqlDatabase::close()

Закрывает подключение к базе данных, освобождая все ресурсы и делая недействительными все существующие объекты QSqlQuery, используемые с базой данных.

Это также повлияет на копии этого объекта QSqlDatabase.

См. также removeDatabase().

bool QSqlDatabase::commit()

Выполняет фиксацию транзакции в базе данных, если драйвер поддерживает транзакции и была начата транзакция transaction(). Возвращает true , если операция выполнена успешно. В противном случае возвращает false.

Примечание: Для некоторых баз данных фиксация транзакции может завершиться ошибкой и вернуть false , если существует активный запрос, использующий базу данных в SELECT. Сделайте запрос неактивным перед выполнением фиксации.

Вызовите lastError(), чтобы получить информацию об ошибках.

См. также QSqlQuery::isActive(), QSqlDriver::hasFeature() и rollback().

QString QSqlDatabase::connectOptions() const

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

См. также setConnectOptions().

QString QSqlDatabase::connectionName() const

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

Примечание: Имя подключения не является именем базы данных.

Эта функция была добавлена в Qt 4.4.

См. также addDatabase().

[static] QStringList QSqlDatabase::connectionNames()

Возвращает список, содержащий имена всех подключений.

Примечание: Эта функция потокобезопасна.

См. также contains(), database() и Потоки и модуль SQL.

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

Возвращает true , если список подключений к базам данных содержит connectionName; в противном случае возвращает false.

Примечание: Эта функция потокобезопасна.

См. также connectionNames(), database() и Потоки и модуль SQL.

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

Возвращает подключение к базе данных под названием connectionName. Подключение к базе данных должно быть добавлено ранее с помощью addDatabase(). Если open равно true (по умолчанию) и подключение к базе данных ещё не открыто, оно открывается сейчас. Если connectionName не указано, используется значение по умолчанию. Если connectionName не найдено в списке баз данных, возвращается некорректное подключение.

Примечание: Эта функция потокобезопасна.

См. также isOpen() и Потоки и модуль SQL.

QString QSqlDatabase::databaseName() const

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

Примечание: Имя базы данных не является именем подключения.

См. также setDatabaseName().

QSqlDriver *QSqlDatabase::driver() const

Возвращает драйвер базы данных, используемый для доступа к подключению к базе данных.

См. также addDatabase() и drivers().

QString QSqlDatabase::driverName() const

Возвращает имя драйвера подключения.

См. также addDatabase() и driver().

[static] QStringList QSqlDatabase::drivers()

Возвращает список всех доступных драйверов баз данных.

См. также registerSqlDriver().

QSqlQuery QSqlDatabase::exec(const QString &query = QString()) const

Выполняет SQL-запрос в базе данных и возвращает объект QSqlQuery. Используйте lastError(), чтобы получить информацию об ошибке. Если query пустое, возвращается пустой, недействительный запрос, и lastError() не затронут.

См. также QSqlQuery и lastError().

QString QSqlDatabase::hostName() const

Возвращает имя хоста подключения; может быть пустым.

См. также setHostName().

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

Возвращает true , если драйвер с именем name доступен; в противном случае возвращает false.

См. также drivers().

bool QSqlDatabase::isOpen() const

Возвращает true , если подключение к базе данных в настоящее время открыто; в противном случае возвращает false.

bool QSqlDatabase::isOpenError() const

Возвращает true , если при открытии подключения к базе данных произошла ошибка; в противном случае возвращает false. Информацию об ошибке можно получить с помощью функции lastError().

bool QSqlDatabase::isValid() const

Возвращает true , если у QSqlDatabase есть допустимый драйвер.

Пример:

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

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

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

QSqlError QSqlDatabase::lastError() const

Возвращает информацию о последней ошибке, произошедшей в базе данных.

Ошибки, возникающие в связи с отдельным запросом, сообщаются QSqlQuery::lastError().

См. также QSqlError и QSqlQuery::lastError().

QSql::NumericalPrecisionPolicy QSqlDatabase::numericalPrecisionPolicy() const

Возвращает текущую политику точности для подключения к базе данных.

Эта функция была добавлена в Qt 4.6.

См. также QSql::NumericalPrecisionPolicy, setNumericalPrecisionPolicy(), QSqlQuery::numericalPrecisionPolicy(), и QSqlQuery::setNumericalPrecisionPolicy().

bool QSqlDatabase::open()

Открывает подключение к базе данных, используя текущие значения подключения. Возвращает true при успехе; в противном случае возвращает false. Информацию об ошибке можно получить с помощью lastError().

См. также lastError(), setDatabaseName(), setUserName(), setPassword(), setHostName(), setPort() и setConnectOptions().

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

Это перегруженная функция.

Открывает подключение к базе данных с использованием указанного имени пользователя user и пароля password. Возвращает true при успехе; в противном случае возвращает false. Информацию об ошибке можно получить с помощью функции lastError().

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

См. также lastError().

QString QSqlDatabase::password() const

Возвращает пароль подключения. Пустая строка будет возвращена, если пароль не был задан с помощью setPassword() и если пароль не был передан в вызове open() или если пароль не использовался.

См. также setPassword().

int QSqlDatabase::port() const

Возвращает номер порта подключения. Значение неопределено, если номер порта не был задан.

См. также setPort().

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

Возвращает первичный индекс для таблицы tablename. Если первичный индекс не существует, возвращается пустой QSqlIndex.

Примечание: Некоторые драйверы, такие как драйвер QPSQL, могут потребовать передачи tablename в нижнем регистре, если таблица не была заключена в кавычки при создании. См. документацию по драйверам Qt SQL для получения дополнительной информации.

См. также tables() и record().

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

Возвращает QSqlRecord, заполненную именами всех полей в таблице (или представлении) с именем tablename. Порядок, в котором поля появляются в записи, не определен. Если такая таблица (или представление) не существует, возвращается пустая запись.

Примечание: Некоторые драйверы, такие как драйвер QPSQL, могут потребовать передачи tablename в нижнем регистре, если таблица не была заключена в кавычки при создании. См. документацию по драйверам Qt SQL для получения дополнительной информации.

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

Эта функция регистрирует новый SQL-драйвер под именем name в рамках SQL-фреймворка. Это полезно, если у вас есть пользовательский SQL-драйвер, и вы не хотите компилировать его как плагин.

Пример:

QSqlDatabase::registerSqlDriver("MYDRIVER",
                                new QSqlDriverCreator<MyDatabaseDriver>);
QSqlDatabase db = QSqlDatabase::addDatabase("MYDRIVER");

QSqlDatabase принимает владение указателем creator, поэтому вам не нужно удалять его самостоятельно.

См. также drivers().

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

Удаляет подключение к базе данных connectionName из списка подключений к базам данных.

Предупреждение: При вызове этой функции не должно быть открытых запросов к базе данных, иначе произойдет утечка ресурсов.

Пример:

// 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

Правильный способ сделать это:

{
    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

Чтобы удалить подключение по умолчанию, которое может быть создано с помощью вызова addDatabase() без указания имени подключения, вы можете получить имя подключения по умолчанию, вызвав connectionName() на базе данных, возвращенной database(). Обратите внимание, что если база данных по умолчанию не создана, будет возвращена недействительная база данных.

Примечание: Эта функция является потокобезопасной.

См. также database(), connectionName() и Потоки и модуль SQL.

bool QSqlDatabase::rollback()

Отменяет транзакцию в базе данных, если драйвер поддерживает транзакции и была запущена transaction(). Возвращает true , если операция выполнена успешно. В противном случае возвращает false.

Примечание: В некоторых базах данных отмена транзакции завершится неудачей и вернет false , если имеется активный запрос, использующий базу данных для SELECT. Сделайте запрос неактивным перед выполнением отмены транзакции.

Вызовите lastError(), чтобы получить информацию об ошибках.

См. также QSqlQuery::isActive(), QSqlDriver::hasFeature() и commit().

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

Устанавливает параметры, специфичные для базы данных. Это необходимо сделать до открытия подключения, иначе это не повлияет. Другой вариант - закрыть подключение, вызвать QSqlDatabase::setConnectOptions() и снова открыть подключение с помощью open().

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

Примеры:

...
// MySQL connection
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
    ...
}

Дополнительную информацию о различных параметрах см. в документации клиентской библиотеки.

См. также connectOptions().

void QSqlDatabase::setDatabaseName(const QString &name)

Устанавливает имя базы данных подключения на name. Для действия имя базы данных должно быть задано до подключения. В качестве альтернативы, можно закрыть() подключение, установить имя базы данных и вызвать открытие() снова.

Примечание: Имя базы данных — это не имя подключения. Имя подключения должно быть передано в addDatabase() во время создания объекта подключения.

Для драйвера QOCI (Oracle) имя базы данных — это имя службы TNS.

Для драйвера QODBC имя name может быть DSN, файлом DSN (в этом случае файл должен иметь расширение .dsn ), или строкой подключения.

Например, пользователи Microsoft Access могут использовать следующую строку подключения для открытия файла .mdb напрямую вместо создания записи DSN в менеджере ODBC:

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

Значение по умолчанию отсутствует.

См. также databaseName(), setUserName(), setPassword(), setHostName(), setPort(), setConnectOptions(), и open().

void QSqlDatabase::setHostName(const QString &host)

Устанавливает имя хоста подключения на host. Для действия имя хоста должно быть задано до подключения. В качестве альтернативы, можно закрыть() подключение, установить имя хоста и вызвать открытие() снова.

Значение по умолчанию отсутствует.

См. также hostName(), setUserName(), setPassword(), setDatabaseName(), setPort(), setConnectOptions(), и open().

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

Устанавливает политику точности чисел по умолчанию, используемую запросами, созданными по этому подключению к базе данных, на precisionPolicy.

Примечание: драйверы, которые не поддерживают извлечение числовых значений с низкой точностью, проигнорируют политику точности. Вы можете использовать QSqlDriver::hasFeature(), чтобы узнать, поддерживает ли драйвер эту функцию.

Примечание: установка политики точности по умолчанию на precisionPolicy не влияет на текущие активные запросы.

Эта функция была добавлена в Qt 4.6.

См. также QSql::NumericalPrecisionPolicy, numericalPrecisionPolicy(), QSqlQuery::setNumericalPrecisionPolicy(), и QSqlQuery::numericalPrecisionPolicy().

void QSqlDatabase::setPassword(const QString &password)

Устанавливает пароль подключения на password. Для действия пароль должен быть задан до подключения. В качестве альтернативы, можно закрыть() подключение, установить пароль и вызвать открытие() снова.

Значение по умолчанию отсутствует.

Предупреждение: Эта функция хранит пароль в виде обычного текста в Qt. Используйте вызов open() с параметром пароля, чтобы избежать этого поведения.

См. также password(), setUserName(), setDatabaseName(), setHostName(), setPort(), setConnectOptions(), и open().

void QSqlDatabase::setPort(int port)

Устанавливает номер порта подключения на port. Для действия номер порта должен быть задан до подключения. В качестве альтернативы, можно закрыть() подключение, установить номер порта и вызвать открытие() снова.

Значение по умолчанию отсутствует.

См. также port(), setUserName(), setPassword(), setHostName(), setDatabaseName(), setConnectOptions(), и open().

void QSqlDatabase::setUserName(const QString &name)

Устанавливает имя пользователя подключения на name. Для действия имя пользователя должно быть задано до подключения. В качестве альтернативы, можно закрыть() подключение, установить имя пользователя и вызвать открытие() снова.

Значение по умолчанию отсутствует.

См. также userName(), setDatabaseName(), setPassword(), setHostName(), setPort(), setConnectOptions(), и open().

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

Возвращает список таблиц базы данных, системных таблиц и представлений, как указано параметром type.

См. также primaryIndex() и record().

bool QSqlDatabase::transaction()

Начинает транзакцию в базе данных, если драйвер поддерживает транзакции. Возвращает true если операция выполнена успешно. В противном случае возвращает false.

См. также QSqlDriver::hasFeature(), commit(), и rollback().

QString QSqlDatabase::userName() const

Возвращает имя пользователя подключения; может быть пустым.

См. также setUserName().