Depurar objetos de bases de datos CLR
SQL Server proporciona compatibilidad con la depuración de objetos de Transact-SQL y Common Language Runtime (CLR) en la base de datos. Los aspectos clave de la depuración en SQL Server son la facilidad de configuración y uso, y la integración del depurador de SQL Server con el depurador de Microsoft Visual Studio. Además, la depuración se produce en todos los lenguajes. Los usuarios pueden pasar sin problemas a objetos de CLR desde Transact-SQL y viceversa. El depurador de Transact-SQL de SQL Server en SQL Server Management Studio no se puede utilizar para depurar objetos de base de datos administrados, pero se pueden depurar los objetos utilizando los depuradores en Visual Studio. La depuración de objetos de base de datos administrados en Visual Studio admite todas las funciones habituales de depuración, como las instrucciones "ir a" y "paso a paso por procedimientos" dentro de rutinas que se ejecutan en el servidor. Los depuradores pueden establecer puntos de interrupción, inspeccionar la pila de llamadas, inspeccionar variables y modificar valores de variables durante la depuración. Tenga en cuenta que Visual Studio .NET 2003 no puede utilizarse para la programación o depuración de integración de CLR. SQL Server incluye .NET Framework preinstalado y Visual Studio .NET 2003 no puede utilizar los ensamblados de .NET Framework 2.0.
Para obtener más información sobre cómo depurar código administrado con Visual Studio, vea el tema "Depurar código administrado" en la documentación de Visual Studio.
Permisos y restricciones de depuración
La depuración es una operación con muchos privilegios y, por consiguiente, solo los miembros del rol de servidor fijo sysadmin tienen permiso para realizarla en SQL Server.
Las restricciones siguientes se aplican durante la depuración:
La depuración de rutinas CLR está restringida a una instancia del depurador cada vez. Esta limitación se aplica porque toda la ejecución de código de CLR se inmoviliza cuando se alcanza un punto de interrupción y la ejecución no continúa hasta que el depurador pasa el punto de interrupción. Sin embargo, se puede seguir depurando Transact-SQL en otras conexiones. Aunque la depuración de Transact-SQL no inmoviliza otras ejecuciones en el servidor, puede hacer que otras conexiones tengan que esperar por el mantenimiento de un bloqueo.
Las conexiones existentes no se pueden depurar; solo se pueden depurar las conexiones nuevas, ya que SQL Server requiere información sobre el cliente y el entorno del depurador antes de que se pueda realizar la conexión.
Debido a las restricciones anteriores, se recomienda que el código Transact-SQL y CLR se depure en un servidor de prueba y no en un servidor de producción.
Información general de la depuración de objetos de base de datos administrados
La depuración en SQL Server sigue un modelo por conexión. Un depurador solo puede detectar y depurar actividades en la conexión de cliente a la que está adjuntado. Dado que la funcionalidad del depurador no está limitada por el tipo de conexión, se pueden depurar flujos de datos tabulares (TDS) y conexiones HTTP. Sin embargo, SQL Server no permite la depuración de conexiones existentes. La depuración admite todas las características habituales de depuración dentro de rutinas que se ejecutan en el servidor. La interacción entre un depurador y SQL Server se produce mediante un modelo de objetos componentes (COM) distribuido.
Para obtener más información y situaciones sobre cómo depurar procedimientos almacenados, funciones, desencadenadores, tipos definidos por el usuario y agregados administrados, vea el tema "Depuración de bases de datos de integración de CLR con SQL Server" en la documentación de Visual Studio.
El protocolo de red TCP/IP debe estar habilitado en la instancia de SQL Server a fin de utilizar Visual Studio para el desarrollo remoto, la depuración y el desarrollo. Para obtener más información sobre la forma de habilitar el protocolo TCP/IP en el servidor, vea Configurar protocolos de red de cliente.
Para depurar un objeto de base de datos administrado
Abra Microsoft Visual Studio, cree un nuevo proyecto de SQL Server y establezca una conexión a una base de datos en una instancia de SQL Server.
Cree un nuevo tipo. En Explorador de soluciones, haga clic con el botón secundario en el proyecto y seleccione Agregar y Nuevo elemento. En la ventana Agregar nuevo elemento, seleccione Procedimiento almacenado, Función definida por el usuario, Tipo definido por el usuario, Desencadenador, Agregado o Clase. Especifique un nombre para el archivo de código fuente del nuevo tipo y haga clic en Agregar.
Agregue código para el nuevo tipo al editor de texto. En la sección que figura más adelante en este tema, puede ver el código de ejemplo de un procedimiento almacenado de ejemplo.
Agregue un script que pruebe el tipo. En Explorador de soluciones, expanda el directorio TestScripts y haga doble clic en Test.sql para abrir el archivo de código fuente del script de prueba predeterminado. Agregue al editor de texto el script de prueba, uno que llame al código que se va a depurar. Vea más adelante un script de ejemplo.
Coloque uno o más puntos de interrupción en el código fuente. Haga clic con el botón secundario en una línea de código en el editor de texto, dentro de la función o rutina que desea depurar, y seleccione Punto de interrupción e Insertar punto de interrupción. Se agrega el punto de interrupción, resaltando la línea de código en rojo.
En el menú Depurar, seleccione Iniciar depuración para compilar, implementar y probar el proyecto. Se ejecutará el script de prueba de Test.sql y se llamará al objeto de base de datos administrado.
Cuando la flecha amarilla que designa el puntero de instrucción aparece en el punto de interrupción, la ejecución del código se detiene y se puede empezar a depurar el objeto de base de datos administrado. Puede seleccionar Paso a paso por procedimientos en el menú Depurar para hacer avanzar el puntero de instrucción hasta la siguiente línea de código. La ventana Variables locales se utiliza para observar el estado de los objetos actualmente resaltado por el puntero de instrucción. Se pueden agregar variables a la ventana Inspección. El estado de las variables inspeccionadas se puede observar en toda la sesión de depuración, no solo cuando la variable está en la línea de código resaltada actualmente por el puntero de instrucción. Seleccione Continuar en el menú Depurar para hacer avanzar el puntero de instrucción hasta el siguiente punto de interrupción o para completar la ejecución de la rutina si no hay más puntos de interrupción.
Ejemplo
En el ejemplo siguiente se devuelve la versión de SQL Server al autor de la llamada.
C#
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
A continuación se muestra un script de prueba que llama al procedimiento almacenado GetVersion definido anteriormente.
EXEC GetVersion
Vea también