iOS开发之SQLite-C语言接口规范(二) —— Prepared Your SQL Statements

在《SQLite的C语言接口规范(一)》中介绍了如何去连接打开数据库，本篇博客就介绍如何操作数据库，本篇主要给出了如何执行数据库查询语句（Select）, 然后遍历结果集。本篇博客就直接使用上一篇博客封装的打开数据库的方法获取到数据库的操作句柄，然后通过这个句柄来操作我们的Sqlite数据库。今天这篇博客中要多Cars.sqlite数据库中的其中一个表进行Select操作。更为细节的东西请参考SQLite官网：http://www.sqlite.org 。

一.预编译SQL语句

要想执行一条查询的SQL语句，需要使用下面任何一个方法先预编译成字节码程序。不难看出以下方法的参数都是一样的，那么就先挨个的介绍一下每个参数的代表什么。

1. 参数“sqlite3 * db”, 就是我们调用sqlite3_open(), sqlite3_open_v2() 或者 sqlite3_open16()成功后获取的操作数据库的句柄。数据库连接必须没有被关闭。

2. zSql是第二个参数, 他的编码格式是UTF-8或UTF-16, 它就是将会被预先编译成字节码的SQL语句。sqlite3_prepare() 和 sqlite3_prepare_v2()接口使用的是UTF-8编码。sqlite3_prepare16() 和 sqlite3_prepare16_v2() 使用的是 UTF-16编码。

3. nByte是第三个参数，说白了，它就是参数zSql字符串的最大长度。如果nByte是负数，那么zSql的长度不限，如果nByte是正数，zSql的长度则不能超过nByte的数值，超出的部分将不会被预编译。如果nByte是0，那么zSql将不会被预编译。如果你之前学过C语言的话，在C语言中是没有所谓的字符串的，是一个指向字符的指针，后面跟了好多字符，以‘\0’结尾，这就是C语言中的字符串，需要通过指针的移动来遍历字符串的，所以nByte是很有必要的。

4. *ppStmt 是预编译语句后左边的指针，它可以使用sqlite3_step()执行。在发生错误时，*ppStmt就会被设置为NULL。如果输入的文本不是SQL语句（输入的文本为空字符串或者一行注释）*ppStmt就会被设置为NULL。 sqlite3_finalize()负责释放被编译的SQL语句。

5. pzTail, 看pzTail的类型就可以看出它是指向指针的指针。pzTail指向谁的指针呢？如他不为NULL的话，它就指向预编译SQL语句的末尾，也就是未预编译SQL语句的首指针。

二、预编译SQL语句实例

下面是使用sqlite3_prepare()来预编译的一条查询语句，在新的项目中建议使用sqlite_prepare_v2(), 他是前者的升级版。v2代表什么意思，在上一篇博客中进行的简单介绍，以后如果有时间，会对VFS(虚拟文件系统)进行详细的介绍。

1.定义NSString类型的SQL查询语句，如下所示:

 //查询数据库

 NSString * qureyInfo = @"SELECT * FROM CARBRAND";

 

2. 定义sqlite3_stmt变量来接受预编译后的语句。

 sqlite3_stmt *statement; 

 

3.把NSString类型 SQL语句转成UTF-8的类型。

 const char * zSql = [qureyInfo UTF8String]; 

4.调用sqlite3_prepare()进行预编译，sqlite3_prepare()预编译后会有结果状态码，在上一篇博客中进行了讲解，本篇博客不做过的赘述：

int result = sqlite3_prepare(database, zSql, -1, statement, nil);

 

经过上面这些步骤就可以获取到预编译后的SQL语句statement，然后我们就可以通过statement做一些爱做的事情了。

 

三、执行预编译后的SQL语句

执行预编译后的SQL语句需要调用sqlite3_step()。 sqlite3_step() 会被一次或多次执行，由下方截图可知，sqlite3_step()的参数就是预编译后的语句的指针（sqlite3_stmt *）。在新的项目中推荐使用sqlite3_prepare_v2()和sqlite3_prepare16_v2()。因为要向后兼容，所以之前的接口进行了保留，不过，不建议使用sqlite3_prepare()和sqlite3_prepare16()。在“v2”接口中，被返回的预编译语句（sqlite3_stmt对象）包含了一个原始SQL语句的副本。这导致了sqlite3_step()有三种不同的表现形式。

1.如果数据库的Schema发生变化了，之前会返回SQLITE_SCHEMA，如果使用带v2的方法的话，sqlite3_step()将自动重新编译SQL语句并再次尝试运行它。因为使用v2的方法，预编译的结果中将包含SQL原始语句。

2.当错误发生时，sqlite3_step()将会返回更为详细的错误代码和扩展错误代码。而之前的做法是返回一个通用的错误结果代码SQLITE_ERROR，而你不得不去调用sqlite3_reset()方法来查找问题。在“v2”预编译接口中将会立即返回错误原因。

3.如果特定的值与WHERE子句中的条件进行绑定，这就会影响查询结果，这个语句将会自动被重新编译，类似于数据库的架构改变的情况。

下方是扩展后的结果集：

上面说这么多，就是一句话，在预编译时强烈推荐使用“v2”预编译接口，“v2”预编译接口是升级版，功能更强大。

sqlite3_step()接口去执行预编译后的语句，也会返回一些结果代码，下面介绍一些常用的结果代码：SQLITE_BUSY, SQLITE_DONE, SQLITE_ROW, SQLITE_ERROR或者 SQLITE_MISUSE，如果你是使用的“v2”接口进行编译的话，将会返回更多更为详细的结果编码。

SQLITE_BUSY 意味着数据库引擎无法获得所需的数据库锁然后做它的工作。如果语句是commit或执行一个外部的显式事务,你可以重试。如果的语句不是提交并且执行一个内部显示的事务,那么在重试之前你应该回滚事务。

SQLITE_DONE 意味着语句执行完成并且成功。没有初次调用sqlite3_reset()来重置虚拟机恢复到初始状态，sqlite3_step()就不应该再调用这个虚拟机。

SQLITE_ROW 如果正在执行的SQL语句返回任何数据, 为了便于调用者处理，如果有数据，返回结果就是SQLITE_ROW。再次sqlite3_step()来检索数据的下一行。

SQLITE_ERROR 出错的状态，你可以调用sqlite3_errmsg()来查看具体的错误。sqlite3_errmsg()所需参数和返回值

 

上面已经准备好了预编译好的SQL语句，我们使用sqlite3_step()来执行和遍历一下结果集，具体代码如下：

if (result == SQLITE_OK) {

 NSLog(@"查询成功");

 //遍历结果集

 while (sqlite3_step(statement) == SQLITE_ROW) {

 int rowNum = sqlite3_column_int(statement, 0);

 char *rowDataOne = (char *) sqlite3_column_text(statement, 1);

 char *rowDataTow = (char *) sqlite3_column_text(statement, 2);

 NSString *nameString = [NSString stringWithUTF8String:rowDataOne];

 NSString *firstLetterString = [NSString stringWithUTF8String:rowDataTow];

 NSLog(@"BrandId = %d, Name = %@, FirstLetter = %@",rowNum , nameString, firstLetterString);

 sqlite3_finalize(statement);

 } else {

 NSString *error = [NSString stringWithFormat:@"错误结果代码：%d", result];

 NSLog(@"%@", error);

 }

可以对上面的代码进行一下修改，在while循环语句的最后一条语句后，加上sqllite3_reset(), 那么这个循环就是一个死循环，读取的永远是第一个数据。在这儿就不往上贴代码了。 

执行结果如下：

         

 

好，今天的数据库查询就先到这儿，关于别的内容，会在下节博客中进行介绍。

SQL语言 由国际标准化组织(Iso)制定的，对 DBMs 的统一操作方式(例如相同的语句可以操作: mysql、oracle等)。1.DDL(Data Definition Language):数据定义语言，用来定义数据库对象:库、表、列等;2.DML(Data Manipulation Language):数据操作语言，用来定义数据库记录（数据)﹔***(Data Query Language):数据查询语言，用来查询记录（数据）。• 创建、删除、修改:库、表结构!dml:对表的记录进行更新（增、删、改)
数据库小技能：PL/SQL（Procedure Language/SQL,过程化SQL语言）预备知识 过程化SQL语言（Procedural Language/SQL）是Oracle数据库对SQL语句的扩展：在普通SQL语句的使用上增加了编程语言的特点，把数据操作和查询语句组织在PL/SQL代码的过程性单元中，通过逻辑判断、循环等操作实现复杂的功能或者计算的程序语言。
SQL语言查询综合操作实战（附例题） SQL语言中最重要的可谓就是查询操作了。 我们可以发现，人与数据库的交互往往就是通过查询进行的，数据库的本质不就是存储和处理信息，最后通过查询为我们所用的工具嘛。 除此之外，我们今后一系列SubQuery操作、函数操作往往都是建立在select查询的基础上的。查询基本成了sql大厦的基石了。 本期我们就来聚焦于select查询操作，通过实战演示sql查询语句的编写技巧，希望我们都能成为灵活使用select语句的sql玩家！
SQL通用语言之五项进阶操作 何为进阶？当我们跳出了原有限制进行更新、自定义化更强的操作时就是进阶的开始。 本期我们就将进行几个原有限制的跳出—— join连接：跳出单个数据表的限制 SubQuery子查询：跳出单层逻辑的限制 常用函数：跳出工具的单一性限制 groupby分组 having过滤分组
SQL语言基础操作之逻辑语句 上期回顾 上次的基础操作中我们过了一遍sql语言表操作中最基本的所有命令，包括了表的创建、数据的插入和查询、重复数据的去除等操作。 本期我们就要开始引入逻辑相关的操作命令了：
SQL语言基础操作与语法 1.SQL简介 SQL是用于访问和处理数据库的标准计算机语言. SQL是Structured Query Language的缩写，是结构化查询语言 只需要说明做什么，不需要说明如何做 标准化。SQL语言几乎所有的DBMS（关系数据库）都能通用 不区分大小写