於作業步驟使用 Token

更新： 2006 年 4 月 14 日

SQL Server Agent 可讓您在 Transact-SQL 作業步驟指令碼中使用 Token。撰寫作業步驟時使用 Token，所賦予您的彈性與撰寫軟體程式時使用的變數一樣。在作業步驟指令碼中插入 Token 後，SQL Server Agent 就會先在執行階段取代此 Token，然後再由 Transact-SQL 子系統執行作業步驟。

重要事項：
在 SQL Server 2005 Service Pack 1 中，SQL Server Agent 作業步驟的 Token 語法已變更。因此，逸出巨集現在必須伴隨著作業步驟中使用的所有 Token 一起執行，否則這些作業步驟將會失敗。下列「了解如何使用 Token」、「SQL Server Agent Token 和巨集」及「將作業步驟更新成使用巨集」各節中將說明如何使用逸出巨集以及如何更新使用 Token 的 SQL Server Agent 作業步驟。此外，原本使用方括號來呼叫 SQL Server Agent 作業步驟 Token (例如 "[DATE]") 的 SQL Server 2000 語法也已變更。現在必須改用括號括住 Token 名稱，並且在 Token 語法的開頭加上錢幣符號 ($)。例如： $(ESCAPE_巨集名稱(DATE))

了解如何使用 Token

安全性注意事項：
對 Windows 事件記錄檔具有寫入權限的任何 Windows 使用者，都可以存取由 SQL Server Agent 警示或 WMI 警示啟動的作業步驟。為避免此安全性風險，根據預設會停用可用於由警示啟動之作業的 SQL Server Agent Token。這些 Token 包括：A-DBN、A-SVR、A-ERR、A-SEV、A-MSG 及 WMI(property)。 如果需要使用這些 Token，請先確定只有受信任的 Windows 安全性群組的成員 (例如管理員群組)，才對 SQL Server 所在電腦的事件記錄檔具有寫入權限。然後以滑鼠右鍵按一下 [物件總管] 中的 [SQL Server Agent]，選取 [屬性]，然後在 [警示系統] 頁面上選取 [取代回應警示之所有作業的 Token]，以啟用這些 Token。

SQL Server Agent Token 取代功能既簡單又有效率：SQL Server Agent 會使用精確的常值字串值來取代 Token。所有 Token 需區分大小寫。您的作業步驟必須將這點納入考量，並且必須正確引用您所用的 Token 或將取代字串轉換成正確的資料類型。

例如，您可能會使用下列陳述式，在作業步驟中列印資料庫的名稱：

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

在此範例中，ESCAPE_SQUOTE 巨集是使用 A-DBN Token 插入的。在執行階段，A-DBN Token 將會被取代成正確的資料庫名稱。逸出巨集會逸出不慎傳入 Token 取代字串的任何單引號。SQL Server Agent 將在最終字串中使用兩個單引號來取代一個單引號。

例如，如果針對取代 Token 所傳遞的字串是 AdventureWorks'SELECT @@VERSION --，則由 SQL Server Agent 作業步驟所執行的命令將會是：

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

在此情況下，插入的陳述式 SELECT @@VERSION 不會執行。額外的單引號反而會導致伺服器將插入的陳述式剖析成字串。如果 Token 取代字串不包含單引號，就不會逸出任何字元，而且包含 Token 的作業步驟會如預期方式執行。

若要在作業步驟中偵錯 Token 的使用方式，請使用 PRINT 陳述式 (例如 PRINT N'$(ESCAPE_SQUOTE(SQLDIR))')，並將作業步驟輸出儲存至檔案或資料表。您可以使用 [作業步驟屬性] 對話方塊的 [進階] 頁面來指定作業步驟輸出檔或資料表。

SQL Server Agent Token 和巨集

下表將列出並描述 SQL Server Agent 支援的 Token 和巨集。

SQL Server Agent Token

SQL Server Agent 逸出巨集

將作業步驟更新成使用巨集

在 SQL Server 2005 Service Pack 1 中，包含 Token 但不含逸出巨集的作業步驟將會失敗，而且會傳回一則錯誤訊息，表示作業步驟含有一或多個在執行作業之前必須使用巨集更新的 Token。

Microsoft 知識庫文件＜使用 Token 的 SQL Server Agent 作業步驟在 SQL Server 2005 Service Pack 1 中失敗＞(英文) 提供了一個指令碼。您可以使用這個指令碼來更新使用 Token 搭配 ESCAPE_NONE 巨集的所有作業步驟。使用這個指令碼之後，我們建議您盡快檢閱使用 Token 的作業步驟，並且使用適用於此作業步驟內容的逸出巨集來取代 ESCAPE_NONE 巨集。

下表將描述 SQL Server 2005 Service Pack 1 中的 SQL Server Agent 如何處理 Token 取代。若要開啟或關閉警示 Token 取代，請以滑鼠右鍵按一下 [物件總管] 中的 [SQL Server Agent]、選取 [屬性]，然後在 [警示系統] 頁面上，選取或清除 [取代回應警示之所有作業的 Token] 核取方塊。

Token 語法更新範例

A. 在非巢狀字串中使用 Token

下列範例將說明如何使用正確的逸出巨集來更新簡單的非巢狀指令碼。執行更新指令碼之前，下列作業步驟指令碼會使用一個作業步驟 Token 來列印正確的資料庫名稱：

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

執行更新指令碼之後，會在 A-DBN Token 前面插入 ESCAPE_NONE 巨集。由於單引號是用來分隔 PRINT 字串，所以您必須依照下列方式插入 ESCAPE_SQUOTE 巨集，藉以更新此作業步驟：

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

B. 在巢狀字串中使用 Token

在 Token 用於巢狀字串或陳述式的作業步驟指令碼中，巢狀陳述式應該先重新撰寫成多個陳述式，然後再插入正確的逸出巨集。

例如，請考慮下列使用 A-MSG Token 而且尚未使用逸出巨集更新的作業步驟：

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

執行更新指令碼之後，會使用此 Token 插入 ESCAPE_NONE 巨集。不過，在此情況下，您必須依照下列方式重新撰寫不使用巢狀的指令碼，並插入 ESCAPE_SQUOTE 巨集，以便適當逸出可能會傳入 Token 取代字串的分隔符號：

DECLARE @msgString nvarchar(max)

SET @msgString = '$(ESCAPE_SQUOTE(A-MSG))'

SET @msgString = QUOTENAME(@msgString,'''')

PRINT N'Print ' + @msgString ;

此外，請注意此範例中，QUOTENAME 函數會設定引號字元。

C. 使用 Token 搭配 ESCAPE_NONE 巨集

下列範例是指令碼的一部分，而這個指令碼會從 sysjobs 資料表擷取 job_id 並使用 JOBID Token 來擴展 @JobID 變數 (之前在指令碼中宣告成二進位資料類型)。請注意，由於二進位資料類型不需要任何分隔符號，所以 ESCAPE_NONE 巨集會搭配 JOBID Token 使用。您不需要在執行更新指令碼之後，更新此作業步驟。

SELECT * FROM msdb.dbo.sysjobs

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

請參閱

其他資源

sp_add_jobstep (Transact-SQL)

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄