C++ Sqlite3的使用方法

118 阅读 0 评论 78 点赞

我是靠谱客的博主犹豫路灯，最近开发中收集的这篇文章主要介绍C++ Sqlite3的使用方法，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

｜SQLite3简介

SQLite3只是一个轻型的嵌入式数据库引擎，占用资源非常低，处理速度比Mysql还快，专门用于移动设备上进行适量的数据存取，它只是一个文件，不需要服务器进程。

SQL语句是SQL操作的指令，我们用C/C++访问数据库时，需要用char*即C字符串来保存SQL语句，然后调用相应sqlite3库的函数，传入C字符串，来执行SQL指令。

常用术语：表(table)、字段(column，列，属性)、记录(row，record)。

｜SQL(structured query language)语句

特点：不区分大小写，每条语句后加";"结尾。

关键字：select、insert、update、delete、from、creat、where、desc、order、by、group、table、alter、view、index等，数据库中不能使用关键字命名表和字段。

数据定义语句(DDL：Data Definition Language)

新建表 ⟹ create：create table 表名 (字段名1 字段类型1，字段名2 字段类型2，。。。); create table if not exists 表名 (字段名1 字段类型1，字段名2 字段类型2，。。。);

CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);

删除表 ⟹ drop：dorp table 表名；drop table if exists 表名；

DROP TABLE IF EXISTS t_person;

数据操作语句(DML：Data Manipulation language)

添加表中的数据 ⟹ insert：insert into 表名 (字段1，字段2，。。。) values (字段1的值，字段2的值);字符串内容用单引号。

INSERT INTO t_person (name, age) VALUES ('大明', 22);

修改表中的数据 ⟹ update：update 表名 set 字段1 ＝字段1的值，字段2 ＝字段2的值，。。。;

UPDATE t_person SET name = '小明', age = 10; 
// 把表中name字段的值全部改成小明，age字段的值全部改成10。 

UPDATE t_person SET age = 12 WHERE name = '小明'; 
// 把表中name字段值是小明的age值改为12。

删除表中的数据 ⟹ delete：delete from 表名；delete from 表名 where 字段＝字段值。

DELETE FROM t_person; 
// 删除表中的所有记录。 

　　 DELETE FROM t_person WHERE age = 25;
 // 删除表中字段age等于25的这条记录。 

　　 DELETE FROM t_person WHERE age > 12 AND age < 15;
 // 删除表中年龄大于12且小于15的记录。

数据查询语句(DQL：Data Query Language)

select：select 字段1，字段2，。。。 from 表名；select 字段1，字段2，。。。 from 表名 where 字段＝某值；select * from 表名；(查询所有的字段)
表别名：select 字段1 别名，字段2 别名，。。。from 表名别名；select 字段1 别名，字段2 as 别名，。。。from 表名 as 别名；select 别名.字段1，别名.字段2，。。。from 表名别名；

SELECT name, age FROM t_person WHERE age < 80; 

 　　SELECT * FROM t_person WHERE age < 80; 

　　 SELECT name, age nianling FROM t_person ren WHERE ren.age > 80 AND nianling < 90;

计算记录条数：select count(字段或者*) from 表名；

 SELECT count(name) FROM t_person ren WHERE ren.age > 80; 

　　 SELECT count(*) FROM t_person ren WHERE ren.age > 80;

where：where 字段＝某值；where 字段 is 某值；where 字段 !＝某值；where 字段 is not 某值；where 字段 > 某值；where 字段1 ＝某值1 and 字段2 < 某值2；where 字段1 ＝某值1 or 字段2 > 某值2；
order by：select * from 表名 order by 字段(默认升序)；select * from 表名 order by 字段 desc(降序)；select * from 表名 order by 字段 asc(升序)；select * from 表名 order by 字段1 asc(先按字段1升序)，字段2 desc(再按字段2降序)；

SELECT * FROM t_person WHERE age < 100 ORDER BY age DESC, name ASC; 
// 先按年龄降序，再按名字升序。

limit：select * from 表名 limit 数值1，数值2；分页查询，数值1表示跳过前面多少条，数值2表示取出之后多少条。select * from 表名 limit 数值2；(跳过前面0条，相当于select * from 表名 limit 0，数值2，表示最前面多少条数据)

 SELECT * FROM t_person WHERE age < 100 ORDER BY age DESC, name ASC LIMIT 3, 5;
 // 先筛选，后排序，再分页。

like：模糊查询，select 字段1，字段2，。。。 from 表名 where 字段 like ％某值％；

SELECT * FROM t_person WHERE name like '%明%';

存储类型：integer(整型)、real(浮点型)、text(文本字符串)、blob(二进制数据)。

实际上SQLite是无类型的，建表时声明的类型是为了方便程序员之间的交流，是一种良好的编程规范。

字段约束：

not null：字段的值不能为空。
unique：字段的值必需唯一。
default：指定字段的默认值。
primary key：主键，用来唯一的标识某条记录，相当于记录的身份证。主键可以是一个或多个字段，应由计算机自动生成和管理。主键字段默认包含了not null和unique两个约束。
autoincrement：当主键是integer类型时，应该增加autoincrement约束，能实现主键值的自动增长。

CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL UNIQUE, age integer NOT NULL DEFAULT 30);

外键：利用外键约束可以用来建立表与表之间的联系，一般是一张表的某个字段，引用着另一张表的主键的字段。

创建一个表：

CREATE TABLE IF NOT EXISTS t_class (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL UNIQUE);

创建一个带外键的表：t_student表中有一个叫做fk_student_class的外键，这个外键的作用是让t_student表中的class_id字段引用t_class表中的id字段。

　　 CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL, class_id integer NOT NULL, CONSTRAINT fk_student_class FOREIGN KEY (class_id) REFERENCES t_class(id));

利用外键来查询多张表中的数据：

　　 SELECT t.name t_name, t.age t_age, tc.name c_name FROM t_student t, t_class tc WHERE t.class_id = tc.id;　
// 查询所有学生对应的班级 

　　 SELECT * FROM t_student WHERE class_id = (SELECT id FROM t_class WHERE name = '四班');
 // 查询四班的所有学生

｜C/C++上使用SQLite3

1、配置好C/C++项目环境：导入sqlite3.lib和sqlite3.dll，包含头文件#include <sqlite3.h>。(具体步骤此处不讲，可参考该网页)

2、打开或者创建数据库。

sqlite3 *sql = NULL; // 一个打开的数据库实例
 const char * path = "..../test.db";//某个sql文件的路径

 // 根据文件路径打开数据库连接。如果数据库不存在，则创建。
 // 数据库文件的路径必须以C字符串传入。
 int result = sqlite3_open_v2(path, &sql, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | SQLITE_OPEN_NOMUTEX | SQLITE_OPEN_SHAREDCACHE, NULL);

 if (result == SQLITE_OK) {
 std::clog << "打开数据库连接成功";
 }
 else {
 std::clog << "打开数据库连接失败";
 }

3、执行不返回数据的SQL语句(增、删、改)。

（执行更新、删除语句和执行创表、添加语句基本类似，只需更改sql语句即可。）

const char *sqlSentence = "INSERT INTO t_person(name, age) VALUES('夏明', 22); "; //SQL语句
 sqlite3_stmt *stmt = NULL; //stmt语句句柄

 //进行插入前的准备工作——检查语句合法性
 //-1代表系统会自动计算SQL语句的长度
 int result = sqlite3_prepare_v2(sql, sqlSentence, -1, &stmt, NULL);

 if (result == SQLITE_OK) {
 std::clog<< "添加数据语句OK";
 //执行该语句
 sqlite3_step(stmt);
 }
 else {
 std::clog << "添加数据语句有问题";
 }
 //清理语句句柄，准备执行下一个语句
 sqlite3_finalize(stmt);

4、执行返回数据的SQL语句(查)。

const char *sqlSentence = "SELECT name, age FROM t_person WHERE age < 30;"; //SQL语句
 sqlite3_stmt *stmt = NULL; // stmt语句句柄

 //进行查询前的准备工作——检查语句合法性
 //-1代表系统会自动计算SQL语句的长度
 int result = sqlite3_prepare_v2(sql, sqlSentence, -1, &stmt, NULL);

 if (result == SQLITE_OK) {
 std::clog << "查询语句OK";
 // 每调一次sqlite3_step()函数，stmt语句句柄就会指向下一条记录
 while (sqlite3_step(stmt) == SQLITE_ROW) {
 // 取出第0列字段的值
 const unsigned char *name = sqlite3_column_text(stmt, 0);
 // 取出第1列字段的值
 int age = sqlite3_column_int(stmt, 1);
 //输出相关查询的数据
 std::clog << "name = " << name <<", age = "<< age;
 }
 }
 else {
 std::clog << "查询语句有问题";
 }
 //清理语句句柄，准备执行下一个语句
 sqlite3_finalize(stmt);

5、关闭数据库：sqlite3_close_v2(sqlite3* sql)

 if (sql) {
 sqlite3_close_v2(sql);
 sql = nullptr;
 }

｜SQLite3 库函数总结

1.打开数据库

int sqlite3_open_v2(
const char *filename,　　　// 数据库的文件路径
sqlite3 **ppDb,　　　　　　 // 数据库实例
int flags, 　　　　　　　　 // 标志
const char *zVfs　　　　　 // 使用该数据库的虚拟机的名字，这里我们不需要用，直接NULL
);

其中

flags参数有如下标志：

SQLITE_OPEN_NOMUTEX: 设置数据库连接运行在多线程模式(没有指定单线程模式的情况下)
SQLITE_OPEN_FULLMUTEX：设置数据库连接运行在串行模式。
SQLITE_OPEN_SHAREDCACHE：设置运行在共享缓存模式。
SQLITE_OPEN_PRIVATECACHE：设置运行在非共享缓存模式。
SQLITE_OPEN_READWRITE：指定数据库连接可以读写。
SQLITE_OPEN_CREATE：如果数据库不存在，则创建。

2.检查SQL语句的合法性（查询前的准备）

若语句合法即编译通过，则将语句产生的指令塞进stmt句柄（此时并未执行指令）

int sqlite3_prepare_v2(
 sqlite3 *db,  // 数据库实例
 const char *zSql, // 需要检查的SQL语句
 int nByte,  // SQL语句的最大字节长度
 sqlite3_stmt **ppStmt, // stmt句柄，用来存储SQL stmt指令
 const char **pzTail
);

3.执行stmt句柄（执行存储在stmt句柄的指令）

如果指令能查询到下一行数据，就会返回SQLITE_ROW

如果指令（例如写入数据）不需要返还数据，就会返还SQLITE_DONE

int sqlite3_step(
　　sqlite3_stmt* stmt　　 //stmt句柄
 );

4.利用stmt句柄获得第iCol字段的值（字段的下标从0开始）

//执行完查询句柄后，stmt就会指向查到的数据

//然后可以通过stmt获取相应数据

double sqlite3_column_double(sqlite3_stmt*, int iCol); // 浮点数据
int sqlite3_column_int(sqlite3_stmt*, int iCol); // 整型数据
sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol); // 长整型数据
const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); // 二进制文本数据
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol); // 字符串数据

其他：

清理语句句柄(以便重复使用同一个stmt句柄)

int sqlite3_finalize(
　　sqlite_stmt* stmt　　　　　 //stmt句柄
);

关闭数据库连接

int sqlite3_close_v2(
　　sqlite3 * sql, // 数据库实例
);

直接编译并执行 SQL语句

（不推荐使用：1、没有SQL语法检查 2、每一句SQL语句即使完全一样，也会重新编译执行，对批量指令来说效率不高。）

int sqlite3_exec(
 sqlite3* sql, // 一个打开的数据库实例 
 const char * sqlSentence, // 需要执行的SQL语句
 int (*callback)(void*,int,char**,char**), // SQL语句执行完毕后的回调
 void *,  // 回调函数的第1个参数
 char **errmsg // 错误信息
);

｜额外：使用SQLiteStudio工具来辅佐

SQLiteStudio是一个可视化的数据库管理工具。

通过可视化界面，它可以方便快捷地查看或操作数据库信息。

它是程序sqlite数据调试检查不可或缺的辅助工具。

（界面大概如图：）