在ASP.NET 2.0中操作数据之七十二:调试存储过程
导言:
visual studio有很多的调试功能.我们只需要稍稍点点鼠标,敲敲键盘就可以使用断点(breakpoints)来打断某个程序的执行,并查看其状态.除了调试代码以外,visual studio也支持对sql server里面的存储过程进行调试.就像可以在asp.net页面的后台代码类或business logic layer class类里设置断点一样,我们也可以在存储过程里设置断点.
本文我们将考察如何在visual studio的server explorer里进入存储过程并设置断点.当asp.net程序调用该存储过程时就会碰到该断点.
注意:不幸的是只能在visual studio的professional和team systems版本里才能对存储过程设置断点.如果你使用的是visual web developer或visual studio的标准版,你就只能看教程是如何一步步的做的,但不能在自己的机器上实践.
sql server调试主题
microsoft sql server 2005集合了公共语言运行库(common language runtime (clr)),它可以被所有.net模块使用.因此sql server 2005支持对数据库对象的管理.
我们可以创建数据库对象,比如存储过程、用户定义的函数((udfs)等,就像在一个c#类里定义的方法一样.你可以在从.net framework或自己定义的类里使用这些存储过程和自定义函数.当然,sql server 2005也支持t-sql数据库对象.sql server 2005支持对t-sql数据库对象以及管理数据库对象(managed database objects)的调试.不过只能在visual studio 2005专业版或team systems版本里才行.本文我们将考察对t-sql数据库的调试.后面的教程我们将考察对管理数据库对象的调试.文章《overview of t-sql and clr debugging in sql server 2005》(http://blogs.msdn.com/sqlclr/archive/2006/06/29/651644.aspx)归纳了在visual studio里调试sql server 2005对象的3种途径:
.直接数据库调试(ddd)—在服务器资源管理器里进入某个t-sql数据库对象,比如存储过程或用户定义函数udfs.我们将在第一步考察该模式.
.应用程序调试—我们可以在一个数据库对象里设置断点,然后再返回到一个asp.net应用程序.当执行这些数据库对象时,将遇到断点并转到调试器.注意,在应用程序调试模式,我们不能在应用程序代码里打入一个数据库对象,所以我们必须直接在这些存储过程或用户义函数里设置断点.我们将在第二步考察该模式.
.通过一个sql server project来调试
visual studio专业版及team systems版包含一个sql server project类型,它通常用来创建管理数据库对象(managed database objects),我们将在后面的教程考察sql server projects及如何调试其内容.visual studio可以对本地或外部sql server实例进行调试。如果你使用的sql server数据库不在本地,那么自然,它就是一个外部实例.本文我们将使用本地sql server实例,调试外部sql server实例的存储过程要比调试本地的多出一些步骤.
如果你使用的是一个本地sql server实例,那么你可以从第一步看到结尾.如果你使用的是外部sql server实例,那么你首先要确保是以windows user帐户登录电脑,且包含一个连接到外部sql server实例的登录界面.此外,应全部以系统管理员角色登录.你可以参阅本文结尾的“debugging t-sql database objects on remote instances”部分,查看如何配置visual studio 和 sql server以调试外部实例.
最后,我们应该明白支持t-sql数据库对象调试的特性没有支持.net应用程序调试的特性丰富.比如,不支持断点条件过滤(breakpoint conditions and filters),只能用到寥寥几个调试窗口;你无法使用edit 和 continue等等。更多详情请参阅文章《limitations on debugger commands and features》(http://msdn2.microsoft.com/en-us/library/ms165035(vs.80).aspx)
第一步:直接进入储存过程
使用visual studio我们可以很容易地直接进入一个数据库对象。我们来看如何使用direct database debugging (ddd)特性进入northwind数据库里的products_selectbycategoryid存储过程.就像其名字揭示的那样,该存储过程返回特定category的产品信息。我们在第68章创建了该存储过程,在服务器资源管理器里展开northwind数据库节点,接下来进入存储过程文件夹,在products_selectbycategoryid存储过程上右键单击,选“step into stored procedure”,这将打开调试器.因为该存储过程接受一个@categoryid输入参数,我们输入1,这将返回“饮料”类产品的信息。
图1:使用值为“1”的@categoryid输入参数
指定@categoryid参数的值后,就可以执行存储过程了.不过调试器执行完第一条statement后就中止了,而不会完全运行存储过程.。注意边框上的黄色箭头,它指出了statement在存储过程的当前位置.你可以在watch窗口查看或编辑参数值,或者改写存储过程用到的参数名称.
图2:调试器调试完第一条statement后就中止了
希望一次只调试一条statement语句的话,点击工具栏上的“step over”按钮或按f10键。由于products_selectbycategoryid存储过程只包含了一条select statement,所以按f10键将跨过这条语句并完成存储过程的执行。执行完毕后,其结果将显示在 output窗口里,调速器也就中止了.
注意:t-sql调试发生在statement级别,但对select statement无效
第二步:为website设置应用程序调试
直接在服务器资源管理器里调试存储过程时需要手动设置,但很多时候我们感兴趣的是,当在asp.net应用程序里调用存储过程时才对其进行调试。当一个设置了断点的存储过程被应用程序调用,在执行过程中将遇到这个断点。我们可以查看和改变存储过程的参数值,就像我们在第一步做的那样.
不过在次此之前我们需要将asp.net web应用程序与sql server调试器联系起来.在解决方案资源管理器里,在website名称(aspnet_data_tutorial_74_cs)上右键单击,选“property pages”项,再在左边选“start options”,选中debuggers区域的sql server选择框,如图3:
图3:在应用程序的属性页选择sql server方框
另外,我们还要更新数据库连接字符串以禁用“连接池”。当关闭一个数据库的连接时,一个对应的sqlconnection对象将存放在连接池里。当建立一个数据库连接时,就可以重新获取该sqlconnection对象而用不着再创建一个新的连接.连接池提高了执行性能,默认时,其处于激活状态.不过在调试时我们将关闭连接池,因为处理从连接池检索来的连接时,不能正确的建立相应的调试基础构造(debugging infrastructure).
要禁用连接池的话,更新web.config文件的northwndconnectionstring,包含一个“pooling=false”设置.
<connectionstrings> <add name="northwndconnectionstring" connectionstring= "data source=./sqlexpress;attachdbfilename=|datadirectory|/northwnd.mdf; integrated security=true;user instance=true;pooling=false" providername="system.data.sqlclient" /> </connectionstrings>
注意:一旦你完成从asp.net应用程序对sql server的调试后,务必还原连接池,在连接字符串里将pooling设置删除或设置为“pooling=true”.
完成设置后,我们还需要对存储过程添加一个断点,并开始调试
第三步:添加断点并调试
打开products_selectbycategoryid存储过程,在select statement的开头部分设置断点。方法点击边框恰当的地方或将光标放在select statement开始的地方再按f9。如图9所示,断点在边框呈现为一个红色圆点.
图4:在products_selectbycategoryid存储过程设置断点
为了在客户端程序对一个 sql 数据库对象进行调试,我们有必要设置数据库支持“应用程序调试”(application debugging),在服务器资源管理器里点到northwnd.mdf节点,右键单击,选“application debugging”.
图5:确保选中application debugging 项
当设置好断点且激活“application debugging ”项时,我们就可以从asp.net 应用程序调用存储过程来进行调试。要调试的话,在“调试”菜单里选“开始调试”,或点 f5或点工具栏里的绿色小图标。这将开启调试器.
products_selectbycategoryid存储过程是在第68章创建的,其对应的页面(~/advanceddal/existingsprocs.aspx)包含了一个gridview控件,以显示该存储过程返回的结果.在浏览器里登录该页面,当执行过程遇到设置的断点时页面将返回到visual studio,就像在第一步看到的那样,我们可以进入存储过程的statements,查看并修改参数值.
图6:existingsprocs.aspx页面最开始显示的是 饮料类的产品
图7:执行到存储过程设置的断点
在如图7所示的 watch 窗口,参数@categoryid的值为1,这是由于existingsprocs.aspx页面最开始显示的是饮料类产品的信息,而饮料类的categoryid 值为1.在下拉列表里选择一个不同的值。这将导致页面回传并重新执行products_selectbycategoryid存储过程。再次遇到断点时,@categoryid 参数的值就是你在下拉列表框里选择的categoryid值.
图8:在下拉列表里选择一个不同的类
图9:参数@categoryid反映的是在web页面选择的类
注意:如果你登录existingsprocs.aspx 页面时,没有碰到在products_selectbycategoryid存储过程里设置的断点,一定要确保asp.net应用程序的“属性页”的 debuggers区域的sql server项被选中;关闭连接池;激活数据库的application debugging项.如果仍然还有问题的话,重新启动visual studio并再试一次.
调试t-sql 数据库对象的远程实例
在本地电脑上通过visual studio调试是比较直观容易的,但如果sql server和visual studio没有装在同一台机器上的话,我们需要做一些设置以使各方面工作正常,为此我们要做2方面的工作:
.确保以系统管理员的角色(sysadmin role)通过ado.net连接到数据库
.确保开发环境上visual studio使用的windows user帐户是一个有效的属于系统管理员的角色(sysadmin role)的sql server登录帐户.
第一项相对比较简单.首先确定从asp.net应用程序连接到数据库的用户帐户,接下来通过sql server management studio,将该帐户添加到sysadmin角色.
第二项,你用来调试程序的windows user帐户必须是连接到远程数据库的一个有效帐户,问题就在于你在本地工作站登录的windows帐户不一定就是登录sql server的有效帐户.与其将你具体的登录帐户添加给sql server,一个更好的选择是将一些windows user帐户分配为sql server调试帐户(sql server debugging account).然后,要调试一个远程sql server实例的数据库对象的话,你可以使用这些windows登录帐户的认证(credentials)来运行visual studio.
用一个例子来进行阐述。假设有个windows帐户,名为sqldebug.该帐户应该添加到远程sql server实例,以系统管理员角色进行合法登录.然后要从visual studio来调试远程sql server实例的话,我们应该以sqldebug帐户来运行visual studio.于是我们可以这样来操作:退出我们的工作站,以sqldebug帐户再次登录,然后运行visual studio.不过还有一个更简单点的方法,不用退出工作站,通过使用runas.exe来以sqldebug的名义运行visual studio.这个runas.exe允许一个应用程序假借另一个帐户的名义来执行.要以sqldebug的名义来运行visual studio的话,你可以在命令行键入如下的statement:
runas.exe /user:sqldebug "%programfiles%/microsoft visual studio 8/common7/ide/devenv.exe"
关于该过程的更详细介绍请参阅文章《how to: set sql server permissions for debugging》(http://msdn2.microsoft.com/en-us/library/w1bhybwz(vs.80).aspx)
注意:如果你的开发机为windows xp service pack 2版本的话,你需要对internet连接防火墙进行配置以允许远程调试。文章《the how to: enable sql server 2005 debugging》(http://msdn2.microsoft.com/en-us/library/s0fk6z6e(vs.80).aspx)对此进行了描述,该过程包括2步:(a)在visual studio所在的主机,你必须向exceptions list添加devenv.exe,并打开tcp 135端口;(b)在远程(sql)机器,你必须打开tcp 135端口,且向exceptions list添加dsqlservr.exe.如果你的域策略(domain policy)需要通过ipsec来进行网络通信(network communication)的话,你必须打开udp 4500 和 udp 500端口。
结语:
除了支持对.net程序代码进行调试外,visual studio也提供了对sql server 2005进行调试的多种选择.在本文,我们考察了这些选择中的2种:直接数据库调试(direct database debugging)以及应用程序调试.要直接对一个t-sql数据库对象进行调试的话,在服务器资源管理器里找到该对象,再右键单击选“step into …”. 这将打开调试器,且运行到该对象的第一条statement就终止了.此时,你可以进入该对象的statements,查看并修改参数值.在第一步,我们用该方法对products_selectbycategoryid存储过程进行了设置.
应用程序调试允许直接在数据库对象里设置断点.当一个客户端程序(比如一个asp.net web程序)调用一个包含断点的数据库对象时,程序终止且切换到调试器界面。应用程序调试很有用,因为它更清楚的显示了到底是什么程序行为调用了某个具体的数据库对象.然而,该方法比直接数据库调试要多一些配置和步骤.
数据库对象也可以通过sql server projects来进行调试,在下一章我们将考察使用sql server projects,以及如何利用其来创建和调试管理数据库对象(managed database objects)
祝编程快乐!
作者简介
本系列教程作者 scott mitchell,著有六本asp/asp.net方面的书,是4guysfromrolla.com的创始人,自1998年以来一直应用 微软web技术。大家可以点击查看全部教程《[翻译]scott mitchell 的asp.net 2.0数据教程》,希望对大家的学习asp.net有所帮助。