SQL Server (mssql)

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

通过 Microsoft.Data.SqlClient 连接 SQL Server，负责 SQL Server 的标识符、参数、分页和写入方言。应用通过数据访问接口或数据服务使用它，公共的映射、条件和数据模式仍沿用数据引擎的组织方式。

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

部署与连接

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

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

[plugins zongsoft data]
nuget:Zongsoft.Data

[plugins zongsoft data mssql]
nuget:Zongsoft.Data.MsSql

可追溯的接入范例

Discussions 提供了对应的 数据库脚本。沿用真实的 Feedback、Forum、Thread、Post 等模型和 Discussions.mapping，查询与写入见数据服务。脚本存在并不表示所有表和所有驱动组合都已完成端到端验证；尤其要核对模型成员、列长度、默认值、关系与当前业务使用的表。

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

ConnectionSettingsTest.cs

public void MaximumPoolSizeMatchesProviderDefault()
{
	var settings = Configuration.MsSqlConnectionSettingsDriver.Instance.GetSettings("Server=localhost");
	var builder = new SqlConnectionStringBuilder();

	Assert.Equal((uint)builder.MaxPoolSize, settings.MaximumPoolSize);
}

这个离线测试只验证连接设置与提供程序的默认连接池上限一致；Server=localhost 不会在这里建立数据库连接。完整连接还需数据库名、身份凭据及运行环境相关设置。

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

此驱动需要注意什么

💡 本例使用集成身份验证，数据库看到的是实际运行宿主的身份。交互终端、Windows 服务和 Web 应用池可能使用不同账户；本机调试成功不代表服务账户也有数据库权限。

接入后如何验证

先以部署环境的运行身份验证连接，再核对对象架构、表权限、自增标识返回及事务隔离。连接加密与证书验证由客户端配置和服务器共同决定，应按部署环境配置，不能靠关闭验证掩盖证书问题。

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

项目资源

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