Gewusst wie: Debuggen mit einem SQL Server-Datenbankprojekt oder -Serverprojekt

Dieses Thema gilt für folgende Editionen:

Visual Studio Ultimate	Visual Studio Premium	Visual Studio Professional	Visual Studio Express

Im folgenden Verfahren wird beschrieben, wie Transact-SQL mithilfe des Visual Studio SQL Server-Datenbankprojekttyps oder -Serverprojekttyps gedebuggt wird.Informationen zum Debuggen von Transact-SQL in C++-, Visual Basic- oder C#-Projekten finden Sie unter Debuggen von Datenbankanwendungen mit mehreren Ebenen.

Wenn Sie das Debugging im Kontext eines SQL Server-Datenbankprojekts oder -Serverprojekts initiieren, beginnt der Debugger immer, den Transact-SQL-Code im aktiven Transact-SQL-Abfragefenster zu debuggen.Falls Sie nicht das gesamt Skript debuggen möchten, markieren Sie im Abfragefenster nur einen Teil des Transact-SQL-Codes, bevor Sie mit dem Debuggen beginnen.

Zum Debuggen von Datenbankobjekten wie gespeicherten Prozeduren und Triggern müssen Sie vom Transact-SQL-Code im aktiven Transact-SQL-Abfragefenster aus einen Einzelschritt in diese Objekte ausführen.Angenommen, Sie möchten eine gespeicherte Prozedur debuggen: Legen Sie einen Haltepunkt in einer EXECUTE-Anweisung fest, die diese gespeicherte Prozedur aufruft, beginnen Sie in demselben Transact-SQL-Abfragefenster mit dem Debuggen, und führen Sie dann einen Einzelschritt in die gespeicherte Prozedur aus, indem Sie auf der Symbolleiste Debuggen auf Einzelschritt klicken.

So debuggen Sie ein Transact-SQL-Skript im aktiven Transact-SQL-Abfragefenster

1. Vergewissern Sie sich, dass der Computer für das Transact-SQL-Debugging eingerichtet wurde.Weitere Informationen finden Sie unter Gewusst wie: Aktivieren des Transact-SQL-Debuggings.

2. Starten Sie Visual Studio, und erstellen Sie ein neues SQL Server-Datenbankprojekt oder -Serverprojekt.

3. Öffnen Sie ein Transact-SQL-Skript, das Sie verwenden möchten, um mit dem Debuggen zu beginnen.Sie können auch eine neue.sql-Datei öffnen (eine dem aktuellen Projekt zugeordnete oder davon unabhängige Datei).

   1. So fügen Sie dem Projekt ein neues Transact-SQL-Skript hinzu: Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, klicken Sie auf Hinzufügen und dann auf Neues Element.Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Skript aus (in der Vorlage Benutzerskripts unter dem Knoten Datenbankprojekt).Klicken Sie dann auf Hinzufügen.

   2. Informationen zum Öffnen eines neuen Transact-SQL-Abfragefensters, das dem Projekt nicht zugeordnet ist, finden Sie unter Gewusst wie: Starten des Transact-SQL-Editors und Gewusst wie: Herstellen einer Datenbankverbindung im Transact-SQL-Editor.Hinweis: Sie können Transact-SQL nicht debuggen, ohne zuerst ein SQL Server-Datenbankprojekt oder -Serverprojekt zu öffnen.

4. Beginnen Sie nach dem Öffnen des Transact-SQL-Abfragefensters mit dem Schreiben des Transact-SQL-Codes (sofern nicht bereits geschehen).Fahren Sie mit dem nächsten Schritt fort, wenn Sie bereit sind, mit dem Debuggen zu beginnen.

5. Fügen Sie Haltepunkte im Transact-SQL-Code ein, indem Sie in den Codezeilen, in denen Sie die Ausführung unterbrechen möchten, in den linken Rand des Transact-SQL-Abfragefensters klicken.

6. Drücken Sie F5, oder klicken Sie im Menü Debuggen auf Debuggen starten, um mit dem Debuggen des aktiven Transact-SQL-Abfragefensters zu beginnen.

7. Navigieren Sie mithilfe der Schaltflächen Einzelschritt, Prozedurschritt oder Ausführen bis Rücksprung auf der Symbolleiste Debuggen mit dem Debugger durch das Transact-SQL-Skript.Sie können auch F5 drücken, um die Ausführung bis zum nächsten Haltepunkt oder bis zum Ende des Skripts fortzusetzen.

8. Verwenden Sie die Fenster Lokal und Überwachen, um den Zustand des Codes zu untersuchen.Weitere Informationen finden Sie unter Transact-SQL-Objektdebugging mit den Fenstern "Lokal" und "Überwachen".

9. Wenn Sie fertig sind und das Debuggen beenden möchten, drücken Sie STRG+ALT+UNTBR, oder klicken Sie auf der Symbolleiste Debuggen auf Debugging beenden.

So debuggen Sie auf dem Server bereitgestellte Transact-SQL-Datenbankobjekte

1. Vergewissern Sie sich, dass der Computer für das Transact-SQL-Debugging eingerichtet wurde.Weitere Informationen finden Sie unter Gewusst wie: Aktivieren des Transact-SQL-Debuggings.

2. Starten Sie Visual Studio, und erstellen Sie ein neues SQL Server-Datenbankprojekt oder -Serverprojekt.

3. Öffnen Sie ein Transact-SQL-Skript, das Sie zum Testen der Transact-SQL-Datenbankobjekte verwenden möchten.Sie können auch eine neue.sql-Datei öffnen (eine dem aktuellen Projekt zugeordnete oder davon unabhängige Datei).

   1. So fügen Sie dem Projekt ein neues Transact-SQL-Skript hinzu: Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, klicken Sie auf Hinzufügen und dann auf Neues Element.Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Skript aus (in der Vorlage Benutzerskripts unter dem Knoten Datenbankprojekt).Klicken Sie dann auf Hinzufügen.

   2. Informationen zum Öffnen eines neuen Transact-SQL-Abfragefensters, das dem Projekt nicht zugeordnet ist, finden Sie unter Gewusst wie: Starten des Transact-SQL-Editors und Gewusst wie: Herstellen einer Datenbankverbindung im Transact-SQL-Editor.Hinweis: Sie können Transact-SQL nicht debuggen, ohne zuerst ein SQL Server-Datenbankprojekt oder -Serverprojekt zu öffnen.

4. Beginnen Sie nach dem Öffnen des Transact-SQL-Abfragefensters mit dem Schreiben des Transact-SQL-Testcodes (sofern nicht bereits geschehen).Transact-SQL-Datenbankobjekte können nur gedebuggt werden, indem Sie im aktiven Transact-SQL-Abfragefenster einen Einzelschritt in diese Objekte ausführen.Schreiben Sie im Testskript Transact-SQL-Code, durch den dieses Transact-SQL-Objekt ausgeführt wird.

   1. Fügen Sie dem Testskript zum Debuggen einer gespeicherten Prozedur eine EXECUTE-Anweisung für die entsprechende gespeicherte Prozedur hinzu.

   2. Schreiben Sie zum Debuggen von Triggern, benutzerdefinierten Funktionen und anderen programmierbaren Transact-SQL-Datenbankobjekten im Testskript Transact-SQL-Code, durch den dieser Code ausgeführt wird.

5. Fügen Sie Haltepunkte im Transact-SQL-Testskript ein, indem Sie in den Codezeilen, in denen Sie die Ausführung unterbrechen möchten, in den linken Rand des Transact-SQL-Abfragefensters klicken.Fügen Sie zum Debuggen von in der SQL Server-Instanz bereitgestellten Transact-SQL-Datenbankobjekten die Haltepunkte direkt vor dem Transact-SQL-Code ein, durch den diese Objekte ausgeführt werden.

6. Klicken Sie vor dem Starten des Debuggers auf das Transact-SQL-Testskript, um sicherzustellen, dass es sich um das aktive Fenster in Visual Studio handelt.

7. Drücken Sie F5, oder klicken Sie im Menü Debuggen auf Debuggen starten, um mit dem Debuggen des Transact-SQL-Testskripts zu beginnen.

8. Nachdem der Debugger die Ausführung am Haltepunkt unterbrochen hat, drücken Sie F8, oder klicken Sie im Menü Debuggen auf Einzelschritt, um mit dem Debugger einen Einzelschritt in den Transact-SQL-Code des Transact-SQL-Datenbankobjekts auszuführen.Sobald der Debugger den Einzelschritt in den Transact-SQL-Code des Datenbankobjekts ausführt, wird in Visual Studio ein neues Transact-SQL-Abfragefenster mit dem entsprechenden Transact-SQL-Code geöffnet.

9. Nachdem der Debugger den Einzelschritt in das Transact-SQL-Datenbankobjekt ausgeführt hat, können Sie zusätzliche Haltepunkte festlegen und mithilfe der Schaltflächen Einzelschritt, Prozedurschritt oder Ausführen bis Rücksprung auf der Symbolleiste Debuggen mit dem Debugger durch den Transact-SQL-Code navigieren.Sie können auch F5 drücken, um die Ausführung bis zum nächsten Haltepunkt oder bis zum Ende des Codes fortzusetzen.

10. Verwenden Sie die Fenster Lokal und Überwachen, um den Zustand des Codes zu untersuchen.Weitere Informationen finden Sie unter Transact-SQL-Objektdebugging mit den Fenstern "Lokal" und "Überwachen".

11. Wenn Sie fertig sind und das Debuggen beenden möchten, drücken Sie STRG+ALT+UNTBR, oder klicken Sie auf der Symbolleiste Debuggen auf Debugging beenden.

Siehe auch

Andere Ressourcen

Creating SQL Server 2005 Objects In Managed Code

Overview of Visual Database Tools

Debuggen von Transact-SQL-Datenbankobjekten