SQLite的使用

SQLite介绍

最近做一个数控系统的项目，winCE嵌入式操作系统+.Net Compact Framework环境+VS2008开发平台，开发的设备程序部署到winCE系统下的设备中运行。。

SQLite，是一款开源轻型的文件型数据库，是遵守ACID的关系型数据库管理系统，它包含在一个相对小的C库中。它是D.RichardHipp建立的公有领域项目。它的设计目标是嵌入式的，而且目前已经在很多嵌入式产品中使用了它，它占用资源非常的低，在嵌入式设备中，可能只需要几百K的内存就够了。它能够支持Windows/Linux/Unix等等主流的操作系统，同时能够跟很多程序语言相结合，比如 Tcl、C#、PHP、Java等，还有ODBC接口，同样比起Mysql、PostgreSQL这两款开源的世界著名数据库管理系统来讲，它的处理速度比他们都快。SQLite第一个Alpha版本诞生于2000年5月。至2015年已经有15个年头，SQLite也迎来了一个版本 SQLite 3已经发布。

（ACID，指数据库事务正确执行的四个基本要素的缩写。包含：原子性（Atomicity）、一致性（Consistency）、隔离性（Isolation）、持久性（Durability）。一个支持事务（Transaction）的，必需要具有这四种特性，否则在事务过程（Transaction processing）当中无法保证数据的正确性，交易过程极可能达不到交易方的要求。）

工作原理

不像常见的客户-服务器范例，SQLite引擎不是个程序与之通信的独立进程，而是连接到程序中成为它的一个主要部分。所以主要的通信协议是在编程语言内的直接API调用。这在消耗总量、延迟时间和整体简单性上有积极的作用。整个数据库(定义、表、索引和数据本身)都在宿主主机上存储在一个单一的文件中。它的简单的设计是通过在开始一个事务的时候锁定整个数据文件而完成的。

使用.NET操作SQLLITE

先下载ADO.NET2.0 Provider for SQLite。下载binarieszip版就可以了。下载完后解压缩，可以在bin目录下找到System.Data.SQLite.DLL。

在vs2008中用Add Reference（添加引用）功能把System.Data.SQLite.DLL加到工程里就可以了。

运行下面代码试试：

由于SQLite是个文件型数据库，判断机器中是否有某个数据库，直接判断是否有此文件即可。

1、如果存在，

if (System.IO.File.Exists("\Hard Disk\PressBreak.db3"))
            {
                cnn = new SQLiteConnection();
                cnn.ConnectionString = "Data Source = \Hard Disk\PressBreak.db3;Password = Sunkz";
                cnn.Open();
                return true;
            }

2、如果不存在

 //创建一个数据库文件
                string datasource = "\Hard Disk\PressBreak.db3";
                System.Data.SQLite.SQLiteConnection.CreateFile(datasource);

//连接数据库
                cnn = new SQLiteConnection();
                cnn.ConnectionString = "Data Source = \Hard Disk\PressBreak.db3;Password = Sunkz";//设置密码，SQLiteADO.NET实现了数据库密码保护
                cnn.Open();
System.Data.SQLite.SQLiteCommand cmd = new System.Data.SQLite.SQLiteCommand();
//创建表
string sql = "CREATE TABLE test(username varchar(20),password varchar(20))";
cmd.CommandText = sql;
cmd.Connection = conn;
cmd.ExecuteNonQuery();
//插入数据
sql = "INSERT INTO test VALUES('a','b')";
cmd.CommandText = sql;
cmd.ExecuteNonQuery();
//或者：
InsertSql="INSERT INTO PunchData(Id,Height, Angle, Radius, Strength) VALUES('{0}',{1},{2},{3},{4})";
cmd.CommandText=string.Format(InsertSql, punchData .Id , punchData.height.ToString(),  punchData.angle.ToString(),                                                                                                                              punchData.radius.ToString(), punchData.strength.ToString());
                      cmd.ExecuteNonQuery();
//此处注意，单引号的使用，字段为字符串类型的话，要加单引号。


//取出数据
sql = "SELECT * FROM test";
cmd.CommandText = sql;
System.Data.SQLite.SQLiteDataReader reader =cmd.ExecuteReader();
StringBuilder sb = new StringBuilder();
while (reader.Read())
{
sb.Append("username:").Append(reader.GetString(0)).Append("
")
.Append("password:").Append(reader.GetString(1));
}
MessageBox.Show(sb.ToString());

View Code

另附SQLite学习网站：http://www.w3cschool.cc/sqlite/sqlite-intro.html

SQLite错误代码整理

SQLite语句一定要严格按例子来写，例如：

"CREATE TABLE PunchData (Id Text primary key, Height Float, Angle Float, Radius Float, Strength Float)";

"INSERT INTO PunchData(Id,Height, Angle, Radius, Strength) VALUES('{0}',{1},{2},{3},{4})";

创建的时候Id是Text类型，插入的时候，{0}要加单引号。。否则，Id为0123是，通过数据库操作读取出来后变为123了。

最下面是执行SQLite语句的时候，若出错，出错对应的ErrorCode和Message。

try
            {
                using (DbCommand cmd = cnn.CreateCommand())
                {
                    cmd.CommandText = string.Format(punchInsertStr, punchData.id, punchData.height.ToString(),
                        punchData.angle.ToString(), punchData.radius.ToString(), punchData.strength.ToString());
                    count = cmd.ExecuteNonQuery();
                }
            }
            catch (SQLiteException ex)
            {
                int errorCode = (int)ex.ErrorCode;
            }

        //定义错误代码与相应的错误信息
        public readonly Dictionary<int, string> errorMessage = new Dictionary<int, string> {
        { 1, "SQL错误或丢失数据库" }, { 2, "SQLite 内部逻辑错误" },  { 3, "拒绝访问" },
        { 4, "回调函数请求取消操作" }, { 5, "数据库文件被锁定" } ,{ 19, "由于约束违例, 例如编号唯一" }};

        //界面上调用 ,返回错误信息
        string ErrorMassage = errorMessage[errorCode];

View Code

附：

#define SQLITE_OK 0 /* 成功 | Successful result */
/* 错误码开始 */
#define SQLITE_ERROR 1 /* SQL错误或丢失数据库 | SQL error or missing database */
#define SQLITE_INTERNAL 2 /* SQLite 内部逻辑错误 | Internal logic error in SQLite */
#define SQLITE_PERM 3 /* 拒绝访问 | Access permission denied */
#define SQLITE_ABORT 4 /* 回调函数请求取消操作 | Callback routine requested an abort */
#define SQLITE_BUSY 5 /* 数据库文件被锁定 | The database file is locked */
#define SQLITE_LOCKED 6 /* 数据库中的一个表被锁定 | A table in the database is locked */
#define SQLITE_NOMEM 7 /* 某次 malloc() 函数调用失败 | A malloc() failed */
#define SQLITE_READONLY 8 /* 尝试写入一个只读数据库 | Attempt to write a readonly database */
#define SQLITE_INTERRUPT 9 /* 操作被 sqlite3_interupt() 函数中断 | Operation terminated by sqlite3_interrupt() */
#define SQLITE_IOERR 10 /* 发生某些磁盘 I/O 错误 | Some kind of disk I/O error occurred */
#define SQLITE_CORRUPT 11 /* 数据库磁盘映像不正确 | The database disk image is malformed */
#define SQLITE_NOTFOUND 12 /* sqlite3_file_control() 中出现未知操作数 | Unknown opcode in sqlite3_file_control() */
#define SQLITE_FULL 13 /* 因为数据库满导致插入失败 | Insertion failed because database is full */
#define SQLITE_CANTOPEN 14 /* 无法打开数据库文件 | Unable to open the database file */
#define SQLITE_PROTOCOL 15 /* 数据库锁定协议错误 | Database lock protocol error */
#define SQLITE_EMPTY 16 /* 数据库为空 | Database is empty */
#define SQLITE_SCHEMA 17 /* 数据结构发生改变 | The database schema changed */
#define SQLITE_TOOBIG 18 /* 字符串或二进制数据超过大小限制 | String or BLOB exceeds size limit */
#define SQLITE_CONSTRAINT 19 /* 由于约束违例而取消 | Abort due to constraint violation */ （例如：主键约束）
#define SQLITE_MISMATCH 20 /* 数据类型不匹配 | Data type mismatch */
#define SQLITE_MISUSE 21 /* 不正确的库使用 | Library used incorrectly */
#define SQLITE_NOLFS 22 /* 使用了操作系统不支持的功能 | Uses OS features not supported on host */
#define SQLITE_AUTH 23 /* 授权失败 | Authorization denied */
#define SQLITE_FORMAT 24 /* 附加数据库格式错误 | Auxiliary database format error */
#define SQLITE_RANGE 25 /* 传递给sqlite3_bind()的第二个参数超出范围 | 2nd parameter to sqlite3_bind out of range */
#define SQLITE_NOTADB 26 /* 被打开的文件不是一个数据库文件 | File opened that is not a database file */
#define SQLITE_ROW 100 /* sqlite3_step() 已经产生一个行结果 | sqlite3_step() has another row ready */
#define SQLITE_DONE 101 /* sqlite3_step() 完成执行操作 | sqlite3_step() has finished executing */
/* 错误码结束 */