Utilizzo dei token nei passaggi dei processi

SQL Server Agent consente di utilizzare token negli script per passaggi di processo 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.

Importante

In SQL Server 2005 Service Pack 1 la sintassi del token dei passaggi del processo di SQL Server Agent è stata modificata. Di conseguenza, è necessario inserire una macro di escape con tutti i token utilizzati nei passaggi di processo. In caso contrario, questi passaggi avranno esito negativo. L'utilizzo delle macro di escape e l'aggiornamento dei passaggi di processo di SQL Server Agent che utilizzano token sono illustrati nelle sezioni "Informazioni sull'utilizzo dei token", "Token e macro di SQL Server Agent" e "Aggiornamento dei passaggi di processo per l'utilizzo di macro" riportate di seguito. È inoltre cambiata la sintassi di SQL Server 2000 che prevedeva l'utilizzo delle parentesi quadre per chiamare i token dei passaggi di processo di SQL Server Agent, ad esempio "[DATE]". È ora necessario racchiudere tra parentesi i nomi dei token e inserire il simbolo di dollaro ($) all'inizio della sintassi del token, ad esempio: $(ESCAPE_macro name(DATE))

Informazioni sull'utilizzo dei token

Nota sulla sicurezza

Qualsiasi utente di Windows con autorizzazioni di scrittura per il registro eventi di Windows è in grado di accedere ai passaggi di processo attivati dagli avvisi di SQL Server Agent o di WMI. Per evitare questo rischio per la sicurezza, per impostazione predefinita i token di SQL Server Agent utilizzabili nei processi attivati dagli avvisi sono disabilitati. I token interessati sono: A-DBN, A-SVR, A-ERR, A-SEV, A-MSG e WMI(property). Si noti che in questa versione l'utilizzo dei token è esteso a tutti gli avvisi. Se si desidera utilizzare questi token, verificare innanzitutto che solo i membri di gruppi di sicurezza di Windows trusted, ad esempio il gruppo Administrators, dispongano delle autorizzazioni di scrittura per il registro eventi del computer in cui è installato SQL Server. A questo punto, fare clic con il pulsante destro del mouse su SQL Server Agent in Esplora oggetti, scegliere Proprietà e nella pagina Sistema avvisi selezionare Sostituisci token per tutte le risposte del processo ad avvisi per abilitare questi token.

In SQL Server Agent i token vengono sostituiti da 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 verrà 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. In SQL Server Agent una virgoletta singola verrà sostituita con due virgolette singole nella stringa finale.

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

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

In questo caso, l'istruzione inserita SELECT @@VERSION non verrà 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. Utilizzare 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

Aggiornamento dei passaggi di processo per l'utilizzo di macro

In SQL Server 2005 Service Pack 1, i passaggi di processo che contengono token senza macro di escape avranno esito negativo e restituiranno un messaggio di errore in cui è indicato che il passaggio di processo contiene uno o più token che devono essere aggiornati con una macro prima che il processo possa essere eseguito.

Nell'articolo 915845 della Microsoft Knowledge Base I processi di SQL Server Agent non sono riusciti quando i processi contengono i passaggi di processo che utilizzano i token dopo aver installato SQL Server 2005 Service Pack 1 è disponibile uno script che consente di aggiornare tutti i passaggi di processo che utilizzano token con la macro ESCAPE_NONE. Dopo aver utilizzato questo script, è consigliabile esaminare al più presto i passaggi di processo che utilizzano token e sostituire la macro ESCAPE_NONE con una macro di escape appropriata per il contesto del passaggio di processo.

Nella tabella seguente viene indicata la modalità di gestione della sostituzione del token in SQL Server Agente. 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à, quindi 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

A.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 ;

Si noti inoltre che in questo esempio la funzione QUOTENAME imposta il carattere utilizzato per le virgolette.

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. Poiché non è necessario alcun delimitatore per i tipi di dati binari, la macro ESCAPE_NONE viene utilizzata con il token JOBID. Non è necessario aggiornare questo passaggio di processo dopo aver eseguito lo script di aggiornamento.

SELECT * FROM msdb.dbo.sysjobs

WHERE @JobID = CONVERT(uniqueidentifier, $(ESCAPE_NONE(JOBID))) ;

Vedere anche

Concetti

Implementazione di processi

Gestire passaggi di processo