在 SQL Server 单元测试中,Transact-SQL 测试脚本运行并返回结果。 有时,结果会作为结果集返回。 可以使用测试条件来验证结果。 例如,可以使用测试条件来检查特定结果集中返回的行数,或验证特定测试运行的时间。 有关测试条件的详细信息,请参阅 在 SQL Server 单元测试中使用测试条件。
而不是使用测试条件,您还可以使用 Transact-SQL 断言,它们是 Transact-SQL 脚本中的 THROW 或 RAISERROR 语句。 在某些情况下,你可能更喜欢使用 Transact-SQL 断言而不是测试条件。
使用 Transact-SQL 断言
在决定使用 Transact-SQL 断言或使用测试条件验证数据之前,应考虑以下几点。
性能。 在服务器上运行 Transact-SQL 断言的速度比先将数据移到客户端计算机并在本地处理要快。
熟悉语言。 你可能更喜欢基于当前专业知识的特定语言,因此请选择 Transact-SQL 断言或 C# 或 Visual Basic 测试条件。
复杂的验证。 在某些情况下,可以在 C# 或 Visual Basic 中生成更复杂的测试,并在客户端上验证测试。
简单性。 使用预定义的测试条件通常比在 Transact-SQL 中编写等效脚本更简单。
旧版验证库。 如果已有执行验证的代码,则可以在 SQL Server 单元测试中使用它,而不是使用测试条件。
标记具有预期异常的单元测试方法
若要标记具有预期异常的 SQL Server 单元测试方法,请添加以下属性:
<ExpectedSqlException(MessageNumber=nnnnn, Severity=x, MatchFirstError=false, State=y)> _
[ExpectedSqlException(MessageNumber=nnnnn, Severity=x, MatchFirstError=false, State=y)]
Where:
- nnnnn 是预期的消息数,例如 14025
- x 是预期异常的严重性
- y 是预期异常的状态
将忽略任何未指定的参数。 将这些参数传递给数据库代码中的RAISERROR语句。 如果指定 MatchFirstError = false,则此属性会与异常中的任何 SqlErrors 匹配。 默认行为(MatchFirstError = true)是仅匹配发生的第一个错误。
有关如何使用预期异常和负 SQL Server 单元测试的示例,请参阅 演练:创建和运行 SQL Server 单元测试。
RAISERROR 语句
注释
使用 THROW 而不是 RAISERROR。
RAISERROR 现已弃用。
可以直接在服务器上使用 Transact-SQL 脚本中的RAISERROR 语句来使用 Transact-SQL 断言。 其语法为:
RAISERROR (@ErrorMessage, @ErrorSeverity, @ErrorState)
地点:
-
@ErrorMessage是任何用户定义的错误消息。 可以将此消息字符串格式化,类似于printf_s函数。 -
@ErrorSeverity是用户定义的严重性级别,介于 0 到 18。
注释
严重级别的值“0”和“10”不会导致 SQL Server 单元测试失败。 可以使用范围 0 - 18 中的任何其他值来使测试失败。
@ErrorState 是 1 - 127 的任意整数。 可以使用此整数来区分在代码中不同位置引发的单个错误的出现次数。
有关详细信息,请参阅 RAISERROR。 本文提供了在 SQL Server 单元测试中使用的示例 RAISERROR : 如何:编写在单个事务范围内运行的 SQL Server 单元测试。