Depurar objetos de bases de datos CLR

  • Artículo

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 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 de 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 programar o depurar la integración 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 fijo de servidor 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 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 cliente.

Para depurar un objeto de base de datos administrado

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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

Otros recursos

Conceptos de programación en el ámbito de la integración de Common Language Runtime (CLR)