Debugging a SQL Server Stored Procedure

Solution Use Visual Studio .NET to debug SQL Server stored procedures in both standalone mode and from managed code.. Discussion Debugging a stored procedure in standalone mode You ca

[ Team LiB ]

Recipe 9.8 Debugging a SQL Server Stored Procedure

Problem

Given an application that uses a SQL Server stored procedure that is causing errors, you need to debug the stored procedure

Solution

Use Visual Studio NET to debug SQL Server stored procedures (in both standalone mode and from managed code)

Discussion

Debugging a stored procedure in standalone mode

You can debug a stored procedure in standalone mode from Visual Studio NET Server Explorer by following these steps:

1 Open the Server Explorer window in Visual Studio NET by selecting it from the View menu

2 Create a connection to the database or select an existing connection

3 Select and expand the node for the database that contains the stored procedure

4 Expand the Stored Procedures node

5 Right-click on the stored procedure to be debugged and select Step Into Stored Procedure from the popup menu

6 If requested, supply the parameter values on the Run Stored Procedure dialog

Alternatively, if the stored procedure is already open in a source window in Visual Studio .NET:

1 Right-click on the stored procedure to be debugged and select Step Into Stored Procedure from the popup menu

2 If requested, supply the parameter values on the Run Stored Procedure dialog

Debugging a stored procedure from managed code

To debug a stored procedure from managed code, SQL debugging must be enabled for the project Follow these steps:

1 Open the solution

2 In the Solution Explorer window, select the project and right-click Select

Properties from the popup menu

3 In the Property Pages dialog, select Debug from the Configuration drop-down list

box

4 Select the Configuration Properties folder in the left pane and choose Debugging

5 In the Debuggers section of the right pane, set Enable SQL Debugging to true

6 Click OK to close the dialog

Table 9-2 lists the components that must be installed for SQL Server debugging

Table 9-2 SQL Server debugging components

SQLLE.DLL Client

SQLDBG.DLL Client and server

MSSDBI98.DLL Server in the \binn directory of the SQL Server instance

SQLDBREG2.EXE Client

There are some other significant limitations to SQL Server Debugging:

• It is not possible to debug SQL statements that are outside of a stored procedure

• It is not possible to step into a stored procedure from managed or unmanaged

code, or into managed or unmanaged code from a stored procedure Set a

breakpoint at entry point in the stored procedure or in the reentry point in the code

as required Alternatively, open the code or stored procedure and right-click on the line to break on Select Run to Cursor from the shortcut menu to reach the desired line without setting a breakpoint

• The database connection from your application must be established with the NET

data provider for SQL Server before debugging a mixed-language application

After that, you can open stored procedures and set breakpoints in the same way as for other applications

• When connection pooling is enabled, debugging a stored procedure called from

native or managed code might not work after the first time When a connection is

obtained from the pool rather than created, SQL debugging is not reestablished

• Changes to locals or parameter variables that are cached by the SQL interpreter

are not automatically modified and there is no way to force the cache to refresh

SQL Server caches variables when the execution plan determines that they will not

be dynamically loaded for each statement execution or reference

For more information about debugging SQL stored procedures, see the topic "Debugging SQL" in the MSDN Library

[ Team LiB ]