调试 CLR 数据库对象

项目
03/06/2017

SQL Server支持调试数据库中 (CLR) 对象调试 Transact-SQL 和公共语言运行时。 SQL Server中调试的关键方面是设置和使用方便，以及SQL Server调试器与 Microsoft Visual Studio 调试器的集成。此外，还可以跨语言进行调试。用户可以从 Transact-SQL 无缝单步执行 CLR 对象，反之亦然。 SQL Server Management Studio 中的 Transact-SQL 调试器无法用于调试托管数据库对象，但您可以通过使用 Visual Studio 中的调试器来调试这些对象。 Visual Studio 中的托管数据库对象调试支持所有常见的调试功能，例如，在服务器上执行的例程中的“单步执行”语句和“逐过程”语句。调试器可以在调试过程中设置断点、检查调用堆栈、检查变量以及修改变量值。请注意，Visual Studio .NET 2003 无法用于 CLR 集成编程或调试。 SQL Server包括预安装的 .NET Framework，Visual Studio .NET 2003 无法使用 .NET Framework 2.0 程序集。

有关使用 Visual Studio 调试托管代码的详细信息，请参阅 Visual Studio 文档中的“调试托管代码”主题。

调试权限和限制

调试是一项高特权操作，因此，只有 sysadmin 固定服务器角色的成员才能在SQL Server执行此操作。

调试时存在下列限制：

调试 CLR 例程时仅限一次运行一个调试器实例。存在此限制的原因是，所有 CLR 代码执行在命中断点时都会冻结，并且执行在调试器从断点继续运行之前不会继续。但是，可以继续在其他连接中调试 Transact-SQL。尽管 Transact-SQL 调试不会冻结服务器上的其他代码执行，但是可能会使其他连接通过持有锁进行等待。
无法调试现有连接，只能调试新连接，因为SQL Server需要有关客户端和调试器环境的信息，然后才能建立连接。

由于上述限制，我们建议在测试服务器上而不是生产服务器上调试 Transact-SQL 和 CLR 代码。

关于调试托管数据库对象的概述

在 SQL Server 中调试采用逐个连接的模型。一个调试器只能检测和调试其附加到的客户端连接的活动。由于调试器的功能不受连接类型的限制，因此表格格式数据流 (TDS) 和 HTTP 连接都可以进行调试。但是，SQL Server不允许调试现有连接。调试支持在服务器上执行的例程中使用所有常见的调试功能。调试器和SQL Server之间的交互通过分布式组件对象模型 (COM) 发生。

有关调试托管存储过程、函数、触发器、用户定义类型和聚合的详细信息和方案，请参阅 Visual Studio 文档中的“SQL Server CLR 集成数据库调试”主题。

必须在 SQL Server 实例上启用 TCP/IP 网络协议，才能使用 Visual Studio 进行远程开发、调试和开发。有关在服务器上启用 TCP/IP 协议的详细信息，请参阅配置客户端协议。

调试托管数据库对象

打开 Microsoft Visual Studio，创建新的 SQL Server 项目，并建立与 SQL Server 实例上的数据库的连接。
创建一种新类型。在解决方案资源管理器右键单击项目，选择“添加”和“新建项...”从“添加新项”窗口中，选择“存储过程”、“用户定义函数”、“用户定义类型”、“触发器”、“聚合”或“类”。指定新类型的源文件的名称，然后单击“ 添加”。
将此新类型的代码添加到文本编辑器中。有关示例存储过程的示例代码，请参阅本主题后面的部分。
添加测试该类型的脚本。在“解决方案资源管理器”中，展开“TestScripts”目录，双击“Test.sql”打开默认的测试脚本源文件。将调用要调试的代码的测试脚本添加到文本编辑器中。示例脚本见下文。
将一个或多个断点放在源代码中。在文本编辑器中右键单击要调试的函数或例程中的一行代码，然后选择“ 断点 ”和“ 插入断点”。即会添加断点，并以红色突出显示该行代码。
在 “调试 ”菜单中，选择“ 开始调试” 以编译、部署和测试项目。将运行 Test.sql 中的测试脚本，并将调用托管数据库对象。
如果在断点代码执行暂停时出现表示指令指针的黄色箭头，则您可以开始调试托管数据库对象。可以从“调试”菜单单步执行，将指令指针前进到下一行代码。 “ 局部变量 ”窗口用于观察指令指针当前突出显示的对象的状态。可以将变量添加到“ 监视 ”窗口。受监视变量的状态在整个调试会话过程中都可以进行观察，而不是仅当变量位于当前由指令指针突出显示的代码行中时才可以进行观察。从“调试”菜单中选择“继续”以使指令指针前进到下一个断点或完成例程的执行（如果不再有其他断点）。

示例

以下示例将SQL Server版本返回给调用方。

using System;  
using System.Data;  
using System.Data.SqlTypes;  
using System.Data.SqlClient;  
using Microsoft.SqlServer.Server;   
  
public class StoredProcedures   
{  
   [Microsoft.SqlServer.Server.SqlProcedure]  
   public static void GetVersion()  
   {  
   using(SqlConnection connection = new SqlConnection("context connection=true"))   
   {  
      connection.Open();  
      SqlCommand command = new SqlCommand("select @@version",  
                                           connection);  
      SqlContext.Pipe.ExecuteAndSend(command);  
      }  
   }  
}

Visual Basic

Imports System  
Imports System.Data  
Imports System.Data.Sql  
Imports System.Data.SqlTypes  
Imports Microsoft.SqlServer.Server  
Imports System.Data.SqlClient  
  
Partial Public Class StoredProcedures   
    <Microsoft.SqlServer.Server.SqlProcedure> _  
    Public Shared Sub GetVersion()  
        Using connection As New SqlConnection("context connection=true")  
            connection.Open()  
            Dim command As New SqlCommand("SELECT @@VERSION", connection)  
            SqlContext.Pipe.ExecuteAndSend(command)  
        End Using  
    End Sub  
End Class

下面是调用上面定义的 GetVersion 存储过程的测试脚本。

EXEC GetVersion

另请参阅

公共语言运行时 (CLR) 集成编程概念

通过

调试 CLR 数据库对象

调试权限和限制

关于调试托管数据库对象的概述

调试托管数据库对象

示例

另请参阅

其他资源