C# 中 SQLite 使用介绍

关于SQLite

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

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

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

　　除了这些，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 = 3,
                    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 = 30;
            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 > 0 && ds.Tables[0].Rows.Count > 0)
                return ds.Tables[0].Rows[0];
            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 > 0)
                {
                    var temp = dataList[0];
                    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 - 1);

                    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 = 0; 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
    }

    /// <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)
        {
        }
    }

　　如果看了上面的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/