Impostazione di un'azione del punto di interruzione
Un'azione Quando raggiunto per un punto di interruzione specifica un'attività personalizzata eseguita dal debugger Transact-SQL per un punto di interruzione. Se viene raggiunto il numero di passaggi specificato e viene soddisfatta qualsiasi condizione per il punto di interruzione, il debugger esegue l'azione specificata per il punto di interruzione.
Considerazioni sulle azioni
L'azione predefinita per un punto di interruzione consiste nell'interrompere l'esecuzione una volta raggiunto il numero di passaggi e soddisfatta la condizione per il punto di interruzione. L'utilizzo principale di un'azione Quando raggiunto nel debugger Transact-SQL consiste nello stampare informazioni nella finestra Output del debugger specificando un messaggio di stampa.
È possibile specificare un messaggio di stampa nell'opzione Stampa un messaggio. Il messaggio di stampa viene specificato come stringa di testo che include espressioni contenenti informazioni ottenute dal debug di Transact-SQL. Le espressioni includono gli elementi seguenti:
Un'espressione Transact-SQL racchiusa tra parentesi graffe ({}). Le espressioni possono includere variabili, parametri e funzioni predefinite Transact-SQL. Ad esempio: {@MyVariable}, {@NameParameter}, {@@SPID} o {SERVERPROPERTY(‘ProcessID’)}.
Una delle parole chiave seguenti:
$ADDRESS restituisce il nome della stored procedure o della funzione definita dall'utente in cui è impostato il punto di interruzione. Se il punto di interruzione è impostato nella finestra dell'editor, $ADDRESS restituisce il nome del file di script modificato. $ADDRESS e $FUNCTION restituiscono le stesse informazioni nel debugger Transact-SQL.
$CALLER restituisce il nome dell'unità di codice Transact-SQL che ha chiamato una stored procedure o una funzione. Se il punto di interruzione è nella finestra dell'editor, $CALLER restituisce <No caller available>. Se il punto di interruzione è in una stored procedure o in una funzione definita dell'utente chiamata dal codice nella finestra dell'editor, $CALLER restituisce il nome del file modificato. Se il punto di interruzione è in una stored procedure o in una funzione definita dell'utente chiamata da un'altra stored procedure o funzione, $CALLER restituisce il nome della procedura o della funzione chiamante.
$CALLSTACK restituisce lo stack di chiamate delle funzioni nella catena che hanno chiamato la stored procedure o la funzione definita dall'utente corrente. Se il punto di interruzione è nella finestra dell'editor, $CALLSTACK restituisce il nome del file di script modificato.
$FUNCTION restituisce il nome della stored procedure o della funzione definita dall'utente in cui è impostato il punto di interruzione. Se il punto di interruzione è impostato nella finestra dell'editor, $FUNCTION restituisce il nome del file di script modificato.
$PID e $PNAME restituiscono l'ID e il nome del processo del sistema operativo che esegue l'istanza del Motore di database in cui viene eseguito Transact-SQL. $PID restituisce lo stesso ID di SERVERPROPERTY('ProcessID'), con la differenza che $PID è un valore esadecimale mentre SERVERPROPERTY('ProcessID') è un valore decimale.
$TID e $TNAME restituiscono l'ID e il nome del thread del sistema operativo che esegue il batch Transact-SQL. Il thread è un thread associato al processo che esegue l'istanza del Motore di database. $TID restituisce lo stesso valore di SELECT kpid FROM sys.sysprocesses WHERE spid = @@SPID, con la differenza che $TID è un valore esadecimale mentre kpid è un valore decimale.
È anche possibile utilizzare il carattere barra rovesciata (\) come un carattere di escape per consentire la presenza di parentesi graffe e barre rovesciate nel messaggio: \{, \} e \\.
Per specificare un'azione Quando raggiunto
Nella finestra dell'editor fare clic con il pulsante destro del mouse sul glifo del punto di interruzione, quindi scegliere Quando raggiunto dal menu di scelta rapida.
-oppure-
Nella finestra Punti di interruzione fare clic con il pulsante destro del mouse sul glifo del punto di interruzione, quindi scegliere Quando raggiunto dal menu di scelta rapida.
Nella finestra di dialogo Quando il punto di interruzione viene raggiunto selezionare il comportamento desiderato:
Selezionare Stampa un messaggio per stampare un messaggio nella finestra Output del debugger quando il punto di interruzione viene raggiunto.
L'opzione Esegui una macro non è disponibile dal debugger Transact-SQL ed è disattivata.
Selezionare Continua esecuzione se non si desidera che l'esecuzione venga sospesa dal punto di interruzione. Questa opzione è attiva solo se è stata selezionata l'opzione Stampa un messaggio.
Fare clic su OK per implementare le modifiche o su Annulla per uscire senza applicare le modifiche.