Transact-SQL foutopsporingsprogramma

2025-09-15

Van toepassing op:SQL Server

Met het Transact-SQL foutopsporingsprogramma kunt u fouten in Transact-SQL code vinden door het runtimegedrag van de code te onderzoeken. Nadat u het venster Query Editor van Database Engine hebt ingesteld op de foutopsporingsmodus, kunt u de uitvoering onderbreken op specifieke regels code en informatie en gegevens inspecteren die door deze Transact-SQL instructies worden gebruikt of geretourneerd.

T-SQL-foutopsporing is beschikbaar in SQL Server Data Tools voor Visual Studio.

Stapsgewijze Transact-SQL code doorlopen

Het Transact-SQL foutopsporingsprogramma biedt de volgende opties die u kunt gebruiken om door Transact-SQL code te navigeren wanneer het venster Queryeditor voor database-engine zich in de foutopsporingsmodus bevindt:

Stel onderbrekingspunten in voor afzonderlijke Transact-SQL-instructies.

Een onderbrekingspunt geeft een punt aan waarop u de uitvoering wilt onderbreken, zodat u gegevens kunt onderzoeken. Wanneer u het foutopsporingsprogramma start, wordt deze onderbroken op de eerste regel code in het venster Queryeditor. Als u naar het eerste onderbrekingspunt wilt uitvoeren, gebruikt u Doorgaan. U kunt ook Doorgaan gebruiken om naar het volgende onderbrekingspunt te gaan vanaf elke locatie waarop het venster momenteel is onderbroken. U kunt onderbrekingspunten bewerken om acties op te geven, zoals de voorwaarden waaronder het onderbrekingspunt de uitvoering moet onderbreken, informatie die naar het uitvoervenster moet worden afgedrukt en de locatie van het onderbrekingspunt moet wijzigen.
Stap in de volgende instructie.

Met deze optie kunt u één voor één door een reeks instructies navigeren en het gedrag ervan tijdens het bekijken.
Stap in of over een aanroep naar een opgeslagen procedure of functie.

Als u zeker weet dat er geen fouten zijn in een opgeslagen procedure, kunt u deze stap overslaan. De procedure wordt volledig uitgevoerd en de resultaten worden geretourneerd naar de code.

Als u fouten wilt opsporen in een opgeslagen procedure of functie, kunt u de module instappen. Er wordt een nieuw venster Query-editor voor database-engine geopend dat wordt gevuld met de broncode voor de module. Het venster bevindt zich in de foutopsporingsmodus en de uitvoering wordt onderbroken op de eerste instructie in de module. U kunt vervolgens door de modulecode navigeren door bijvoorbeeld onderbrekingspunten in te stellen of de code te doorlopen.

Zie Stapsgewijze instructies voor Transact-SQL code voor meer informatie over hoe u met het foutopsporingsprogramma door code kunt navigeren.

Informatie over foutopsporingsprogramma weergeven

Telkens wanneer het foutopsporingsprogramma de uitvoering onderbreekt op een specifieke Transact-SQL-instructie, kunt u de volgende foutopsporingsprogrammavensters gebruiken om de huidige uitvoeringsstatus weer te geven:

Locals en Watch. Deze vensters geven momenteel toegewezen Transact-SQL expressies weer. Expressies zijn Transact-SQL-componenten die een enkele scalaire expressie evalueren. Het Transact-SQL foutopsporingsprogramma ondersteunt weergave-expressies die verwijzen naar Transact-SQL variabelen, parameters of de ingebouwde functies met namen die beginnen met @@. In deze vensters worden ook de gegevenswaarden weergegeven die momenteel zijn toegewezen aan de expressies.
QuickWatch. In dit venster wordt de waarde van een Transact-SQL-expressie weergegeven en kunt u die expressie opslaan in een Watch-venster.
Onderbrekingspunten. In dit venster worden de momenteel ingestelde onderbrekingspunten weergegeven en kunt u deze beheren.
Roep Stack aan. In dit venster wordt de huidige uitvoeringslocatie weergegeven. En biedt ook informatie over hoe de uitvoering is doorgegeven vanuit het originele Query Editor-venster via functies, opgeslagen procedures of triggers, om de huidige uitvoeringslocatie te bereiken.
Uitvoer. In dit venster worden verschillende berichten en programmagegevens weergegeven, zoals systeemberichten van het foutopsporingsprogramma.
Resultaten en berichten. Deze tabbladen in het venster Queryeditor geven de resultaten weer van eerder uitgevoerde Transact-SQL-instructies.

Bekende problemen en beperkingen

Het T-SQL-foutopsporingsprogramma is alleen van toepassing op SQL Server-exemplaren. Het foutopsporingsprogramma biedt geen ondersteuning voor foutopsporing Transact-SQL code die wordt uitgevoerd in Azure SQL Database, Azure SQL Managed Instance of SQL Database in Fabric.

Onder bepaalde omstandigheden kunnen de lijnmarkering van de T-SQL-debugger en de breekpunten niet synchroon lopen met het daadwerkelijke uitvoeringspunt wanneer u een SQL-script stap voor stap doorneemt. Het probleem kan zich in verschillende scenario's voordoen, zoals een opmerking bovenaan het script of lege regels na de GO-instructies.