SQLite (sqlite)

SQLite 数据驱动的部署、连接配置与专项验证。

通过 Microsoft.Data.Sqlite 访问进程内数据库。应用部署需要保留原生运行库，文件库还需要正确的目录和文件权限。应用通过数据访问接口或数据服务使用它，公共的映射、条件和数据模式仍沿用数据引擎的组织方式。

项目项	值
源码目录	Zongsoft.Data/drivers/sqlite
NuGet 包	Zongsoft.Data.SQLite
连接及脚本驱动键	SQLite

部署与连接

把下面的片段追加到已有宿主的部署清单。如果已经部署 Data，不必再次声明相同包；驱动的清单、程序集及运行依赖应一起交付，参见部署工具。

已有宿主部署清单（追加片段）

[plugins zongsoft data]
nuget:Zongsoft.Data

[plugins zongsoft data sqlite]
nuget:Zongsoft.Data.SQLite

可追溯的接入范例

Discussions 当前没有此驱动的数据库脚本，接入范例采用框架本驱动的测试项目。测试模型、映射和初始化脚本应作为一组使用，不能直接把其它方言的 Discussions 建表脚本视为兼容。

来源：framework/Zongsoft.Data/drivers/sqlite/test/DatabaseFixture.cs（节选；上下文见源文件）。

DatabaseFixture.cs

private static readonly string DATABASE_FILE = Path.Combine(AppContext.BaseDirectory, "test.db");
private static readonly string CONNECTION_STRING = $"DataSource={DATABASE_FILE};PRAGMA:optimize;PRAGMA:journal_mode=WAL;PRAGMA:synchronous=NORMAL;PRAGMA:temp_store=MEMORY;";

来源：framework/Zongsoft.Data/drivers/sqlite/test/DatabaseFixture.cs（节选；上下文见源文件）。

DatabaseFixture.cs

this.ConnectionSettings = Configuration.SQLiteConnectionSettingsDriver.Instance.GetSettings(CONNECTION_STRING);
this.Accessor = DataAccessProvider.Instance.GetAccessor("Test", new DataAccessOptions([this.ConnectionSettings]));

这里的 Test 是测试访问器名称，CONNECTION_STRING 和 DATABASE_FILE 来自同一夹具。该夹具会删除测试文件并执行初始化脚本，只能在测试输出目录中运行。SQLite 的 WAL 参数和 DuckDB 的文件路径都是现有测试的一部分，不意味着 Discussions 已经适配这两种数据库。

插件宿主的连接项仍放在 /Data/ConnectionSettings，驱动键使用本页索引中的规范名称。业务取得的访问器名称必须与部署配置对应；Discussions 按模块名取得访问器，测试夹具则在代码中显式传入连接设置。两条入口的区别见连接与数据源。命名 SQL 仍由其 script 的 driver 决定，切换连接不会翻译手写 SQL。

此驱动需要注意什么

💡 相对数据库路径受运行环境影响，应确认最终打开的文件位置。不同连接的内存库不一定共享数据；创建数据库文件也不代表业务表已经建立。

接入后如何验证

可以先完成无表的首次查询，再在独立文件库中准备业务表。随后验证外键、并发写入、锁等待与关闭后重新打开的结果。检查备份和替换文件时，必须考虑日志文件及仍占用数据库的连接。

验证应覆盖一条查询、一组实际写入数据及失败恢复，再扩展到生产负载。可对照驱动选择与验收、连接配置和事务与一致性检查共同约束。

项目资源

源码目录 · 插件清单 · 中文项目说明