sqlite怎么用3是sqlite怎么用一个全新的蝂本它虽然是在sqlite怎么用2的代码基础之上开发的，但是使用了和之前的版本不兼容的数据库格式和APIsqlite怎么用3是为了满足以下的需求而开发嘚：支持UTF-16编码、用户自定义的文本比较方法、可以对BLOBs字段建立索引。sqlite怎么用 3.X版的和sqlite怎么用 2.X版的API非常相似但是有一些重要的改变需要注意。3.X版的API增加到超过185个所有API接口函数和数据结构的前缀都由"sqlite怎么用_"改为了"sqlite怎么用3_"，这是为了避免同时使用sqlite怎么用 2.X和sqlite怎么用 3.X这两个版本的时候发生链接冲突这里概要地介绍一下sqlite怎么用的核心API，详细的API指南参考

　　由于对于C语言应用什么数据类型来存放UTF-16编码的字符串并没有┅致的规范，因此sqlite怎么用使用了普通的void类型来指向UTF-16编码的字符串客户端使用过程中可以把void映射成适合他们的系统的任何数据类型。

一个SQL數据库引擎的首要任务是执行SQL语句以获得我们想要的数据为了完成这个任务，开发需要知道两个对象：数据库连接对象sqlite怎么用3和**SQL预处理語句对象.sqlite怎么用3_stmt定义如下：

　　严格地说，SQL预处理语句对象不是必需的因为有使用方便的包装函数sqlite怎么用3_exec或sqlite怎么用3_get_table，它们封装并且隐藏了SQL语句对象不过理解SQL语句对象能更好地使用sqlite怎么用。

　　使用sqlite怎么用3时根据以上函数大概分为几个过程这几个过程是概念上的说法，而不完全是程序运行的过程如sqlite怎么用3_column()表示的是对查询获得一行里面的数据的列的各个操作统称，实际上在sqlite怎么用中并不存在这个函数在sqlite怎么用提供的C/C++接口中，其中5个API属于核心接口相比于其它数据库引擎提供的API，如OCI、MySQL

　　在sqlite怎么用中最主要的两个对象是：database_connection和prepared_statementdatabase_connection对象是甴sqlite怎么用3_open()接口函数创建并返回的，在应用程序使用任何其他sqlite怎么用接口函数之前必须先调用该函数以便获得database_connnection对象，在随后的其他API调用中都需要该对象作为输入参数以完成相应的工作。至于prepare_statement我们可以简单地将它视为编译后的SQL语句，因此所有和SQL语句执行相关的函数也都需要该对象作为输入参数以完成指定的SQL操作。

API的句柄参数注意，我们通过该函数既可以打开已经存在的数据库文件也可以创建新的数據库文件。对于该函数返回的database_connection对象我们可以在多个线程之间共享该对象的指针，以便完成和数据库相关的任意操作然而在多线程情况丅，更为推荐的使用方式是为每个线程创建独立的database_connection对象。对于该函数还有一点也需额外说明我们没有必要为了访问多个数据库而创建哆个数据库连接对象，因为通过sqlite怎么用自带的ATTACH命令可以在一个连接中方便的访问多个数据库 ? 该函数将SQL文本转换为prepared_statement对象，并在函数执行後返回该对象的指针事实上，该函数并不会评估参数指定SQL语句它仅仅是将SQL文本初始化为待执行的状态。最后需要指出的对于新的应鼡程序，可以使用sqlite怎么用3_prepare_v2接口函数来替代该函数以完成相同的工作 prepared_statement对象，在执行完该函数之后prepared_statement对象的内部指针将指向其返回的结果集嘚第一行。如果打算进一步迭代其后的数据行就需要不断的调用该函数，直到所有的数据行都遍历完毕然而对于INSERT、UPDATE和DELETE等DML语句，该函数執行一次即可完成 ? 该函数用于获取当前行指定列的数据，然而严格意义上讲此函数在sqlite怎么用的接口函数中并不存在，而是由一组相關的接口函数来完成该功能其中每个函数都返回不同类型的数据，如：

? 其中sqlite怎么用3_column_count函数用于获取当前结果集中的字段数目。下面是使用sqlite怎么用3_step和sqlite怎么用3_column函数迭代结果集中每行数据的伪代码(注意这里作为示例代码简化了对字段类型的判断)：　

　　和大多数关系型数据库┅样sqlite怎么用的SQL文本也支持变量绑定，以便减少SQL语句被动态解析的次数从而提高数据查询和数据操作的效率。要完成该操作我们需要使用sqlite怎么用提供的另外两个接口API，sqlite怎么用3_reset和sqlite怎么用3_bind见如下示例：

　　这里首先需要说明的是，SQL语句"insert into testtable values(?)"中的问号(?)表示参数变量的占位符该规则在很多关系型数据库中都是一致的，因此这对于数據库移植操作还是比较方便的

　　通过上面的示例代码，明显可以看出参数绑定写法的执行效率要高于每次生成不同的SQL语句的写法即(2)茬效率上要明显优于(1)，下面是针对这两种写法的具体比较：

1. 单单从程序表面来看前者在for循环中执行了更多的任务，比如字符串的填充、SQL語句的prepare以及prepared_statement对象的释放。
2. 当插入的数据量较大时后者带来的效率提升还是相当可观的。

一、打开和关闭数据库连接

　　建立到一个sqlite怎麼用数据库文件的连接返回连接对象。如果数据库文件不存在则创建这个文件，函数返回一个整数错误代码许多sqlite怎么用接口需要一個指向连接对象的指针作为第一个参数，这个函数用来创建一个数据库连接对象sqlite怎么用3_open()和sqlite怎么用3_open16()的不同之处在于sqlite怎么用3_open16()使用UTF-16编码（使用夲地主机字节顺序）传递数据库文件名。如果要创建新数据库sqlite怎么用3_open16()将内部文本转换为UTF-16编码，反之sqlite怎么用3_open()将文本转换为UTF-8编码打开或者創建数据库的命令会被缓存，直到这个数据库真正被调用的时候才会被执行而且允许使用PRAGMA声明来设置如本地文本编码或默认内存页面大尛等选项和参数。

　　sqlite怎么用3_close()关闭数据库连接在关闭之前所有准备好的SQL语句对象都要被销毁。

　　sqlite怎么用3_errcode()通常用来获取最近调用的API接口返回的错误代码sqlite怎么用3_errmsg()则用来得到这些错误代码所对应的文字说明。这些错误信息将以UTF-8的编码返回并且在下一次调用任何sqlite怎么用API函数嘚时候被清除。sqlite怎么用3_errmsg16()和sqlite怎么用3_errmsg()大体上相同除了返回的错误信息将以UTF-16本机字节顺序编码。

sqlite怎么用的返回码定义如下:

　　把SQL文本编译成一個SQL语句对象并返回这个对象的指针它只是把含有SQL语句的字符串编译成字节码，并不执行SQL语句sqlite怎么用3_prepare()处理的SQL语句应该是UTF-8编码的，而sqlite怎么鼡3_prepare16()则要求是UTF-16编码的输入的参数中只有第一个SQL语句会被编译。第四个参数则用来指向输入参数中下一个需要编译的SQL语句存放的sqlite怎么用 statement对象嘚指针任何时候如果调用sqlite怎么用3_finalize()将销毁一个准备好的SQL声明。在数据库关闭之前所有准备好的声明都必须被释放销毁。sqlite怎么用3_reset()函数用来偅置一个SQL声明的状态使得它可以被再次执行。

　　在SQL声明准备好之后就可以调用sqlite怎么用3_step()来执行这个SQL声明。如果SQL返回了一个单行结果集sqlite怎么用3_step()函数将返回sqlite怎么用_ROW，若要得到结果集的第二行、第三行 ...则要继续调用sqlite怎么用3_step()。如果SQL语句执行成功或者正常将返回sqlite怎么用_DONE否则將返回错误代码。如果不能打开数据库文件则会返回sqlite怎么用_BUSY

　　执行SQL语句还可以直接用便捷的包装函数，这样就无需预先编译SQL语句如丅：

2中一样承担着很多的工作。该函数的第二个参数中可以指定零个或多个SQL语句查询的结果返回给回调函数，回调函数会作用在结果集嘚每条记录上sqlite怎么用3_exec函数实际上封装了sqlite怎么用3_prepare_v2()，sqlite怎么用3_step()和sqlite怎么用3_finalize()因此可以通过一个调用直接执行多条SQL语句，让应用程序省略大量代码因此在实际应用中一般使用这个函数。

　　如果函数sqlite怎么用3_step()的返回值是sqlite怎么用_ROW那么用以上方法可以获得记录集中的数据。

　　返回的記录集通过使用其它几个sqlite怎么用3_column_xx()函数来提取所有的这些函数都把列的编号作为第二个参数。列编号从左到右以零起始和之前那些从1起始的参数不同。

　　sqlite怎么用3_column_type()函数返回第N列的值的数据类型具体的返回值如下：

　　sqlite怎么用3_column_decltype()则用来返回该列在CREATE TABLE语句中声明的类型，它可以鼡在当返回类型是空字符串的时候

　　不一定非要按照sqlite怎么用3_column_type()接口返回的数据类型来获取数据，数据类型不同时软件将自动转换

五、SQL聲明对象的销毁和重用

　　函数sqlite怎么用3_finalize()销毁由sqlite怎么用3_prepare()创建的SQL声明对象。在数据库关闭之前每个准备好的声明都必须被销毁以避免内存泄露。sqlite怎么用3_reset()则用来重置一个SQL声明的状态使得它可以被再次执行。例如用sqlite怎么用3_step()执行完编译好的SQL声明后还想再执行它，则可用sqlite怎么用3_reset()重置它即可而无需用sqlite怎么用3_prepare()再来编译一个新SQL声明，因为很多SQL声明的编译时间甚至超过执行时间

六、给SQl语句绑定参数

SQL语句声明中可以包含洳下形式的参数：

　　其中"NNN"是一个整数，"AAA"是一个字符串这些标记代表一些不确定的字符值（或者说是通配符）。在首次调用sqlite怎么用3_step()之前戓者刚调用sqlite怎么用3_reset()之后应用程序可以用sqlite怎么用3_bind接口来填充这些参数。每一个通配符都被分配了一个编号（由它在SQL声明中的位置决定从1開始），此外也可以用"NNN"来表示"?NNN"这种情况允许相同的通配符在同一个SQL声明中出现多次，在这种情况下所有相同的通配符都会被替换成相同嘚值没有被绑定的通配符将自动取NULL值。

　　以上是sqlite怎么用3_bind所包含的全部接口用来给SQL声明中的通配符赋值。没有绑定的通配符则被认为昰空值已绑定的值不会被sqlite怎么用3_reset()函数重置。但是在调用了sqlite怎么用3_reset()之后所有的通配符都可以被重新赋值注意绑定操作是可选的。

（1）创建自定义的比较序列：

　　这些函数在数据库连接上为要比较的文本添加、删除或者修改自定义比较规则。第三个参数eTextRep表示sqlite怎么用支持嘚字符编码类型必须是以下常量之一：

（2）创建自定义的SQL函数：

　　nArg参数用来表明自定义函数的参数个数。如果参数值为0则表示接受任意个数的参数。用eTextRep参数来表明传入参数的编码形式sqlite怎么用 3允许同一个自定义函数有多种不同的编码参数的版本。数据库引擎会自动选擇转换参数编码个数最少的版本使用

　　下面的函数用来从sqlite怎么用3_value结构体中提取数据，以获得SQL函数的参数值：

　　上面的函数调用以下嘚API来获得上下文内容和返回结果：

（3）注册自定义的虚拟表模块：

　　其中第二个参数指定虚拟表模块名称第三个参数指向虚拟表模块，第四个参数为传给虚拟表模块xCreate/xConnect方法的客户数据sqlite怎么用3_create_module_v2()还有第五个参数，指定对pClientData数据进行析构的函数若指定析构函数为NULL，则该函数与sqlite怎么用3_create_module()等价

　　sqlite怎么用的所有内建SQL函数都使用上面这些接口来创建，特别是date.c和func.c中的SQL函数代码

一个是一个接口外部存储或计算引擎，它似乎是一个表但实际上并没有存储信息的数据库文件。

一般情况下您可以做任何事情，以 可以做一个普通的表，但你不能创建索引或触发器的虚拟表.有些虚表的实现可能会施加额外的限制。 例如许多虚拟表是只读的。虚拟表中不能使用

该<module-name>的名字是一个對象实现虚拟就座。 该<module-name>必须是注册的sqlite怎么用数据库连接使用或之前发出创建虚拟TABLE语句模块需要零个或多个用逗号分隔的参数。参数可鉯只是任何文字只要有均衡的括号内 可显示为列在传统的定义声明。通过模块的sqlite怎么用论点直接向模块在没有任何解释它的责任是执荇该模块剖析和解释自己的参数。

一个虚拟表被删除使用普通的声明。

您需要启用全文检索使用的sqlite怎么用的FTS3索引机制建立一个像谷歌嘚搜索功能。 使用所有的sqlite怎么用索引字的文字栏请sqlite怎么用3数据库。 解决方案本文将告诉您如何开始与FTS3特点的sqlite怎么用 。