debugger Transact-SQL

si applica a:SQL Server

Il debugger Transact-SQL consente di trovare errori nel codice Transact-SQL esaminando il comportamento in fase di esecuzione del codice. Dopo aver impostato la finestra Editor di query del motore di database sulla modalità di debug, è possibile sospendere l'esecuzione su righe di codice specifiche ed esaminare informazioni e dati utilizzati o restituiti da tali istruzioni Transact-SQL.

Il debug T-SQL è disponibile in SQL Server Data Tools per Visual Studio.

Analizzare il codice Transact-SQL passo passo

Il debugger Transact-SQL offre le opzioni seguenti che è possibile usare per spostarsi tra Transact-SQL codice quando la finestra Editor query del motore di database è in modalità di debug:

• Impostare punti di interruzione per singole istruzioni Transact-SQL.

  Un punto di interruzione specifica un punto in cui si desidera sospendere l'esecuzione in modo da poter esaminare i dati. Quando si avvia il debugger, esso viene sospeso nella prima riga di codice nella finestra dell'editor di query. Per eseguire fino al primo punto di interruzione, usare Continua. È anche possibile usare Continua per eseguire fino al punto di interruzione successivo da qualsiasi posizione in cui la finestra è attualmente sospesa. È possibile modificare i punti di interruzione per specificare azioni quali le condizioni in cui il punto di interruzione deve sospendere l'esecuzione, le informazioni da stampare nella finestra Output e modificare la posizione del punto di interruzione.

• Eseguire l'istruzione successiva.

  Questa opzione consente di esplorare un set di istruzioni una alla volta e di osservare il comportamento man mano che si procede.

• Eseguire o saltare una chiamata a una stored procedure o funzione.

  Se sei certo che non ci siano errori in una stored procedure, puoi ignorarla. La procedura viene eseguita completamente e i risultati vengono restituiti al codice.

  Se si vuole eseguire il debug di una stored procedure o di una funzione, è possibile entrare nel modulo. Verrà visualizzata una nuova finestra dell'Editor di Query del Motore di Database, che è riempita con il codice sorgente del modulo. La finestra è in modalità di debug e l'esecuzione viene sospesa nella prima istruzione del modulo. È quindi possibile spostarsi nel codice del modulo, ad esempio impostando punti di interruzione o eseguendo passo-passo il codice.

Per ulteriori informazioni su come il debugger consente di esplorare il codice, vedere Eseguire passo passo il codice Transact-SQL.

Visualizzare le informazioni del debugger

Ogni volta che il debugger sospende l'esecuzione in un'istruzione Transact-SQL specifica, è possibile usare le finestre del debugger seguenti per visualizzare lo stato di esecuzione corrente:

• Variabili locali e Osservazione. Queste finestre mostrano le espressioni Transact-SQL attualmente allocate. Le espressioni sono clausole Transact-SQL che restituiscono una singola espressione scalare. Il debugger Transact-SQL supporta la visualizzazione di espressioni che fanno riferimento Transact-SQL variabili, parametri o funzioni predefinite con nomi che iniziano con @@. Queste finestre visualizzano anche i valori di dati attualmente assegnati alle espressioni.

• QuickWatch. Questa finestra visualizza il valore di un'espressione Transact-SQL e consente di salvare tale espressione nella finestra Watch.

• Punti di interruzione. Questa finestra visualizza i punti di interruzione attualmente impostati e consente di gestirli.

• Stack delle chiamate In questa finestra viene visualizzato il percorso di esecuzione corrente. Vengono inoltre fornite informazioni su come l'esecuzione sia passata dalla finestra dell'editor di query originale tramite qualsiasi funzione, stored procedure o trigger per raggiungere la posizione di esecuzione corrente.

• Output. In questa finestra vengono visualizzati vari messaggi e dati del programma, ad esempio i messaggi di sistema del debugger.

• Risultati e messaggi. Queste schede nella finestra Editor di query visualizzano i risultati delle istruzioni Transact-SQL eseguite in precedenza.

Problemi noti e limitazioni

Il debugger T-SQL è applicabile solo alle istanze di SQL Server. Il debugger non supporta il debug di codice Transact-SQL in esecuzione nel database SQL di Azure, in Istanza gestita di SQL di Azure o nel database SQL di Fabric.

In determinate condizioni, l'evidenziazione delle righe e i punti di interruzione del debugger T-SQL possono non essere sincronizzati con il punto di esecuzione effettivo durante lo step di uno script SQL. Il problema può emergere in diversi scenari, tra cui un commento all'inizio dello script o righe vuote dopo GO istruzioni.

attività del debugger Transact-SQL

Descrizione attività	Article
Viene descritto come configurare il debugger Transact-SQL per il debug remoto.	Configurare le regole del firewall prima di eseguire il debugger Transact-SQL
Descrive come avviare, arrestare e controllare l'operazione del debugger.	Eseguire il debugger Transact-SQL
Viene descritto come usare il debugger Transact-SQL per eseguire il codice.	Eseguire passo passo il codice Transact-SQL
Descrive come usare il debugger Transact-SQL per eseguire passo dopo passo il codice di una stored procedure.	Eseguire il debug di stored procedure
Viene descritto come usare il debugger per visualizzare Transact-SQL dati, ad esempio parametri e variabili e informazioni di sistema.	informazioni sul debuggerTransact-SQL