• Artikel

Schrittweises Durchlaufen von Transact-SQL-Code

Der Transact-SQL-Debugger ermöglicht es Ihnen, zu bestimmen, welche Transact-SQL-Anweisungen in einem Database Engine (Datenbankmodul)-Abfrage-Editor-Fenster ausgeführt werden. Sie können den Debugger bei einzelnen Anweisungen unterbrechen und dann den Status der Codeelemente an diesem Punkt anzeigen.

Haltepunkte

Ein Haltepunkt signalisiert dem Debugger, die Ausführung bei einer bestimmten Transact-SQL-Anweisung anzuhalten. Das Festlegen eines Haltepunkts bei einer Anweisung wird als Ein-/Ausschalten eines Haltepunkts bezeichnet. Sie können einen Haltepunkt bei einer Transact-SQL-Anweisung ein- oder ausschalten, indem Sie die Anweisung markieren und eine der folgenden Aktionen durchführen:

  • Drücken Sie F9.

  • Klicken Sie im Menü Debuggen auf Haltepunkt ein/aus.

  • Klicken Sie im Abfrage-Editor-Fenster auf die graue Leiste links neben der gewünschten Transact-SQL-Anweisung.

Zum Anzeigen und Verwalten aller offenen Haltepunkte können Sie das Fenster Haltepunkte verwenden. Das Fenster Haltepunkte enthält Informationen, z. B. auf welcher Codezeile sich der Haltepunkt befindet. Außerdem können Sie im Fenster Haltepunkte Haltepunkte löschen, deaktivieren und aktivieren. Weitere Informationen zum Fenster Haltepunkte finden Sie unter Fenster 'Haltepunkte'.

Zum Öffnen des Fensters Haltepunkte haben Sie folgende Möglichkeiten:

  • Klicken Sie im Menü Debuggen auf Fenster und dann auf Haltepunkte.

  • Klicken Sie auf der Symbolleiste Debuggen auf die Schaltfläche Haltepunkte.

  • Drücken Sie STRG+ALT+B.

Sie können einen Haltepunkt vorübergehend deaktivieren. Auf diese Weise wird verhindert, dass der Haltepunkt die Ausführung anhält, wobei die Definition jedoch beibehalten wird, falls Sie den Haltepunkt später reaktivieren möchten.

Die folgende Tabelle enthält die verschiedenen Möglichkeiten, mit denen Sie Haltepunkte deaktivieren, erneut aktivieren und löschen können.

Aktion

Vorgehensweise

Deaktivieren eines einzelnen Haltepunkts

  • Klicken Sie im Abfrage-Editor-Fenster mit der rechten Maustaste auf den Haltepunkt, und klicken Sie dann auf Haltepunkt deaktivieren.

  • Deaktivieren Sie im Fenster Haltepunkte das Kontrollkästchen links neben dem Haltepunkt.

Deaktivieren aller Haltepunkte

  • Klicken Sie im Menü Debuggen auf Alle Haltepunkte deaktivieren.

  • Klicken Sie auf der Symbolleiste des Fensters Haltepunkte auf die Schaltfläche Alle Haltepunkte deaktivieren.

Erneutes Aktivieren eines einzelnen Haltepunkts

  • Klicken Sie im Abfrage-Editor-Fenster mit der rechten Maustaste auf den Haltepunkt, und klicken Sie dann auf Haltepunkt aktivieren.

  • Aktivieren Sie im Fenster Haltepunkte das Kontrollkästchen links neben dem Haltepunkt.

Erneutes Aktivieren aller deaktivierten Haltepunkte

  • Klicken Sie im Menü Debuggen auf Alle Haltepunkte aktivieren.

  • Klicken Sie auf der Symbolleiste des Fensters Haltepunkte auf die Schaltfläche Alle Haltepunkte aktivieren.

Löschen eines einzelnen Haltepunkts

  • Klicken Sie im Abfrage-Editor-Fenster mit der rechten Maustaste auf den Haltepunkt, und klicken Sie dann auf Haltepunkt löschen.

  • Klicken Sie im Fenster Haltepunkte mit der rechten Maustaste auf den Haltepunkt, und klicken Sie dann im Kontextmenü auf Löschen.

  • Wählen Sie im Fenster Haltepunkte den Haltepunkt aus, und drücken Sie dann ENTF.

Löschen aller Haltepunkte

  • Klicken Sie im Menü Debuggen auf Alle Haltepunkte löschen.

  • Klicken Sie auf der Symbolleiste des Fensters Haltepunkte auf die Schaltfläche Alle Haltepunkte löschen.
HinweisHinweis

Der Transact-SQL-Debugger unterstützt keine Microsoft Visual Studio-Features für das Festlegen von Haltepunktbedingungen oder Trefferanzahlen.

Steuern der Anweisungsausführung

Im Transact-SQL-Debugger können Sie die folgenden Optionen für das Ausführen der aktuellen Anweisung im Transact-SQL-Code angeben:

  • Den Vorgang bis zum nächsten Haltepunkt ausführen

  • Einen Einzelschritt in die nächste Anweisung ausführen

    Wenn die nächste Anweisung eine gespeicherte Transact-SQL-Prozedur, eine Funktion oder einen Trigger aufruft, zeigt der Debugger ein neues Abfrage-Editor-Fenster an, das den Code des Moduls enthält. Das Fenster befindet sich im Debuggingmodus, und die Ausführung hält bei der ersten Anweisung im Modul an. Sie können sich dann durch den Modulcode bewegen, indem Sie z. B. Haltepunkte festlegen oder den Code schrittweise durchlaufen.

  • Einen Einzelschritt in die nächste Anweisung überspringen

    Die nächste Anweisung wird ausgeführt. Wenn die Anweisung jedoch eine gespeicherte Prozedur, eine Funktion oder einen Trigger aufruft, wird der Modulcode bis zum Ende ausgeführt, und die Ergebnisse werden an den aufrufenden Code zurückgegeben. Wenn Sie sicher sind, dass in der gespeicherten Prozedur keine Fehler vorliegen, können Sie sie überspringen. Die Ausführung hält bei der Anweisung an, die dem Aufruf der gespeicherten Prozedur, der Funktion oder dem Trigger folgt.

  • Eine gespeicherte Prozedur, eine Funktion oder einen Trigger bis zum Rücksprung ausführen

    Die Ausführung hält bei der Anweisung an, die dem Aufruf der gespeicherten Prozedur, der Funktion oder dem Trigger folgt.

  • Den Vorgang von der aktuellen Position bis zur aktuellen Position des Zeigers ausführen und alle Haltepunkte ignorieren

Die folgende Tabelle enthält die verschiedenen Möglichkeiten, mit denen Sie bestimmen können, wie Anweisungen im Transact-SQL-Debugger ausgeführt werden.

Aktion

Vorgehensweise

Ausführen aller Anweisungen von der aktuellen Anweisung bis zum nächsten Haltepunkt

  • Klicken Sie im Menü Debuggen auf Weiter.

  • Klicken Sie auf der Symbolleiste Debuggen auf die Schaltfläche Weiter.

Ausführen eines Einzelschritts in die nächste Anweisung oder in das nächste Modul

  • Klicken Sie im Menü Debuggen auf Einzelschritt.

  • Klicken Sie auf der Symbolleiste Debuggen auf die Schaltfläche Einzelschritt.

  • Drücken Sie F11.

Überspringen der nächsten Anweisung oder des nächsten Moduls

  • Klicken Sie im Menü Debuggen auf Prozedurschritt.

  • Klicken Sie auf der Symbolleiste Debuggen auf die Schaltfläche Prozedurschritt.

  • Drücken Sie F10.

Ausführen eines Moduls bis Rücksprung

  • Klicken Sie im Menü Debuggen auf Rücksprung.

  • Klicken Sie auf der Symbolleiste Debuggen auf die Schaltfläche Rücksprung.

  • Drücken Sie UMSCHALT+F11.

Ausführen bis zur aktuellen Cursorposition

  • Klicken Sie mit der rechten Maustaste auf das Abfrage-Editor-Fenster, und klicken Sie dann auf Ausführen bis Cursorposition.

  • Drücken Sie STRG+F10.