linux c编程操作数据库(sqlite3应用)
C/C++语言中调用 sqlite 的函数接口来实现对数据库的管理(创建数据库、创建表格、插入数据、查询、数据、删除数据等)。
首先要编译好
sqlite的库文件 :
libsqlite3.a libsqlite3.la libsqlite3.so libsqlite3.so.0 libsqlite3.so.0.8.6 pkgconfig
可执行文件 :
sqlite3
本次测试:
sqlite3的库文件目录是:/usr/local/lib
可执行文件 sqlite3 的目录是: /usr/local/bin
头文件 sqlite3.h 的目录是: /usr/local/include
用ls命令查看如下:
[root@localhost config]# ls /usr/local/lib
libclamav.a libclamunrar_iface.a libclamunrar.so libsqlite3.so
libclamav.la libclamunrar_iface.la libclamunrar.so.5 libsqlite3.so.0
libclamav.so libclamunrar_iface.so libclamunrar.so.5.0.3 libsqlite3.so.0.8.6
libclamav.so.5 libclamunrar_iface.so.5 libmstring.so pkgconfig
libclamav.so.5.0.3 libclamunrar_iface.so.5.0.3 libsqlite3.a
libclamunrar.a libclamunrar.la libsqlite3.la
此目录下包含库文件:
libsqlite3.a libsqlite3.la libsqlite3.so libsqlite3.so.0 libsqlite3.so.0.8.6 pkgconfig
开始sqlite编程:
1. 下面是一个C程序的例子,显示怎么使用 sqlite 的 C/C++ 接口. 数据库的名字由第一个参数取得且第个参数或更多的参数是 SQL 执行语句.
这个函数调用sqlite3_open() 打开数据库,并且调用sqlite3_close() 关闭数据库连接。
程序一:opendbslite.c:
- #include <stdio.h>
- #include <stdlib.h>
- #include <sqlite3.h>
- int main( void )
- {
- sqlite3 *db=NULL;
- char *zErrMsg = 0;
- int rc;
- //打开指定的数据库文件,如果不存在将创建一个同名的数据库文件
- rc = sqlite3_open("zieckey.db", &db);
- if( rc )
- {
- fprintf(stderr, "Can't open database: %s/n", sqlite3_errmsg(db));
- sqlite3_close(db);
- exit(1);
- }
- else printf("You have opened a sqlite3 database named zieckey.db successfully!/nCongratulations! Have fun ! ^-^ /n");
- sqlite3_close(db); //关闭数据库
- return 0;
- }
编译(问题):
[root@localhost liuxltest]# gcc -o opendbsqlite opendbsqlite.c
/tmp/ccuquUQN.o: In function `main':
opendbsqlite.c:(.text+0x2e): undefined reference to `sqlite3_open'
opendbsqlite.c:(.text+0x42): undefined reference to `sqlite3_errmsg'
opendbsqlite.c:(.text+0x67): undefined reference to `sqlite3_close'
opendbsqlite.c:(.text+0x8a): undefined reference to `sqlite3_close'
collect2: ld returned 1 exit status
编译(解决):
出现上述问题是因为没有找到库文件的问题。
由于用到了用户自己的库文件,所用应该指明所用到的库,我们可以这样编译:
[root@localhost liuxltest]# gcc -o opendbsqlite opendbsqlite.c -lsqlite3
用 -lsqlite3 选项就可以了(前面我们生成的库文件是 libsqlite3.so.0.8.6 等,去掉前面的lib和后面的版本标志,就剩下 sqlite3 了所以是 -lsqlite3 )
执行:
[root@localhost liuxltest]# ./opendbsqlite
You have opened a sqlite3 database named zieckey.db successfully!
Congratulations! Have fun ! ^-^
[root@localhost liuxltest]#
2. 插入 :insert
在C语言中向数据库插入数据:
sqlite3_exec的函数原型说明如下:
int sqlite3_exec(
sqlite3*, /* An open database */
const char *sql, /* SQL to be executed */
sqlite_callback, /* Callback function */
void *, /* 1st argument to callback function */
char **errmsg /* Error msg written here */
);
程序二:insert.c:
- #include <stdio.h>
- #include <stdlib.h>
- #include "sqlite3.h"
- #define _DEBUG_
- int main( void )
- {
- sqlite3 *db=NULL;
- char *zErrMsg = 0;
- int rc;
- rc = sqlite3_open("zieckey.db", &db); //打开指定的数据库文件,如果不存在将创建一个同名的数据库文件
- if( rc )
- {
- fprintf(stderr, "Can't open database: %s/n", sqlite3_errmsg(db));
- sqlite3_close(db);
- exit(1);
- }
- else printf("You have opened a sqlite3 database named zieckey.db successfully!/nCongratulations! Have fun ! ^-^ /n");
- //创建一个表,如果该表存在,则不创建,并给出提示信息,存储在 zErrMsg 中
- char *sql = " CREATE TABLE SensorData( /
- ID INTEGER PRIMARY KEY, /
- SensorID INTEGER, /
- SiteNum INTEGER, /
- Time VARCHAR(12), /
- SensorParameter REAL /
- );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- #ifdef _DEBUG_
- printf("%s/n",zErrMsg);
- #endif
- //插入数据
- char* sql1 = "INSERT INTO /"SensorData/" VALUES( NULL , 1 , 1 , '200605011206', 18.9 );" ;
- sqlite3_exec( db , sql1 , 0 , 0 , &zErrMsg );
- char* sql2 = "INSERT INTO /"SensorData/" VALUES( NULL , 1 , 1 , '200605011306', 16.4 );" ;
- sqlite3_exec( db , sql2 , 0 , 0 , &zErrMsg );
- sqlite3_close(db); //关闭数据库
- return 0;
- }
编译运行:
[root@localhost liuxltest]# gcc -o insert insert.c -lsqlite3
[root@localhost liuxltest]# ./insert
You have opened a sqlite3 database named zieckey.db successfully!
Congratulations! Have fun ! ^-^
(null)
(null)
(null)
[root@localhost liuxltest]#
查看是否插入数据:
[root@localhost liuxltest]# /usr/local/bin/sqlite3 zieckey.db "select * from SensorData"
3. 查询: SELETE
C语言中查询数据库中的数据。
函数接口sqlite3_get_table( db , sql , &azResult , &nrow , &ncolumn , &zErrMsg );
解释:
int sqlite3_get_table(sqlite3*, const char *sql,char***result , int *nrow , int *ncolumn ,char **errmsg );
result中是以数组的形式存放你所查询的数据,首先是表名,再是数据。
nrow ,ncolumn分别为查询语句返回的结果集的行数,列数,没有查到结果时返回0
程序三:query.c:
- #include <stdio.h>
- #include <stdlib.h>
- #include "sqlite3.h"
- #define _DEBUG_
- int main( void )
- {
- sqlite3 *db=NULL;
- char *zErrMsg = 0;
- int rc;
- rc = sqlite3_open("zieckey.db", &db); //打开指定的数据库文件,如果不存在将创建一个同名的数据库文件
- if( rc )
- {
- fprintf(stderr, "Can't open database: %s/n", sqlite3_errmsg(db));
- sqlite3_close(db);
- exit(1);
- }
- else printf("You have opened a sqlite3 database named zieckey.db successfully!/nCongratulations! Have fun ! ^-^ /n");
- //创建一个表,如果该表存在,则不创建,并给出提示信息,存储在 zErrMsg 中
- char *sql = " CREATE TABLE SensorData( /
- ID INTEGER PRIMARY KEY, /
- SensorID INTEGER, /
- SiteNum INTEGER, /
- Time VARCHAR(12), /
- SensorParameter REAL /
- );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- #ifdef _DEBUG_
- printf("zErrMsg = %s /n", zErrMsg);
- #endif
- //插入数据
- sql = "INSERT INTO /"SensorData/" VALUES(NULL , 1 , 1 , '200605011206', 18.9 );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- sql = "INSERT INTO /"SensorData/" VALUES(NULL , 1 , 1 , '200605011306', 16.4 );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- int nrow = 0, ncolumn = 0;
- char **azResult; //二维数组存放结果
- //查询数据
- /*
- int sqlite3_get_table(sqlite3*, const char *sql,char***result , int *nrow , int *ncolumn ,char **errmsg );
- result中是以数组的形式存放你所查询的数据,首先是表名,再是数据。
- nrow ,ncolumn分别为查询语句返回的结果集的行数,列数,没有查到结果时返回0
- */
- sql = "SELECT * FROM SensorData ";
- sqlite3_get_table( db , sql , &azResult , &nrow , &ncolumn , &zErrMsg );
- int i = 0 ;
- printf( "row:%d column=%d /n" , nrow , ncolumn );
- printf( "/nThe result of querying is : /n" );
- for( i=0 ; i<( nrow + 1 ) * ncolumn ; i++ )
- printf( "azResult[%d] = %s/n", i , azResult[i] );
- //释放掉 azResult 的内存空间
- sqlite3_free_table( azResult );
- #ifdef _DEBUG_
- printf("zErrMsg = %s /n", zErrMsg);
- #endif
- sqlite3_close(db); //关闭数据库
- return 0;
- }
这里用到了一个查询的语句是 "SELECT * FROM SensorData " ,
编译运行:
[root@localhost liuxltest]# gcc -o query query.c -lsqlite3
[root@localhost liuxltest]# ./query
You have opened a sqlite3 database named zieckey.db successfully!
Congratulations! Have fun ! ^-^
zErrMsg = (null)
row:2 column=5
The result of querying is :
azResult[0] = ID
azResult[1] = SensorID
azResult[2] = SiteNum
azResult[3] = Time
azResult[4] = SensorParameter
azResult[5] = 1
azResult[6] = 1
azResult[7] = 1
azResult[8] = 200605011206
azResult[9] = 18.9
azResult[10] = 2
azResult[11] = 1
azResult[12] = 1
azResult[13] = 200605011306
azResult[14] = 16.4
zErrMsg = (null)
[root@localhost liuxltest]#
这里我们可以看到,azResult 的前面 5 个数据正好是我们的表 SensorData 的列属性,之后才是我们要查询的数据。所以我们的程序中才有 i<( nrow + 1 ) * ncolumn 的判断条件:
for( i=0 ; i<( nrow + 1 ) * ncolumn ; i++ )
printf( "azResult[%d] = %s/n", i , azResult[i] );
输出中有 zErrMsg = (null) 这样的字句,这是 zErrMsg 保留的错误信息,正如你所看到的,zErrMsg 为空,表明在执行过程中没有错误信息。
4. 删除:delete
C语言中删除数据库中的特定的数据。
程序四: delete.c:
- #include <stdio.h>
- #include <stdlib.h>
- #include "sqlite3.h"
- #define _DEBUG_
- int main( void )
- {
- sqlite3 *db=NULL;
- char *zErrMsg = 0;
- int rc;
- rc = sqlite3_open("zieckey.db", &db); //打开指定的数据库文件,如果不存在将创建一个同名的数据库文件
- if( rc )
- {
- fprintf(stderr, "Can't open database: %s/n", sqlite3_errmsg(db));
- sqlite3_close(db);
- exit(1);
- }
- else printf("You have opened a sqlite3 database named zieckey.db successfully!/nCongratulations! Have fun ! ^-^ /n");
- //创建一个表,如果该表存在,则不创建,并给出提示信息,存储在 zErrMsg 中
- char *sql = " CREATE TABLE SensorData( /
- ID INTEGER PRIMARY KEY, /
- SensorID INTEGER, /
- SiteNum INTEGER, /
- Time VARCHAR(12), /
- SensorParameter REAL /
- );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- #ifdef _DEBUG_
- printf("zErrMsg = %s /n", zErrMsg);
- #endif
- //插入数据
- sql = "INSERT INTO /"SensorData/" VALUES(NULL , 1 , 1 , '200605011206', 18.9 );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- sql = "INSERT INTO /"SensorData/" VALUES(NULL , 23 , 45 , '200605011306', 16.4 );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- sql = "INSERT INTO /"SensorData/" VALUES(NULL , 34 , 45 , '200605011306', 15.4 );" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- int nrow = 0, ncolumn = 0;
- char **azResult; //二维数组存放结果
- //查询数据
- sql = "SELECT * FROM SensorData ";
- sqlite3_get_table( db , sql , &azResult , &nrow , &ncolumn , &zErrMsg );
- int i = 0 ;
- printf( "row:%d column=%d /n" , nrow , ncolumn );
- printf( "/nThe result of querying is : /n" );
- for( i=0 ; i<( nrow + 1 ) * ncolumn ; i++ )
- printf( "azResult[%d] = %s/n", i , azResult[i] );
- //删除数据
- sql = "DELETE FROM SensorData WHERE SensorID = 1 ;" ;
- sqlite3_exec( db , sql , 0 , 0 , &zErrMsg );
- #ifdef _DEBUG_
- printf("zErrMsg = %s /n", zErrMsg);
- #endif
- sql = "SELECT * FROM SensorData ";
- sqlite3_get_table( db , sql , &azResult , &nrow , &ncolumn , &zErrMsg );
- printf( "/n/n/n/nrow:%d column=%d " , nrow , ncolumn );
- printf( "/nAfter deleting , the result of querying is : /n" );
- for( i=0 ; i<( nrow + 1 ) * ncolumn ; i++ )
- printf( "azResult[%d] = %s/n", i , azResult[i] );
- //释放掉 azResult 的内存空间
- sqlite3_free_table( azResult );
- #ifdef _DEBUG_
- printf("zErrMsg = %s /n", zErrMsg);
- #endif
- sqlite3_close(db); //关闭数据库
- return 0;
- }
编译运行:
[root@localhost liuxltest]# gcc -o delete delete.c -lsqlite3
[root@localhost liuxltest]# ./delete
You have opened a sqlite3 database named zieckey.db successfully!
Congratulations! Have fun ! ^-^
zErrMsg = (null)
row:3 column=5
The result of querying is :
azResult[0] = ID
azResult[1] = SensorID
azResult[2] = SiteNum
azResult[3] = Time
azResult[4] = SensorParameter
azResult[5] = 1
azResult[6] = 1
azResult[7] = 1
azResult[8] = 200605011206
azResult[9] = 18.9
azResult[10] = 2
azResult[11] = 23
azResult[12] = 45
azResult[13] = 200605011306
azResult[14] = 16.4
azResult[15] = 3
azResult[16] = 34
azResult[17] = 45
azResult[18] = 200605011306
azResult[19] = 15.4
zErrMsg = (null)
row:2 column=5
After deleting , the result of querying is :
azResult[0] = ID
azResult[1] = SensorID
azResult[2] = SiteNum
azResult[3] = Time
azResult[4] = SensorParameter
azResult[5] = 2
azResult[6] = 23
azResult[7] = 45
azResult[8] = 200605011306
azResult[9] = 16.4
azResult[10] = 3
azResult[11] = 34
azResult[12] = 45
azResult[13] = 200605011306
azResult[14] = 15.4
zErrMsg = (null)
[root@localhost liuxltest]#
从程序输出结果就可以看出,在删除数据前,我们有三条记录,删除数据后我们发现,数据库内记录少了。从而实现了我们的删除数据目的。
提示: 编译的使用使用gcc参数-l sqlite3, 如:gcc -l sqlite3 sql.c
#include <stdio.h> #include <sqlite3.h> int main(int argc, char **argv){ // 数据库文件名 char *dbname = "a.db"; // 数据库对象 sqlite3 *db; // 返回值 int rc; // 打开数据库 rc = sqlite3_open(dbname, &db); // 检查错误 if( rc != SQLITE_OK ){ // 打印错误信息 fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db)); // 关闭数据库 sqlite3_close(db); return 1; } // 插入数据 char *sql = "insert into user(username, password) values(?, ?);"; // stmt对象 sqlite3_stmt *stmt_user_insert; // OUT: Pointer to unused portion of zSql const char *tail; // 创建stmt对象 rc = sqlite3_prepare(db, sql, -1, &stmt_user_insert, &tail); // 绑定参数 sqlite3_bind_text(stmt_user_insert, 1, "dotcoo2", -1, SQLITE_STATIC); sqlite3_bind_text(stmt_user_insert, 2, "dotcoo2", -1, SQLITE_STATIC); // 执行语句 rc = sqlite3_step(stmt_user_insert); // 检查错误 if ( rc != SQLITE_DONE ) { fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db)); sqlite3_close(db); return 1; } // 获取最后插入的id printf("insert ok id: %lld\n", sqlite3_last_insert_rowid(db)); // 重置stmt sqlite3_reset(stmt_user_insert); // 释放stmt sqlite3_finalize(stmt_user_insert); // 查询语句 char *sql_user_select = "select * from user"; // 查询的stmt sqlite3_stmt *stmt_user_select; // OUT: Pointer to unused portion of zSql const char *tail_user_select; // 创建stmt对象 rc = sqlite3_prepare(db, sql_user_select, -1, &stmt_user_select, NULL); if ( rc != SQLITE_OK ) { fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db)); sqlite3_close(db); return 1; } // 读取数据 while (sqlite3_step(stmt_user_select) == SQLITE_ROW) { int id = sqlite3_column_int(stmt_user_select, 0); const char *username = sqlite3_column_text(stmt_user_select, 1); const char *password = sqlite3_column_text(stmt_user_select, 2); printf("row: %d, %s, %s\n", id, username, password); } // 重置stmt sqlite3_reset(stmt_user_select); // 释放stmt sqlite3_finalize(stmt_user_select); // 关闭数据库 sqlite3_close(db); return 0;}
创建表语句
CREATE TABLE book (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, price INTEGER, cover TEXT)
sqlite 操作二进制数据需要用一个辅助的数据类型:sqlite3_stmt * 。 这个数据类型 记录了一个“sql语句”。为什么我把 “sql语句” 用双引号引起来?因为你可以把 sqlite3_stmt * 所表示的内容看成是 sql语句,但是实际上它不是我们所熟知的sql语句。它是一个已经把sql语句解析了的、用sqlite自己标记记录的内部数据结构。 正因为这个结构已经被解析了,所以你可以往这个语句里插入二进制数据。当然,把二进制数据插到 sqlite3_stmt 结构里可不能直接 memcpy ,也不能像 std::string 那样用 + 号。必须用 sqlite 提供的函数来插入。 8 E( q3 j! b% JF 1 o1 g: V& O& b8 S% _ s. H- ` : y' z5 y& S; H! W i.1 写入二进制 下面说写二进制的步骤。 ' l5 d$ V/ z' h' e: W + n' a' R9 E* T3 i$ ?0 P' | ] 要插入二进制,前提是这个表的字段的类型是 blob 类型。我假设有这么一张表: 复制内容到剪贴板首先声明 # [2 M. s! [( n; @1 v sqlite3_stmt * stat; - u7 Z# H# B代码:
create table Tbl_2( ID integer, file_content
blob ) H% p0 @6 E2 V; b 然后,把一个 sql 语句解析到 stat 结构里去: 复制内容到剪贴板上面的函数完成 sql 语句的解析。第一个参数跟前面一样,是个 sqlite3 * 类型变量,第二个参数是一个 sql 语句。 这个 sql 语句特别之处在于 values 里面有个 ? 号。在sqlite3_prepare函数里,?号表示一个未定的值,它的值等下才插入。 第三个参数我写的是-1,这个参数含义是前面 sql 语句的长度。如果小于0,sqlite会自动计算它的长度(把sql语句当成以\0结尾的字符串)。 8 w# |5 u0 ~8 }. z' e, a * U/ F5 C" V: l7 X4 N. }2 H3 K 第四个参数是 sqlite3_stmt 的指针的指针。解析以后的sql语句就放在这个结构里。 + f6 n! b; d& ?, n - {# e* E: o7 f# t 第五个参数我也不知道是干什么的。为0就可以了。 如果这个函数执行成功(返回值是 SQLITE_OK 且 stat 不为NULL ),那么下面就可以开始插入二进制数据。代码:
sqlite3_prepare( db, “insert into Tbl_2( ID, file_content) values( 10, ? )”, -1, &stat, 0 );
复制内容到剪贴板这个函数一共有5个参数。 第1个参数:是前面prepare得到的 sqlite3_stmt * 类型变量。 第2个参数:?号的索引。前面 prepare的sql语句里有一个?号,假如有多个?号怎么插入?方法就是改变 bind_blob 函数第2个参数。这个参数我写1,表示这里插入的值要替换 stat 的第一个?号(这里的索引从1开始计数,而非从0开始)。如果你有多个?号,就写多个 bind_blob 语句,并改变它们的第2个参数就替换到不同的?号。如果有?号没有替换,sqlite为它取值null。 4 |+ q5 l) K, a; _ 第3个参数:二进制数据起始指针。 " W, n4 I: Q, L; H$ o, ^; X2 ^ 5 W* I* ^6 i4 Z代码:
sqlite3_bind_blob( stat, 1, pdata, (int)(length_of_data_in_bytes), NULL ); // pdata为数据缓冲区,length_of_data_in_bytes为数据大小,以字节为单位
p7 } 第4个参数:二进制数据的长度,以字节为单位。 0 c+ F& y6 }' f0 V0 G5 k/ H 第5个参数:是个析够回调函数,告诉sqlite当把数据处理完后调用此函数来析够你的数据。这个参数我还没有使用过,因此理解也不深刻。但是一般都填NULL,需要释放的内存自己用代码来释放。 bind完了之后,二进制数据就进入了你的“sql语句”里了。你现在可以把它保存到数据库里: 复制内容到剪贴板通过这个语句,stat 表示的sql语句就被写到了数据库里。 " @3 u0 x* h2 R: s+ E3 a 最后,要把 sqlite3_stmt 结构给释放:代码:
int result = sqlite3_step( stat );
复制内容到剪贴板i.2代码:
sqlite3_finalize( stat ); //把刚才分配的内容析构掉
读出二进制 & Q+ {% F9 I8 J8 N+ S g4 l: s. Q 下面说读二进制的步骤。 4 c, I8 [5 }: d5 O 跟前面一样,先声明 sqlite3_stmt * 类型变量: 复制内容到剪贴板然后,把一个 sql 语句解析到 stat 结构里去:代码:
sqlite3_stmt * stat;
复制内容到剪贴板当 prepare 成功之后(返回值是 SQLITE_OK ),开始查询数据。代码:
sqlite3_prepare( db, “select * from Tbl_2”, -1, &stat, 0 );
复制内容到剪贴板这一句的返回值是 SQLITE_ROW 时表示成功(不是 SQLITE_OK )。 你可以循环执行 sqlite3_step 函数,一次 step 查询出一条记录。直到返回值不为 SQLITE_ROW 时表示查询结束。 然后开始获取第一个字段:ID 的值。ID是个整数,用下面这个语句获取它的值:代码:
int result = sqlite3_step( stat );
复制内容到剪贴板下面开始获取 file_content 的值,因为 file_content 是二进制,因此我需要得到它的指针,还有它的长度:代码:
int id = sqlite3_column_int( stat, 0 ); //第2个参数表示获取第几个字段内容,从0开始计算,因为我的表的ID字段是第一个字段,因此这里我填0
复制内容到剪贴板这样就得到了二进制的值。 & ?6 ^, }3 P2 H# o4 [! M5 A2 X 把 pFileContent 的内容保存出来之后,不要忘了释放 sqlite3_stmt 结构:代码:
const void * pFileContent = sqlite3_column_blob( stat, 1 ); int len = sqlite3_column_bytes( stat, 1 ); 复制内容到剪贴板i.3代码:
sqlite3_finalize( stat ); //把刚才分配的内容析构掉
重复使用 sqlite3_stmt 结构 如果你需要重复使用 sqlite3_prepare 解析好的 sqlite3_stmt 结构,需要用函数: sqlite3_reset。 复制内容到剪贴板这样, stat 结构又成为 sqlite3_prepare 完成时的状态,你可以重新为它 bind 内容。代码:
result = sqlite3_reset(stat);