Débogage d'objets de base de données CLR

Autorisations et restrictions de débogage

Le débogage est une opération nécessitant des privilèges élevés et, par conséquent, seuls les membres du rôle serveur fixe sysadmin sont autorisés à l'effectuer dans SQL Server.

Les restrictions suivantes s'appliquent dans le cadre du débogage :

• Le débogage des routines CLR est restreint à une instance de débogueur à la fois. Cette limitation s'applique parce que l'exécution de la totalité du code CLR est gelée lorsqu'un point d'arrêt est atteint et qu'elle ne reprend que lorsque le débogueur continue à partir du point d'arrêt. Toutefois, vous pouvez continuer à déboguer Transact-SQL dans d'autres connexions. Bien que le débogage Transact-SQL ne gèle pas d'autres exécutions sur le serveur, il peut provoquer la mise en attente d'autres connexions par le maintien d'un verrou.

• Les connexions existantes ne peuvent pas être déboguées ; seules les nouvelles connexions peuvent l'être, puisque SQL Server requiert des informations sur l'environnement du client et du débogueur pour que la connexion puisse être établie.

En raison des restrictions précitées, nous recommandons que le débogage du code Transact-SQL et CLR soit effectué sur un serveur de test et non sur un serveur de production.

Vue d'ensemble du débogage des objets de base de données managés

Le débogage dans SQL Server suit un modèle « par connexion ». Un débogueur peut détecter et déboguer des activités uniquement sur la connexion cliente à laquelle il est attaché. Comme les fonctionnalités du débogueur ne sont pas limitées par le type de connexion, il est possible de déboguer à la fois des TDS (Tabular Data Stream) et des connexions HTTP. Toutefois, SQL Server n'autorise pas le débogage des connexions existantes. Le débogage prend en charge toutes les fonctionnalités de débogage communes dans les routines qui s'exécutent sur le serveur. L'interaction entre un débogueur et SQL Server s'effectue par le biais d'un modèle COM (Component Object Model) distribué.

Pour plus d'informations et pour des scénarios de débogage des procédures stockées managées, fonctions, déclencheurs, types définis par l'utilisateur et agrégats, consultez la rubrique « Débogage d'une base de données SQL CLR » dans la documentation de Visual Studio.

Le protocole réseau TCP/IP doit être activé sur l'instance de SQL Server afin d'utiliser Visual Studio pour le développement et le débogage distants. Pour plus d'informations sur l'activation du protocole TCP/IP sur le serveur, consultez Configuration des protocoles réseau client.

Pour déboguer un objet de base de données managé

Exemple

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);
      }
   }
}

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

EXEC GetVersion

Voir aussi

Autres ressources