2022年10月 LiteDB数据库-.Net Core中的使用

---

前言

LiteDB 是一个小型、快速、轻量级的 .NET NoSQL 嵌入式数据库，也就是我们常说的 K/V 数据库，完全用 C# 托管代码开发，并且是免费和开源的，Github Star 数近 7k。它非常适合在移动应用 （Xamarin iOS/Android）和小型的桌面/Web 应用中使用。

LiteDB 的灵感来自 MongoDB 数据库，所以它的 API 和 MongoDB 的 .NET API 非常相似。

LiteDB官网链接：http://www.litedb.org/

一、LiteDB概念

1.LiteDB的语法

• LiteDB 支持类似 SQL 的语言来处理数据和结构操作。您可以使用非常相似的 SQL 关系语言插入、更新、删除或查询数据库
• LINQ 表达式（lambda 函数）可用于在 C# 代码中创建流畅的 API 查询
• 新的轻量级数据库管理工具中支持所有 SQL 命令
• 您还可以从查询引擎获取详细的 EXPLAIN PLAN，以检查您的查询是否将以最佳性能运行

2.LiteDB的功能

• 线程安全，具有交叉收集事务
• 没有对读者的锁。每个集合写入器锁
• 支持部分文档查找/加载程序和仅索引查询
• 文件存储，用于在数据库中存储文件和流
• 用于轻松导入/导出数据和管理数据库的系统集合

3.LiteDB支持的平台

支持 .NET 框架 4.5 和 .NET 标准 1.3 和 2.0、.NET Core 2.0+、UWP、Linux、移动 Xamarin（iOS 和 Android）、Unity…在每个 .NET 平台中

一、.Net Core中使用LiteDB

1.创建项目

2. Nuget 安装 LiteDB

Install-Package LiteDB

3. 创建实体类

public class Customer
{
    public int Id { get; set; }
    public string? Name { get; set; }
    public int Age { get; set; }
    public string[]? Phones { get; set; }
    public bool IsActive { get; set; }
}

4. 打开数据库

如果不存在会自动创建。

using var db = new LiteDatabase(@"MyData.db");

5. 下面是一个增删改查的例子

// 获取 Customers 集合
var col = db.GetCollection<Customer>("customers");  

// 创建一个对象
var customer = new Customer
{
    Name = "John Doe",
    Phones = new string[] { "8000-0000", "9000-0000" },
    Age = 39,
    IsActive = true
};

// 在 Name 字段上创建唯一索引
col.EnsureIndex(x => x.Name, true); 

// 数据插入
col.Insert(customer);

// 数据查询 
List<Customer> list = col.Find(x => x.Age > 20).ToList(); 
Customer user = col.FindOne(x => x.Age > 20);

// 数据删除 
col.Delete(user.Id); 

第一次查询，有数据

第二次查询，没数据

数据库文件在Debug下

6. LiteDB进行文件存储

var storage = db.GetStorage<int>();

// 上传文件
storage.Upload(123, @"C:\Temp\picture-01.jpg");

// 下载文件
storage.Download(123, @"C:\Temp\copy-of-picture-01.jpg");

二、LiteDB的管理工具

LiteDB的管理工具地址：https://github.com/mbdavid/LiteDB.Studio