debuger Transact-SQL

Dotyczy:SQL Server

Debuger Transact-SQL pomaga znaleźć błędy w kodzie Transact-SQL, badając zachowanie kodu w czasie wykonywania. Po ustawieniu okna Edytora zapytań aparatu bazy danych w tryb debugowania, można wstrzymać wykonywanie na poziomie określonych wierszy kodu i sprawdzić informacje oraz dane, które są używane przez te instrukcje Transact-SQL lub zwracane przez te instrukcje Transact-SQL.

Debugowanie języka T-SQL jest dostępne w narzędziach SQL Server Data Tools for Visual Studio.

Przejść przez kod Transact-SQL

Debuger Transact-SQL udostępnia następujące opcje, których można użyć do nawigowania po kodzie Transact-SQL, gdy okno Edytora zapytań aparatu bazy danych znajduje się w trybie debugowania:

• Ustaw punkty przerwania dla poszczególnych instrukcji Transact-SQL.

  Punkt przerwania określa punkt, w którym ma zostać wstrzymane wykonanie, aby można było zbadać dane. Po uruchomieniu debugera zatrzyma się na pierwszej linii kodu w oknie Edytora zapytań. Aby przejść do pierwszego punktu przerwania, użyj Kontynuuj. Możesz również użyć opcji Kontynuuj , aby uruchomić do następnego punktu przerwania z dowolnej lokalizacji, w której okno jest obecnie wstrzymane. Można edytować punkty przerwania, aby określić akcje, takie jak warunki, w których punkt przerwania powinien wstrzymać wykonywanie, informacje do drukowania w oknie Dane wyjściowe i zmienić lokalizację punktu przerwania.

• Przejdź do następnej instrukcji.

  Ta opcja umożliwia nawigowanie przez zestaw instrukcji pojedynczo i obserwowanie ich zachowania w trakcie.

• Przejdź do metody lub przez wywołanie procedury składowanej lub funkcji.

  Jeśli masz pewność, że nie ma żadnych błędów w procedurze składowanej, możesz ją pominąć. Procedura jest wykonywana w całości, a wyniki są zwracane do kodu.

  Jeśli chcesz debugować procedurę składowaną lub funkcję, możesz przejść do modułu. Otworzy się nowe okno Edytora zapytań silnika bazy danych, które zostanie wypełnione kodem źródłowym modułu. Okno jest w trybie debugowania, a wykonywanie wstrzymuje się na pierwszej instrukcji w module. Następnie możesz nawigować po kodzie modułu, na przykład ustawiając punkty przerwania lub przechodząc przez kod.

Aby uzyskać więcej informacji na temat sposobu, w jaki debuger umożliwia nawigowanie po kodzie, zobacz Przechodzenie po kodzie Transact-SQL.

Wyświetlanie informacji o debugerze

Za każdym razem, gdy debuger wstrzymuje wykonywanie określonej instrukcji Transact-SQL, możesz użyć następujących okien debugera, aby wyświetlić bieżący stan wykonywania:

• Lokalne i Obserwacja. Te okna wyświetlają obecnie przydzielone wyrażenia Transact-SQL. Wyrażenia to Transact-SQL klauzule, które są obliczane dla pojedynczego wyrażenia skalarnego. Debugger Transact-SQL obsługuje wyświetlanie wyrażeń odwołujących się do zmiennych Transact-SQL, parametrów lub wbudowanych funkcji które mają nazwy rozpoczynające się od @@. Te okna wyświetlają również wartości danych, które są obecnie przypisane do wyrażeń.

• QuickWatch. W tym oknie jest wyświetlana wartość wyrażenia Transact-SQL i umożliwia zapisanie tego wyrażenia w oknie Obserwowanie .

• Punkty przerwania. To okno wyświetla aktualnie ustawione punkty przerwania i umożliwia zarządzanie nimi.

• Stos wywołań. W tym oknie zostanie wyświetlona bieżąca lokalizacja wykonywania. Ponadto zawiera informacje o tym, jak wykonywanie było przekazywane z oryginalnego okna Edytora zapytań, poprzez dowolne funkcje, procedury składowane lub wyzwalacze do osiągnięcia bieżącej lokalizacji wykonywania.

• Dane wyjściowe. W tym oknie są wyświetlane różne komunikaty i dane programu, takie jak komunikaty systemowe z debugera.

• Wyniki i komunikaty. Te karty w oknie Edytor zapytań wyświetlają wyniki poprzednio wykonanych instrukcji Transact-SQL.

Znane problemy i ograniczenia

Debuger języka T-SQL ma zastosowanie tylko do wystąpień programu SQL Server. Debuger nie obsługuje debugowania kodu Transact-SQL uruchomionego w usłudze Azure SQL Database, azure SQL Managed Instance lub bazie danych SQL w usłudze Fabric.

W pewnych warunkach wyróżnianie i punkty przerwania debugera języka T-SQL mogą nie być zsynchronizowane z rzeczywistym punktem wykonywania podczas przechodzenia przez skrypt SQL. Problem może wystąpić w kilku scenariuszach, takich jak komentarz u góry skryptu lub puste linie po GO zapisach.

zadania debugera Transact-SQL

Opis zadania	Article
Opisuje sposób konfigurowania debugera Transact-SQL na potrzeby zdalnego debugowania.	Konfigurowanie reguł zapory przed uruchomieniem debugera Transact-SQL
Opisuje sposób uruchamiania, zatrzymywania i kontrolowania działania debugera.	Uruchamianie debugera Transact-SQL
Opisuje sposób użycia debugera Transact-SQL do przechodzenia przez kod.	Przechodzenie przez kod Transact-SQL
Opisuje sposób używania debugera Transact-SQL do przechodzenia przez kod procedury składowanej.	Debugowanie procedur składowanych
Opisuje sposób używania debugera do wyświetlania Transact-SQL danych, takich jak parametry i zmienne oraz informacje o systemie.	informacje o debugerzeTransact-SQL