LiteDB - 一个单数据文件 .NET NoSQL 文档存储
LiteDB 一个小巧、快速、轻量级的 NoSQL 嵌入式数据库。
- Serverless NoSQL 文档存储
- 类似于 MongoDB 的简单 API
- 100% C# 代码,支持 .NET 3.5 / .NET 4.0 / NETStandard 1.3 / NETStandard 2.0,单 DLL (小于 300 kb)
- 支持线程和进程安全
- 支持文档/操作级别的 ACID
- 支持写失败后的数据还原 (日志模式)
- 可使用 DES (AES) 加密算法进行数据文件加密
- 可使用特性或 fluent 映射 API 将你的 POCO 类映射为
BsonDocument
- 可存储文件与流数据 (类似 MongoDB 的 GridFS)
- 单数据文件存储 (类似 SQLite)
- 支持基于文档字段索引的快速搜索 (每个集合支持多达 16 个索引)
- 支持 LINQ 查询
- Shell 命令行 - 试试这个在线版本
- 相当快 - 这里是与 SQLite 的对比结果
- 开源,对所有人免费 - 包括商业应用
- 可以从 NuGet 安装:
Install-Package LiteDB
4.0 新特性
- 新的
表达式/路径
索引/查询支持。参考表达式 - 支持
Include
嵌套 - 优化的查询执行过程 (包含简单的调试说明)
- 修复并发问题
- 移除事务和索引自动创建
- 支持全扫描搜索和 LINQ 搜索
- 新的 shell 命令:基于表达式选择/转换文档以及更新字段
- 浏览全部更新日志
在线试用
试试 LiteDB Web Shell。 由于安全原因,在线版本中,并非所有命令都可用。请使用离线版本进行全特性测试。
文档
下载
可以在 LiteDB Releases 下载源代码或二进制文件。
LiteDB 使用入门
一个存储、搜索文档的简单示例:
// 创建你的 POCO 类
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; }
}
// 打开数据库 (如果不存在则创建)
using(var db = new LiteDatabase(@"MyData.db"))
{
// 获得 customer 集合
var col = db.GetCollection<Customer>("customers");
// 创建你的新 customer 实例
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);
// 插入新的 customer 文档 (Id 是自增的)
col.Insert(customer);
// 更新集合中的一个文档
customer.Name = "Joana Doe";
col.Update(customer);
// 使用 LINQ 查询文档 (未使用索引)
var results = col.Find(x => x.Age > 20);
}
使用 fluent 映射器和跨文档引用处理更复杂的数据模型
// DbRef 交叉引用
public class Order
{
public ObjectId Id { get; set; }
public DateTime OrderDate { get; set; }
public Address ShippingAddress { get; set; }
public Customer Customer { get; set; }
public List<Product> Products { get; set; }
}
// 重用全局实例的映射器
var mapper = BsonMapper.Global;
// "Produts" 和 "Customer" 来自其他集合 (而不是嵌入的文档)
mapper.Entity<Order>()
.DbRef(x => x.Customer, "customers") // 1 对 1/0 引用
.DbRef(x => x.Products, "products") // 1 对多引用
.Field(x => x.ShippingAddress, "addr"); // 嵌入的子文档
using(var db = new LiteDatabase("MyOrderDatafile.db"))
{
var orders = db.GetCollection<Order>("orders");
// 当查询 Order 时,包含引用
var query = orders
.Include(x => x.Customer)
.Include(x => x.Products) // 1 对多引用
.Find(x => x.OrderDate <= DateTime.Now);
// 每个 Order 实例都会加载 Customer/Products 引用
foreach(var order in query)
{
var name = order.Customer.Name;
...
}
}
应用场景
- 桌面/本地化的小应用程序
- 应用程序文件格式(Application file format)
- 小型 web 应用程序
- 一个账户/用户一个数据库的数据存储
- 少量并发写操作
第三方工具
- 一个 GUI 查看器工具: https://github.com/falahati/LiteDBViewer
- 一个 GUI 编辑器工具: https://github.com/JosefNemec/LiteDbExplorer
- LiteDB 管理工具: https://darwich.mx/downloads/
- Lucene.NET 目录: https://github.com/sheryever/LiteDBDirectory
- LINQPad 支持: https://github.com/adospace/litedbpad
- F# 支持: https://github.com/Zaid-Ajaj/LiteDB.FSharp
- PowerShell 封装: https://github.com/v2kiran/PSLiteDB
更新日志
每个发布版本的变化详情都记录在发行说明中。
许可证
Copyright (c) 2017 - Maurício David
致谢
特别感谢 @negue 和 @szurgot 对可移植版本提供的帮助,以及 @lidanger 的简体中文翻译。