一文教你Qt如何操作SQLite數(shù)據(jù)庫

更新時間：2023年03月09日 16:58:05 作者：音視頻開發(fā)老舅

Sqlite 數(shù)據(jù)庫作為 Qt 項目開發(fā)中經(jīng)常使用的一個輕量級的數(shù)據(jù)庫，可以說是兼容性相對比較好的數(shù)據(jù)庫之一。本文為大家介紹了Qt操作SQLite數(shù)據(jù)庫的具體方法，希望對大家有所幫助

1、SQLite 介紹

Sqlite 數(shù)據(jù)庫作為 Qt 項目開發(fā)中經(jīng)常使用的一個輕量級的數(shù)據(jù)庫，可以說是兼容性相對比較好的數(shù)據(jù)庫之一（Sqlite就像Qt的親兒子，如同微軟兼容Access數(shù)據(jù)庫一樣）。Qt5 以上版本可以直接使用（Qt自帶驅(qū)動），是一個輕量級的數(shù)據(jù)庫，概況起來具有以下優(yōu)點(diǎn)：

SQLite 的設(shè)計目的是嵌入式 SQL 數(shù)據(jù)庫引擎，它基于純C語言代碼，已經(jīng)應(yīng)用于非常廣泛的領(lǐng)域內(nèi)。
SQLite 在需要長時間存儲時可以直接讀取硬盤上的數(shù)據(jù)文件（.db），在無須長時間存儲時也可以將整個數(shù)據(jù)庫置于內(nèi)存中，兩者均不需要額外的服務(wù)器端進(jìn)程，即 SQLite 是無須獨(dú)立運(yùn)行的數(shù)據(jù)庫引擎。
源代碼開源，你可以用于任何用途，包括出售它。
零配置 – 無需安裝和管理配置。
不需要配置，不需要安裝，也不需要管理員。
同一個數(shù)據(jù)文件可以在不同機(jī)器上使用，可以在不同字節(jié)序的機(jī)器間自由共享。
支持多種開發(fā)語言，C, C++, PHP, Perl, Java, C#,Python, Ruby等。

2、用法

2.1、準(zhǔn)備

1、引入SQL模塊

在Qt項目文件(.pro文件)中，加入SQL模塊：

QT += sql

2、引用頭文件

在需要使用SQL的類定義中，引用相關(guān)頭文件。例如：

#include <QSqlDatabase>
#include <QSqlError>
#include <QSqlQuery>

2.2、使用

1、建立數(shù)據(jù)庫

QSqlDatabase database;
 
if (QSqlDatabase::contains("qt_sql_default_connection"))
{
    database = QSqlDatabase::database("qt_sql_default_connection");
}
else
{
    // 建立和SQlite數(shù)據(jù)庫的連接
    database = QSqlDatabase::addDatabase("QSQLITE");
    // 設(shè)置數(shù)據(jù)庫文件的名字
    database.setDatabaseName("MyDataBase.db");
}

第一行中，建立了一個 QSqlDatabase 對象，后續(xù)的操作要使用這個對象。

if 語句用來檢查指定的連接（connection）是否存在。這里指定的連接名稱（connection name）是qt_sql_default_connection，這是 Qt 默認(rèn)連接名稱。實際使用時，這個名稱可以任意取。如果判斷此連接已經(jīng)存在，那么 QSqlDatabase::contains() 函數(shù)返回 true。此時，進(jìn)入第一個分支，QSqlDatabase::database() 返回這個連接。

如果這個連接不存在，則進(jìn)入else分支，需要創(chuàng)建連接，并添加數(shù)據(jù)庫。在else分支第一行，addDatabase()的參數(shù)QSQLITE是SQLite對應(yīng)的驅(qū)動名，不能改。而且需要注意的是，addDatabase()的第二個參數(shù)被省略了，第二個參數(shù)的默認(rèn)參數(shù)就是上面提到的Qt默認(rèn)連接名稱 qt_sql_default_connection。如果需要使用自定義的連接名稱（如果程序需要處理多個數(shù)據(jù)庫文件的話就會這樣），則應(yīng)該加入第二個參數(shù)，例如：

database = QSqlDatabase::addDatabase("QSQLITE", "my_sql_connection);

這個時候，如果在另一個地方需要判斷my_sql_connection連接是否存在，就應(yīng)該使用 if (QSqlDatabase::contains("my_sql_connection"))。

else 分支第二行中，setDatabaseName() 的參數(shù)是數(shù)據(jù)庫文件名。如果這個數(shù)據(jù)庫不存在，則會在后續(xù)操作時自動創(chuàng)建；如果已經(jīng)存在，則后續(xù)的操作會在已有的數(shù)據(jù)庫上進(jìn)行。

2、打開數(shù)據(jù)庫

使用 open() 打開數(shù)據(jù)庫，并判斷是否成功。注意，在第一步檢查連接是否存在時，如果連接存在，則在返回這個連接的時候，會默認(rèn)將數(shù)據(jù)庫打開。

if (!database.open())
{
    qDebug() << "Error: Failed to connect database." << database.lastError();
}
else
{
    // do something
}

如果打開數(shù)據(jù)庫成功，則進(jìn)入else分支。對數(shù)據(jù)庫的操作都需要在else分支中進(jìn)行。

3、關(guān)閉數(shù)據(jù)庫

數(shù)據(jù)庫操作完成后，最好關(guān)閉。

database.close();

4、操作數(shù)據(jù)庫

對數(shù)據(jù)庫進(jìn)行操作需要用到 QSqlQuery 類，操作前必須定義一個對象。下面舉例說明操作方法。操作需要使用 SQL 語句，本文中的幾個例子會使用幾個常用的語句，關(guān)于 SQL 語句的具體信息可以參考我的另一篇博客：[SQL必知必會] 讀書筆記。

例1：創(chuàng)建表格

創(chuàng)建一個名為student的表格，表格包含三列，第一列是id，第二列是名字，第三列是年齡。

// 用于執(zhí)行sql語句的對象
QSqlQuery sqlQuery;
// 構(gòu)建創(chuàng)建數(shù)據(jù)庫的sql語句字符串
QString createSql = QString("CREATE TABLE student (\
                          id INT PRIMARY KEY NOT NULL,\
                          name TEXT NOT NULL,\
                          age INT NOT NULL)");
sqlQuery.prepare(createSql);
// 執(zhí)行sql語句
if(!sqlQuery.exec())
{
    qDebug() << "Error: Fail to create table. " << sqlQuery.lastError();
}
else
{     qDebug() << "Table created!";
}

第一行定義一個 QSqlQuery 對象。

第二行是一個 QString，其中的內(nèi)容是 SQLite 語句。對數(shù)據(jù)庫的操作，都是用 SQLite 的語句完成的，把這些指令以 QString 類型，通過 prepare 函數(shù)，保存在 QSqlQuery 對象中。也可將指令，以 QString 形式直接寫在 exec() 函數(shù)的參數(shù)中，例如：

sql_query.exec("CREATE TABLE student (ID INT PRIMARY KEY NOT NULL, ...)");

如果 sql_query.exec() 執(zhí)行成功，則創(chuàng)建表格成功。

例2：插入單行數(shù)據(jù)

在剛才創(chuàng)建的表格中，插入單行數(shù)據(jù)。

// 方法一：使用 bindValue 函數(shù)插入單行數(shù)據(jù)
QSqlQuery sqlQuery;
sqlQuery.prepare("INSERT INTO student VALUES(:id,:name,:age)");
sqlQuery.bindValue(":id", max_id + 1);
sqlQuery.bindValue(":name", "Wang");
sqlQuery.bindValue(":age", 25);
if(!sqlQuery.exec())
{
    qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();
}
else
{
    // do something    
}
 
// 方法二：使用 addBindValue 函數(shù)插入單行數(shù)據(jù)
QSqlQuery sqlQuery;
sqlQuery.prepare("INSERT INTO student VALUES(?, ?, ?)");
sqlQuery.addBindValue(max_id + 1);
sqlQuery.addBindValue("Wang");
sqlQuery.addBindValue(25);
if(!sqlQuery.exec())
{
    qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();
}
else
{
    // do something    
}
 
// 方法三：直接寫出完整語句
if(!sql_query.exec("INSERT INTO student VALUES(3, \"Li\", 23)"))
{
    qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();
}
else
{
    // do something 
}

例3：查詢?nèi)繑?shù)據(jù)

QSqlQuery sqlQuery;
sqlQuery.exec("SELECT * FROM student");
if(!sqlQuery.exec())
{
    qDebug() << "Error: Fail to query table. " << sqlQuery.lastError();
}
else
{
    while(sqlQuery.next())
    {
        int id = sqlQuery.value(0).toInt();
        QString name = sqlQuery.value(1).toString();
        int age = sqlQuery.value(2).toInt();
        qDebug()<<QString("id:%1    name:%2    age:%3").arg(id).arg(name).arg(age);
    }
}

例4：更新數(shù)據(jù)（修改數(shù)據(jù)）

QSqlQuery sqlQuery;
sqlQuery.prepare("UPDATE student SET name=?,age=? WHERE id=?");
sqlQuery.addBindValue(name);
sqlQuery.addBindValue(age);
sqlQuery.addBindValue(id);
if(!sqlQuery.exec())
{
    qDebug() << sqlQuery.lastError();
}
else
{
    qDebug() << "updated data success!";
}

3、完整示例程序

上面只是列舉了幾個常用的SQL語句例子，下面貼出一個完整示例程序：

SqliteOperator.h

#ifndef SQLITEOPERATOR_H
#define SQLITEOPERATOR_H
 
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>
#include <QDebug>
 
typedef struct
{
    int id;
    QString name;
    int age;
}w2dba;
 
class SqliteOperator
{
public:
    SqliteOperator();
 
    // 打開數(shù)據(jù)庫
    bool openDb(void);
    // 創(chuàng)建數(shù)據(jù)表
    void createTable(void);
    // 判斷數(shù)據(jù)表是否存在
    bool isTableExist(QString& tableName);
    // 查詢?nèi)繑?shù)據(jù)
    void queryTable();
    // 插入數(shù)據(jù)
    void singleInsertData(w2dba &singleData); // 插入單條數(shù)據(jù)
    void moreInsertData(QList<w2dba> &moreData); // 插入多條數(shù)據(jù)
    // 修改數(shù)據(jù)
    void modifyData(int id, QString name, int age);
    // 刪除數(shù)據(jù)
    void deleteData(int id);
    //刪除數(shù)據(jù)表
    void deleteTable(QString& tableName);
    // 關(guān)閉數(shù)據(jù)庫
    void closeDb(void);
 
private:
    QSqlDatabase database;// 用于建立和數(shù)據(jù)庫的連接
};
 
#endif //  SQLITEOPERATOR_H

SqliteOperator.cpp

#include "sqliteoperator.h"
 
// 構(gòu)造函數(shù)中初始化數(shù)據(jù)庫對象，并建立數(shù)據(jù)庫
SqliteOperator::SqliteOperator()
{
    if (QSqlDatabase::contains("qt_sql_default_connection"))
    {
        database = QSqlDatabase::database("qt_sql_default_connection");
    }
    else
    {
        // 建立和SQlite數(shù)據(jù)庫的連接
        database = QSqlDatabase::addDatabase("QSQLITE");
        // 設(shè)置數(shù)據(jù)庫文件的名字
        database.setDatabaseName("MyDataBase.db");
    }
}
 
// 打開數(shù)據(jù)庫
bool SqliteOperator::openDb()
{
    if (!database.open())
    {
        qDebug() << "Error: Failed to connect database." << database.lastError();
    }
    else
    {
        // do something
    }
 
    return true;
}
 
// 創(chuàng)建數(shù)據(jù)表
void SqliteOperator::createTable()
{
    // 用于執(zhí)行sql語句的對象
    QSqlQuery sqlQuery;
    // 構(gòu)建創(chuàng)建數(shù)據(jù)庫的sql語句字符串
    QString createSql = QString("CREATE TABLE student (\
                          id INT PRIMARY KEY NOT NULL,\
                          name TEXT NOT NULL,\
                          age INT NOT NULL)");
    sqlQuery.prepare(createSql);
    // 執(zhí)行sql語句
    if(!sqlQuery.exec())
    {
        qDebug() << "Error: Fail to create table. " << sqlQuery.lastError();
    }
    else
    {
        qDebug() << "Table created!";
    }
}
 
// 判斷數(shù)據(jù)庫中某個數(shù)據(jù)表是否存在
bool SqliteOperator::isTableExist(QString& tableName)
{
    QSqlDatabase database = QSqlDatabase::database();
    if(database.tables().contains(tableName))
    {
        return true;
    }
 
    return false;
}
 
// 查詢?nèi)繑?shù)據(jù)
void SqliteOperator::queryTable()
{
    QSqlQuery sqlQuery;
    sqlQuery.exec("SELECT * FROM student");
    if(!sqlQuery.exec())
    {
        qDebug() << "Error: Fail to query table. " << sqlQuery.lastError();
    }
    else
    {
        while(sqlQuery.next())
        {
            int id = sqlQuery.value(0).toInt();
            QString name = sqlQuery.value(1).toString();
            int age = sqlQuery.value(2).toInt();
            qDebug()<<QString("id:%1    name:%2    age:%3").arg(id).arg(name).arg(age);
        }
    }
}
 
// 插入單條數(shù)據(jù)
void SqliteOperator::singleInsertData(w2dba &singledb)
{
    QSqlQuery sqlQuery;
    sqlQuery.prepare("INSERT INTO student VALUES(:id,:name,:age)");
    sqlQuery.bindValue(":id", singledb.id);
    sqlQuery.bindValue(":name", singledb.name);
    sqlQuery.bindValue(":age", singledb.age);
    if(!sqlQuery.exec())
    {
        qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();
    }
    else
    {
        // do something
    }
}
 
// 插入多條數(shù)據(jù)
void SqliteOperator::moreInsertData(QList<w2dba>& moredb)
{
    // 進(jìn)行多個數(shù)據(jù)的插入時，可以利用綁定進(jìn)行批處理
    QSqlQuery sqlQuery;
    sqlQuery.prepare("INSERT INTO student VALUES(?,?,?)");
    QVariantList idList,nameList,ageList;
    for(int i=0; i< moredb.size(); i++)
    {
        idList <<  moredb.at(i).id;
        nameList << moredb.at(i).name;
        ageList << moredb.at(i).age;
    }
    sqlQuery.addBindValue(idList);
    sqlQuery.addBindValue(nameList);
    sqlQuery.addBindValue(ageList);
 
    if (!sqlQuery.execBatch()) // 進(jìn)行批處理，如果出錯就輸出錯誤
    {
        qDebug() << sqlQuery.lastError();
    }
}
 
// 修改數(shù)據(jù)
void SqliteOperator::modifyData(int id, QString name, int age)
{
    QSqlQuery sqlQuery;
    sqlQuery.prepare("UPDATE student SET name=?,age=? WHERE id=?");
    sqlQuery.addBindValue(name);
    sqlQuery.addBindValue(age);
    sqlQuery.addBindValue(id);
    if(!sqlQuery.exec())
    {
        qDebug() << sqlQuery.lastError();
    }
    else
    {
        qDebug() << "updated data success!";
    }
}
 
// 刪除數(shù)據(jù)
void SqliteOperator::deleteData(int id)
{
    QSqlQuery sqlQuery;
 
    sqlQuery.exec(QString("DELETE FROM student WHERE id = %1").arg(id));
    if(!sqlQuery.exec())
    {
        qDebug()<<sqlQuery.lastError();
    }
    else
    {
        qDebug()<<"deleted data success!";
    }
}
 
//刪除數(shù)據(jù)表
void SqliteOperator::deleteTable(QString& tableName)
{
    QSqlQuery sqlQuery;
 
    sqlQuery.exec(QString("DROP TABLE %1").arg(tableName));
    if(sqlQuery.exec())
    {
        qDebug() << sqlQuery.lastError();
    }
    else
    {
        qDebug() << "deleted table success";
    }
}
 
void SqliteOperator::closeDb(void)
{
    database.close();
}

main.cpp

#include <QCoreApplication>
#include "sqliteoperator.h"
#include <QString>
 
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
 
    //創(chuàng)建并打開SQLite數(shù)據(jù)庫
    SqliteOperator sqlTest;
    sqlTest.openDb();
 
    // 創(chuàng)建數(shù)據(jù)表
    sqlTest.createTable();
 
    // 判斷數(shù)據(jù)表是否存在
    QString str1 = QString("student");
    qDebug() << "isTabelExist：" <<sqlTest.isTableExist(str1);
 
    // 插入單條數(shù)據(jù)
    w2dba w2dbaTest1 = {1, "zhangSan", 24};
    w2dba w2dbaTest2 = {2, "lisi", 28};
    sqlTest.singleInsertData(w2dbaTest1);
    sqlTest.singleInsertData(w2dbaTest2);
 
    // 插入多條數(shù)據(jù)
    QList<w2dba> list;
    w2dba w2dbaTest3 = {3, "liwu", 26};
    w2dba w2dbaTest4 = {4, "niuer", 27};
    list.append(w2dbaTest3);
    list.append(w2dbaTest4);
    sqlTest.moreInsertData(list);
    // 查詢?nèi)繑?shù)據(jù)
    sqlTest.queryTable();
    qDebug() << endl;
 
    // 修改數(shù)據(jù)
    sqlTest.modifyData(2, "modify", 10);
    // 查詢?nèi)繑?shù)據(jù)
    sqlTest.queryTable();
    qDebug() << endl;
 
    // 刪除數(shù)據(jù)
    sqlTest.deleteData(2);
    // 查詢?nèi)繑?shù)據(jù)
    sqlTest.queryTable();
    qDebug() << endl;
 
    // 刪除數(shù)據(jù)表
    QString str2 = QString("student");
    sqlTest.deleteTable(str2);
 
    //關(guān)閉數(shù)據(jù)庫
    sqlTest.closeDb();
 
    return a.exec();
}

運(yùn)行結(jié)果如下：

Table created!
isTabelExist： true
"id:1 name:zhangSan age:24"
"id:2 name:lisi age:28"
"id:3 name:liwu age:26"
"id:4 name:niuer age:27"

updated data success!
"id:1 name:zhangSan age:24"
"id:2 name:modify age:10"
"id:3 name:liwu age:26"
"id:4 name:niuer age:27"

deleted data success!
"id:1 name:zhangSan age:24"
"id:3 name:liwu age:26"
"id:4 name:niuer age:27"

deleted table success