我们一起学习 sqlite 的应用

第一章 从这里开始
1.0 引言
    最近发现网上很多人在文 sqlite 数据库的问题，可是解答的人并不多。于是萌生了写点这方面的文章的念头。虽然我也是刚接触 sqlite 不到半年，对其了解得也不是很深很透彻，但是写点东西让初学者能够很快上手，也算是我的心愿之一。也许很多高手会觉得我这是班门弄斧，但是我还是想写点关于 sqlite 的基本知识，这样也许能给予某些人一些帮助，希望如此。
    
下文介绍的内容都是基于 Linux RedHat 9.0 平台的。
                   
1.1 sqlite简介
    sqlite是嵌入式SQL数据库引擎SQLite（SQLite Embeddable SQL Database Engine）的一个扩展。SQLite是一个实现嵌入式SQL数据库引擎小型C语言库（C library），实现了独立的，可嵌入的，零配置的SQL数据库引擎。特性包括：事务操作是原子，一致，孤立，并且持久的，即使在系统崩溃和电源故障之后。 零配置——不需要安装和管理。 实现了绝大多数SQL92标准。整个数据库存储在一个单一的文件中。数据库文件可以在不同字节序的机器之间自由地共享。支持最大可达2T的数据库。字符串和BLOB类型的大小只受限于可用内存。完整配置的少于250KB，忽略一些可选特性的少于150KB。在大多数常见操作上比流行的客户/服务器数据库引擎更快。 简单易于使用的API。 内建TCL绑定。 另外提供可用于许多其他语言的绑定。具有良好注释的源代码，代码95%有较好的注释。 独立：没有外部依赖。 源代码位于公共域，可用于任何用途。用SQLite连接的程序可以使用SQL数据库，但不需要运行一个单独的关系型数据库管理系统进程（separate RDBMS process）。SQLite不是一个用于连接到大型数据库服务器（big database server）的客户端库（client library），而是非常适合桌面程序和小型网站的数据库服务器。SQLite直接读写（reads and writes directly）在硬盘上的数据库文件。
    这一章告诉你怎么开始体验 SQLite ，这里没有长长的说明和冗烦的配置。

1.2 下载代码
    取得一份二进制拷贝, 或者是源代码并自己编译它。关于这个可以到 的下载页面获得更多信。
这里我就不多说了。
    
1.3 安装
    请阅读在安装包里的 INSTALL 文件。或者使用PEAR installer with "pear install sqlite"。SQLite已经内置了，你不需要安装任何附加的软件（additional software）。
Windows users可以下载SQLite扩展DLL（php_sqlite.dl）。
这里简单介绍一下：
假设你得到的是源代码，这里将告诉你怎么编译它。
解压sqlite-3.0.8.tar.gz 到 /home目录下
       For example:
    
    # tar xzf sqlite.tar.gz –C /home/       ;#  Unpack the source tree into "sqlite"
    # mkdir sqlite-pc                      ;#  Build will occur in a sibling directory
    # cd sqlite-pc                                ;#  Change to the build directory
    # ../sqlite/configure                      ;#  Run the configure script
    #  make                                 ;#  Run the makefile.
    #  make install
生成帮助文档
    #  make doc
    
如果一切顺利的话，sqlite的库文件将会生成在 /usr/local/lib 目录下。去看看有没有这些库文件。
libsqlite3.a  libsqlite3.la  libsqlite3.so  libsqlite3.so.0  libsqlite3.so.0.8.6  pkgconfig
好了我们可以进入下一节了。激动人心的时刻到了，我们可以轻而易举的创建和操纵数据库了。

1.4 创建一个新数据库
在 shell 命令行下, 输入: "sqlite3 zieckey.db"。 将创建一个新的数据库文件名叫"zieckey.db". (当然你可以使用不同的名字)
输入 SQL 命令在提示符下创建和写入新的数据。
例如，新建一个名为zieckey.db的数据库，并创建一个名为 SensorData 的表，其包含两个列元素，并插入具体列元素，具体如下
    # sqlite3 zieckey.db
    SQLite version 3.0.8
    Enter ".help" for instructions
    sqlite> create table SensorData(one varchar(10), two smallint);
    sqlite> insert into SensorData values('hello!',10);
    sqlite> insert into SensorData values('goodbye', 20);
    sqlite> select * from SensorData;
    hello!|10
    goodbye|20
    sqlite>
安全退出 sqlite 的方法是
    sqlite> .quit
这样刚才的操作就保存下来了，如果强行退出有可能丢失刚才对数据库的操作。
是不是相当容易，呵呵，当然拉！如果你会 SQL 语言，你会发现，sqlite的语法几乎和它一个样。
这里先到这里，后面的章节中我们会继续学习sqlite的语法规则的。
 1.5 写个C语言程序调用SQLite
    现在我们来写个C/C++程序，调用 sqlite    的 API 接口函数。
    下面是一个C程序的例子，显示怎么使用 sqlite 的 C/C++ 接口. 这个函数调用sqlite3_open() 在 22 行打开数据库, sqlite3_exec() 在 27 行执行 SQL 命令, 并且sqlite3_close() 在 31 行关闭数据库连接。
代码:

//     name： opendbsqlite.c
//    This file is used to test C/C++ API for sqlite
//     Author : zieckey
//     2006/04/11
#include
#include
 
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("open zieckey.db successfully!\n");
    
    sqlite3_close(db);               //关闭数据库
    return 0;
}

编译：# gcc opendbsqlite.c -o db.out
也许会碰到类似这样的问题：
/tmp/ccTkItnN.o(.text+0x2b): In function `main':
: undefined reference to `sqlite3_open'
/tmp/ccTkItnN.o(.text+0x45): In function `main':
: undefined reference to `sqlite3_errmsg'
/tmp/ccTkItnN.o(.text+0x67): In function `main':
: undefined reference to `sqlite3_close'
/tmp/ccTkItnN.o(.text+0x8f): In function `main':
: undefined reference to `sqlite3_close'
collect2: ld returned 1 exit status

这是个没有找到库文件的问题。
由于用到了用户自己的库文件,所用应该指明所用到的库，我们可以这样编译：

# gcc opendbsqlite.c -o db.out -lsqlite3

我用用 -lsqlite3 选项就可以了(前面我们生成的库文件是 libsqlite3.so.0.8.6 等,
去掉前面的lib和后面的版本标志,就剩下 sqlite3 了所以是 -lsqlite3 )。
如果我们在编译安装的时候，选择了安装路径，例如这样的话：
.......
# ../sqlite/configure --prefix=/usr/local/arm-linux/sqlite-ix86-linux
.......
这样编译安装时，sqlite的库文件将会生成在  /usr/local/arm-linux/sqlite-ix86-linux/lib 目录下
这时编译还要指定库文件路径，因为系统默认的路径没有包含 /usr/local/arm-linux/sqlite-ix86-linux/lib

# gcc opendbsqlite.c -lsqlite3 -L/usr/local/arm-linux/sqlite-ix86-linux/lib

如果还不行的话，可能还需要指定头文件 sqlite3.h 的路径，如下：

# gcc opendbsqlite.c -lsqlite3 -L/usr/local/arm-linux/sqlite-ix86-linux/lib -I/usr/local/arm-linux/sqlite-ix86-linux/include

这样编译应该就可以了 ，运行：
# ./db.out
./db.out: error while loading shared libraries: libsqlite3.so.0: cannot open shared object file: No such file or directory
运行是也许会出现类似上面的错误。
这个问题是由于运行沿着系统默认路径没有找到库文件引起的。这时需要指定 libsqlite3.so.0 库文件的路径。
在shell下输入：
export LD_LIBRARY_PATH=/usr/local/arm-linux/sqlite-ix86-linux/lib:$LD_LIBRARY_PATH
再运行
# ./db.out
open zieckey.db successfully!
是不是很有成就感阿 ，呵呵，这个上手还是很快的。


总结：这一章里，我们了解了sqlite的基本概貌，并且知道了怎么创建数据库，
怎么向数据库中插入表格，向表格中插入数据，更令人兴奋的是我们知道了
怎么在C/C++中调用 sqlite 的 API 函数。
写后感：这是我第一次这样用心的比较正规的写关于一个专题的文章。
我也是望着篇文章能带给你帮助。如果是这样的话，那我的努力就没有白费，这让我觉得我还做了点好事的。
本文一定存在很多不妥或者错误之处，还劳烦各位不吝赐教指正。在此跟贴，或者发 email ：[e-mail]  ，本人将不胜感激。
作者郑重申明：本文可以自由转载，但请不要去掉版权信息，也不要用于商业用途。