C# 中 SQLite 使用介绍

关于SQLite

SQLite是一款轻型的嵌入式的遵守ACID的关系型数据库管理系统，诞生已有15个年头了。随着移动互联的发展，现在得到了更广泛的使用。

在使用SQLite之前，我们势必要先了解它一些“个性”的地方。下面是它的一些特点：

自包含。SQLite很大层度上是独立的，他只需要非常小的外部库支持。任何程序能够访问磁盘就可以使用SQLite数据库。这使它适用于嵌入式设备，缺乏桌面计算机支持的基础设施。这也使得SQLite适用于不作任何修改就可运行在不同配置电脑上的程序。
无服务器。大多数SQL数据库引擎被实现为一个单独的服务器进程。程序要访问数据库与服务器通信使用某种形式的进程间通信(通常是TCP / IP)，向服务器发送请求并接收返回结果。SQLite则不是这种工作方式。对于SQLite，想要访问数据库直接从磁盘上的对数据库文件执行读和写操作。没有中间的服务器进程。
零配置。使用SQLite不需要“安装”。没有“设置”程序。没有服务器进程需要启动，停止，或配置。不需要管理员来创建一个新的数据库实例或访问权限分配给用户。SQLite不使用配置文件。
支持事务。事务数据库的所有更改和查询表现出原子性、一致性、隔离性、持久性(ACID)。执行SQLite的事务操作时，要么完全执行，要么不执行，即使写入磁盘的操作被程序崩溃，断电等故障打断。
开源。和前面的特点相比，这个似乎没有多大关系。之所以把它作为一个特点，是因为开源在很大层度上会成为我们选择一个解决方案的重要维度。

　　除了这些，SQLite还有着比同是开源的Mysql、PostgreSQL数据库更快的处理效率，更低的资源占用。看起来很“完美”的东西背后往往也有着致命的缺陷。SQLite的缺陷虽不能说致命，但也足以让你在选择的过程中说NO。如果你要求更精准的控制数据库访问，细粒度锁（SQLite只提供数据库级的锁定）以及很好的并发性（虽然可以手动实现并发，但是性能不高，也容易出现死锁），SQLite也许不适合你。另外，SQLite也不适合远程访问，虽然可以通过网络共享的方式运行，但是会存在文件锁定的问题，而且访问网络共享相关的延迟会导致性能的下降。

安装配置

前面说过了，使用SQLite是超级简单的，无需安装，只需要在官网下载库文件添加引用即可。当然，还有很简单的一些配置。还有更简单的方法，使用Nuget添加SQLite库文件并自动配置，这简直是一键搞定啊。

首先，在Nuget中找到SQLite。这里我们选择第一个安装。

　　会自动安装如下库。

　　安装后会自动添加如下库的引用。

　　并自动添加如下配置。

 <?xml version="1.0" encoding="utf-8"?>

 <configuration>

   <configSections>

     <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->

     <section name="entityFramework"

       type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"

       requirePermission="false"/>

   </configSections>

   <entityFramework>

     <defaultConnectionFactory type="System.Data.Entity.Infrastructure.LocalDbConnectionFactory, EntityFramework">

       <parameters>

         <parameter value="v11.0"/>

       </parameters>

     </defaultConnectionFactory>

     <providers>

       <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer"/>

       <provider invariantName="System.Data.SQLite.EF6" type="System.Data.SQLite.EF6.SQLiteProviderServices, System.Data.SQLite.EF6"/>

     </providers>

   </entityFramework>

 <system.data>

     <DbProviderFactories>

     <remove invariant="System.Data.SQLite.EF6"/><add name="SQLite Data Provider (Entity Framework 6)" invariant="System.Data.SQLite.EF6"

         description=".NET Framework Data Provider for SQLite (Entity Framework 6)" type="System.Data.SQLite.EF6.SQLiteProviderFactory, System.Data.SQLite.EF6"/></DbProviderFactories>

   </system.data></configuration>

SQLite的使用

上面的准备工作已经就绪。接下来开始使用SQLite。这里不对如何创建数据库作介绍，在实际工作中，我一般会选择使用Navicat for SQLite来创建数据库，方便快捷。如果有编码创建数据库要求，自行问度娘。如果要使用Linq，别忘了添加System.Data.Linq的引用。

     /// <summary>

     /// SQLite数据库帮助类

     /// </summary>

     public class SQLiteHelper

     {

         /// <summary>

         /// 数据库路径

         /// </summary>

         private static readonly string m_DataSource = ConfigurationManager.AppSettings["Test"];

         /// <summary>

         /// ConnectionString样例：Data Source=Test.db;Pooling=true;FailIfMissing=false

         /// </summary>

         private static readonly string m_ConnectionString;

         /// <summary>

         /// 静态构造函数，初始化连接字符串，检查数据库连接

         /// </summary>

         static SQLiteHelper()

         {

             try

             {

                 SQLiteConnectionStringBuilder connectionStringBuilder = new SQLiteConnectionStringBuilder

                 {

                     Version = ,

                     Pooling = true,

                     FailIfMissing = false,

                     DataSource = m_DataSource

                 };

                 m_ConnectionString = connectionStringBuilder.ConnectionString;

                 using (SQLiteConnection conn = new SQLiteConnection(m_ConnectionString))

                 {

                     conn.Open();

                 }

             }

             catch { }

         }

         #region basic method

         /// <summary>

         /// 获得连接对象

         /// </summary>

         /// <returns></returns>

         private static SQLiteConnection GetSQLiteConnection()

         {

             return new SQLiteConnection(m_ConnectionString);

         }

         /// <summary>

         /// 预备命令

         /// </summary>

         /// <param name="cmd"></param>

         /// <param name="conn"></param>

         /// <param name="cmdText"></param>

         /// <param name="commandParameters"></param>

         private static void PrepareCommand(SQLiteCommand cmd, SQLiteConnection conn, string cmdText, params object[] commandParameters)

         {

             if (conn.State != ConnectionState.Open)

                 conn.Open();

             cmd.Parameters.Clear();

             cmd.Connection = conn;

             cmd.CommandText = cmdText;

             cmd.CommandType = CommandType.Text;

             cmd.CommandTimeout = ;

             if (commandParameters != null)

             {

                 foreach (object parm in commandParameters)

                     cmd.Parameters.AddWithValue(string.Empty, parm);

                 //for (int i = 0; i < p.Length; i++)

                 //    cmd.Parameters[i].Value = p[i];

             }

         }

         /// <summary>

         /// 返回受影响的行数

         /// </summary>

         /// <param name="cmdText">执行语句</param>

         /// <param name="commandParameters">传入的参数</param>

         /// <returns>返回受影响行数</returns>

         public static int ExecuteNonQuery(string cmdText, params object[] commandParameters)

         {

             SQLiteCommand command = new SQLiteCommand();

             using (SQLiteConnection connection = GetSQLiteConnection())

             {

                 PrepareCommand(command, connection, cmdText, commandParameters);

                 return command.ExecuteNonQuery();

             }

         }

         /// <summary>

         /// 返回表集合

         /// </summary>

         /// <param name="cmdText">执行语句</param>

         /// <param name="commandParameters">传入的参数</param>

         /// <returns>返回DataSet</returns>

         public static DataSet ExecuteDataset(string cmdText, params object[] commandParameters)

         {

             DataSet ds = new DataSet();

             SQLiteCommand command = new SQLiteCommand();

             using (SQLiteConnection connection = GetSQLiteConnection())

             {

                 PrepareCommand(command, connection, cmdText, commandParameters);

                 SQLiteDataAdapter da = new SQLiteDataAdapter(command);

                 da.Fill(ds);

             }

             return ds;

         }

         /// <summary>

         /// 返回SqlDataReader对象

         /// </summary>

         /// <param name="cmdText">执行语句</param>

         /// <param name="commandParameters">传入的参数</param>

         /// <returns>返回SQLiteDataReader</returns>

         public static SQLiteDataReader ExecuteReader(string cmdText, params object[] commandParameters)

         {

             SQLiteCommand command = new SQLiteCommand();

             SQLiteConnection connection = GetSQLiteConnection();

             try

             {

                 PrepareCommand(command, connection, cmdText, commandParameters);

                 SQLiteDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);

                 return reader;

             }

             catch

             {

                 connection.Close();

                 throw;

             }

         }

         /// <summary>

         /// 返回表第一行

         /// </summary>

         /// <param name="cmdText">执行语句</param>

         /// <param name="commandParameters">传入的参数</param>

         /// <returns>返回：第一行</returns>

         public static DataRow ExecuteDataRow(string cmdText, params object[] commandParameters)

         {

             DataSet ds = ExecuteDataset(cmdText, commandParameters);

             if (ds != null && ds.Tables.Count >  && ds.Tables[].Rows.Count > )

                 return ds.Tables[].Rows[];

             return null;

         }

         /// <summary>

         /// 返回结果集中的第一行第一列，忽略其他行或列

         /// </summary>

         /// <param name="cmdText">执行语句</param>

         /// <param name="commandParameters">传入的参数</param>

         /// <returns>返回：第一行第一列</returns>

         public static object ExecuteScalar(string cmdText, params object[] commandParameters)

         {

             SQLiteCommand cmd = new SQLiteCommand();

             using (SQLiteConnection connection = GetSQLiteConnection())

             {

                 PrepareCommand(cmd, connection, cmdText, commandParameters);

                 return cmd.ExecuteScalar();

             }

         }

         #endregion

         #region advanced method

         /// <summary>

         /// 获取表所有数据

         /// </summary>

         /// <typeparam name="T">实体类型</typeparam>

         /// <param name="tableName">表名</param>

         /// <returns>表所有数据</returns>

         public static List<T> GetTableData<T>(string tableName) where T : class

         {

             List<T> dataList = new List<T>();

             try

             {

                 using (SqliteDataContext context = new SqliteDataContext(new SQLiteConnection(m_ConnectionString)))

                 {

                     string sql = "select * from " + tableName;

                     dataList = context.ExecuteQuery<T>(sql).ToList();

                     context.SubmitChanges();

                 }

             }

             catch { }

             return dataList;

         }

         /// <summary>

         /// 获取表数据

         /// </summary>

         /// <typeparam name="T">实体类型</typeparam>

         /// <param name="cmdText">sql语句</param>

         /// <param name="parameter">参数</param>

         /// <returns>表所有数据</returns>

         public static List<T> GetTableData<T>(string cmdText, params object[] parameter) where T : class

         {

             List<T> dataList = new List<T>();

             try

             {

                 using (SqliteDataContext context = new SqliteDataContext(new SQLiteConnection(m_ConnectionString)))

                 {

                     dataList = context.ExecuteQuery<T>(cmdText, parameter).ToList();

                 }

             }

             catch {}

             return dataList;

         }

         /// <summary>

         /// 插入表数据

         /// </summary>

         /// <typeparam name="T">数据类型</typeparam>

         /// <param name="tableName">表名</param>

         /// <param name="dataList">数据集合</param>

         /// <returns>true或false</returns>

         public static bool BatchInsert<T>(string tableName, List<T> dataList)

         {

             try

             {

                 if (dataList != null && dataList.Count > )

                 {

                     var temp = dataList[];

                     PropertyInfo[] propertyInfos = temp.GetType().GetProperties();

                     List<string> propertyStrs = new List<string>();

                     string propertyStr = "";

                     foreach (var propertyInfo in propertyInfos)

                     {

                         propertyStrs.Add(propertyInfo.Name);

                         propertyStr = propertyStr + "@" + propertyInfo.Name + ",";

                     }

                     propertyStr = propertyStr.Remove(propertyStr.Length - );

                     using (SQLiteConnection conn = new SQLiteConnection(m_ConnectionString))

                     {

                         using (SQLiteCommand command = new SQLiteCommand(conn))

                         {

                             command.Connection.Open();

                             using (SQLiteTransaction transaction = conn.BeginTransaction())

                             {

                                 command.Transaction = transaction;

                                 command.CommandText = "insert into " + tableName + " values(" + propertyStr + ")";

                                 foreach (var needInsertData in dataList)

                                 {

                                     command.Parameters.Clear();

                                     for (int i = ; i < propertyStrs.Count; i++)

                                     {

                                         command.Parameters.AddWithValue("@" + propertyStrs[i], propertyInfos[i].GetValue(needInsertData, null));

                                     }

                                     command.ExecuteNonQuery();

                                 }

                                 transaction.Commit();

                             }

                         }

                     }

                 }

             }

             catch (Exception ex)

             {

                 return false;

             }

             return true;

         }

         /// <summary>

         /// 删除表数据

         /// </summary>

         /// <param name="tableName">表名</param>

         /// <returns>true或false</returns>

         public static bool DeleteTableData(string tableName)

         {

             try

             {

                 using (SQLiteConnection conn = new SQLiteConnection(m_ConnectionString))

                 {

                     using (SQLiteCommand command = new SQLiteCommand(conn))

                     {

                         command.Connection.Open();

                         command.CommandText = "delete from " + tableName;

                         command.ExecuteNonQuery();

                     }

                 }

             }

             catch (Exception ex)

             {

                 return false;

             }

             return true;

         }

         #endregion

     }

SQLiteHelper

     /// <summary>

     /// Linq to SQLite

     /// </summary>

     public class SQLiteDataContext : DataContext

     {

         public SQLiteDataContext(string connection, MappingSource mappingSource) :

             base(connection, mappingSource)

         {

         }

         public SQLiteDataContext(IDbConnection connection, MappingSource mappingSource) :

             base(connection, mappingSource)

         {

         }

         public SQLiteDataContext(string connectionString) :

             base(new SQLiteConnection(connectionString))

         {

         }

         public SQLiteDataContext(IDbConnection connection) :

             base(connection)

         {

         }

     }

SQLiteDataContext

　　如果看了上面的Code，会发现查询表数据方法是使用的Linq。这种方式相比遍历IDataReader要高效得多。只是目前.NET只支持查询，如果想要实现增删改需要第三方库支持。常见的有Dblinq 、linqconnect、linq2db和ado.net sqlite data provider等。不过使用事务批量插入数据也非常的快。

写在后面

　　SQLite作为一款轻型高效的嵌入式数据库，适合简单高性能低并发的应用，在移动端使用将会是广泛的，如果是高通信量的Web站点，SQLite是不合适的。

　　据@InkFx指出，也看了一些大数据案例，证实SQLite对高负载支持也很好（未亲自测试）。当然，这种高负载也会受制于运行时的文件系统。

扩展阅读：

http://blchen.com/sqlite-data-provider-in-visual-studio-2012/