Usare i token nei passaggi dei processi

Si applica a: SQL Server e Istanza gestita di SQL di Azure

SQL Server Agent consente di usare token negli script dei passaggi di processo di Transact-SQL. L'utilizzo di token quando si scrivono passaggi di processo offre la stessa flessibilità assicurata dalle variabili quando si scrivono programmi software. Dopo aver inserito un token nello script di un passaggio di processo, SQL Server Agent sostituisce il token in fase di esecuzione, prima che il passaggio di processo venga eseguito dal sottosistema Transact-SQL.

Informazioni sull'utilizzo dei token

SQL Server Agent sostituirà i token con valori stringa letterali esatti, con un'operazione semplice ed efficiente. Tutti i token effettuano una distinzione tra maiuscole e minuscole. È necessario prendere in considerazione tale comportamento nei passaggi di processo e indicare correttamente i token da utilizzare oppure convertire la stringa di sostituzione nel tipo di dati corretto.

Ad esempio, è possibile utilizzare l'istruzione seguente per inserire il nome del database in un passaggio di processo:

PRINT N'Current database name is $(ESCAPE_SQUOTE(A-DBN))' ;

In questo esempio la macro ESCAPE_SQUOTE viene inserita con il token A-DBN . In fase di esecuzione il token A-DBN viene sostituito con il nome del database appropriato. Tramite la macro di escape è possibile utilizzare caratteri di escape per eventuali virgolette singole inavvertitamente passate nella stringa di sostituzione del token. SQL Server Agent sostituisce una virgoletta singola con due virgolette singole nella stringa finale.

Se ad esempio la stringa passata per sostituire il token è AdventureWorks2022'SELECT @@VERSION --, il comando eseguito dal passaggio di processo di SQL Server Agent sarà il seguente:

PRINT N'Current database name is AdventureWorks2022''SELECT @@VERSION --' ;

In questo caso, l'istruzione inserita, SELECT @@VERSION, non viene eseguita. Al contrario, la virgoletta singola aggiuntiva indurrà il server ad analizzare l'istruzione inserita come stringa. Se la stringa di sostituzione del token non contiene una virgoletta singola, per nessun carattere verranno utilizzati caratteri di escape e il passaggio di processo contenente il token verrà eseguito come previsto.

Per eseguire il debug dell'utilizzo dei token nei passaggi di processo, utilizzare istruzioni PRINT come PRINT N'$(ESCAPE_SQUOTE(SQLDIR))' e salvare l'output del passaggio di processo in un file o in una tabella. Usare la pagina Avanzate della finestra di dialogo Proprietà passaggio processo per specificare un file o una tabella per l'output del passaggio di processo.

Token e macro di SQL Server Agent

Nelle tabelle seguenti vengono elencati e illustrati i token e le macro supportati da SQL Server Agent.

Token di SQL Server Agent

Macro di escape di SQL Server Agent

Aggiornare i passaggi del processo per usare le macro

La tabella seguente descrive in che modo SQL Server Agent gestisce la sostituzione dei token. Per attivare o disattivare la sostituzione dei token relativi agli avvisi, fare clic con il pulsante destro del mouse su SQL Server Agent in Esplora oggetti, scegliere Proprietàe selezionare o deselezionare la casella di controllo Sostituisci token per tutte le risposte del processo ad avvisi nella pagina Sistema avvisi .

Esempi di aggiornamento della sintassi dei token

Di seguito sono riportati esempi di sintassi dei token per illustrare come usare questi comandi.

R. Utilizzo di token in stringhe non nidificate

Nell'esempio seguente viene illustrato come aggiornare uno script semplice non nidificato con la macro di escape appropriata. Prima di eseguire lo script di aggiornamento, lo script del passaggio di processo seguente utilizza un token per inserire il nome del database appropriato:

PRINT N'Current database name is $(A-DBN)' ;

Dopo aver eseguito lo script di aggiornamento, una macro ESCAPE_NONE viene inserita prima del token A-DBN . Poiché le virgolette singole vengono utilizzate per delimitare la stringa di stampa, è necessario aggiornare il passaggio di processo inserendo la macro ESCAPE_SQUOTE nel modo seguente:

PRINT N'Current database name is $(ESCAPE_SQUOTE(A-DBN))' ;

B. Utilizzo di token in stringhe nidificate

Negli script dei passaggi di processo in cui i token vengono utilizzati in istruzioni o stringhe nidificate, è necessario riscrivere le istruzioni nidificate come più istruzioni prima di inserire le macro di escape appropriate.

Si consideri, ad esempio, il passaggio di processo seguente che non è stato aggiornato con una macro di escape e nel quale viene utilizzato il token A-MSG:

PRINT N'Print ''$(A-MSG)''' ;

Dopo aver eseguito lo script di aggiornamento, una macro ESCAPE_NONE viene inserita con il token. In questo caso, tuttavia, è necessario riscrivere lo script senza utilizzare la nidificazione nel modo seguente e inserire la macro ESCAPE_SQUOTE per utilizzare correttamente caratteri di escape per i delimitatori che potrebbero essere passati nella stringa di sostituzione del token:

DECLARE @msgString nvarchar(max);
SET @msgString = '$(ESCAPE_SQUOTE(A-MSG))';
SET @msgString = QUOTENAME(@msgString,'''');
PRINT N'Print ' + @msgString;

C. Utilizzo di token con la macro ESCAPE_NONE

L'esempio seguente fa parte di uno script in cui job_id viene recuperato dalla tabella sysjobs e in cui il token JOBID viene utilizzato per popolare la variabile @JobID dichiarata in precedenza nello script come tipo di dati binario.

DECLARE @JobID uniqueidentifier
SET @JobID = $(ESCAPE_NONE(JOBID))

Questo assegna direttamente il valore dal token JOBID a @JobID, eliminando le query di database non necessarie e le conversioni implicite, risolvendo i problemi generati nella sezione C.

Vedi anche

• Implementazione di processi
• Gestire passaggi di processo