Использование маркеров в шагах задания

Изменения: 14 апреля 2006 г.

Агент SQL Server позволяет применять маркеры в сценариях шагов заданий на языке Transact-SQL. Применение маркеров при написании шагов заданий обеспечивают такую же гибкость, какую дают переменные при написании программ. После добавления маркера в сценарий шага задания агент SQL Server замещает маркер во время выполнения, до того как шаг задания выполняется подсистемой Transact-SQL

Важно!

В пакете обновления 1 SQL Server 2005 синтаксис маркера шага задания агента SQL Server изменился. В результате управляющий макрос должен сопровождать все маркеры, используемые в шагах заданий, иначе произойдет сбой в шагах заданий. Использование управляющих макросов и обновление шагов заданий агента SQL Server, в которых используются маркеры, описывается в разделах «Основные сведения об использовании маркеров», «Макросы и маркеры агента SQL Server» и «Обновление шагов заданий для использования маркеров». Кроме того, также изменился синтаксис SQL Server 2000, при котором для обнаружения маркеров шагов заданий SQL Server (например «[DATE]») использовались квадратные скобки. Теперь имена маркеров необходимо заключать в круглые скобки и в начале записи маркера добавлять знак доллара ($). Например: $(ESCAPE_имя макроса(DATE))

Основные сведения об использовании маркеров

Примечание безопасности.

Все пользователи Windows с разрешением на запись в журнал событий Windows могут получить доступ к шагам заданий, которые активируются предупреждениями агента SQL Server или предупреждениями инструментария WMI. Чтобы избежать этого нарушения безопасности, в SQL Server маркеры агента, которые могут использоваться в заданиях, активированных предупреждениями, по умолчанию отключены. Такими маркерами являются: A-DBN, A-SVR, A-ERR, A-SEV, A-MSG. и WMI(свойство). Если необходимо использовать эти маркеры, сначала убедитесь, что разрешением на работу с журналом событий компьютера, на котором находится SQL Server, обладают только члены доверенных групп безопасности Windows, таких как группа «Администраторы». Затем, чтобы включить эти маркеры, щелкните правой кнопкой мыши элемент Агент SQL Server в обозревателе объектов, выберите пункт меню Свойства и на странице Система предупреждений выберите Заменять маркеры всех ответов заданий на предупреждения.

Замена маркеров агента SQL Server проста и эффективна: Агент SQL Server заменяет маркер точной символьной строкой. Все маркеры обрабатываются с учетом регистра. Шаги заданий должны это учитывать для учетной записи и правильно заключать в кавычки применяемые маркеры или преобразовывать замещающие строки к верному типу данных.

Например, чтобы напечатать имя базы данных в шаге задания, можно использовать следующую инструкцию:

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

В этом примере макрос ESCAPE_SQUOTE добавляется с маркером A-DBN. Во время выполнения маркер A-DBN будет замещен соответствующим именем базы данных. Управляющий макрос экранирует все одиночные кавычки, которые случайно передаются в строку замещения маркера. Агент SQL Server заместит символ одиночной кавычки двумя символами одиночной кавычки в конечной строке.

Например, если замещающая маркер строка AdventureWorks'SELECT @@VERSION --, то команда, выполняемая агентом SQL Server имеет вид:

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

В этом случае добавленная инструкция SELECT @@VERSION не выполняется. Вместо этого, дополнительный символ одинарной кавычки заставляет сервер анализировать передаваемую инструкцию как строку. Если замещающая маркер строка не содержит одинарных кавычек, то никакие символы не экранируются, и шаг задания, содержащий маркер, выполняется как планировалось.

Чтобы отладить использование маркеров в шагах заданий, используйте инструкции вывода на печать, такие как PRINT N'$(ESCAPE_SQUOTE(SQLDIR))' и сохраняйте выходные данные шага задания в файл или таблицу. Используйте страницу Дополнительно диалогового окна Свойства шага задания для указания выходного файла или таблицы для шага задания.

Маркеры и макросы агента SQL Server

В следующей таблице перечислены и описаны маркеры и макросы, которые поддерживает агент SQL Server.

Маркеры агента SQL Server

Управляющие макросы агента SQL Server

Обновление шагов заданий для использования маркеров

В пакете обновления 1 SQL Server 2005 шаги заданий, содержащие маркеры без экранирующих символов завершатся сбоем и возвратят сообщение об ошибке; это сообщение показывает, что шаг задания содержит один или более маркеров, которые необходимо обновить с помощью макроса перед тем, как задание можно выполнить.

Предоставляется сценарий вместе со статьей базы знаний Microsoft SQL Server Agent Job Steps That Use Tokens Fail in SQL Server 2005 Service Pack 1. Этот сценарий можно использовать, чтобы обновить все шаги заданий, которые используют маркеры с макросом ESCAPE_NONE. После применения этого сценария рекомендуется как можно скорее просмотреть шаги заданий, в которых используются маркеры, и заменить макрос ESCAPE_NONE управляющим макросом, который соответствует контексту шага задания.

В следующей таблице показано, как замена маркеров обрабатывается агентом SQL Server в пакете обновления 1 SQL Server 2005. Чтобы включить или выключить предупреждение о замещении маркеров, щелкните правой кнопкой мыши агент SQL Server в обозревателе объектов, выберите пункт меню Свойства и на странице Система предупреждений установите или снимите флажок Заменить маркеры всех ответов заданий на предупреждения.

Примеры обновления синтаксиса маркеров

А. Использование маркеров в невложенных строках

В следующем примере показано, как обновить простой сценарий без вложенных строк соответствующим управляющим маркером. До выполнения обновляющего сценария следующий сценарий шага задания использует маркер шага задания, чтобы напечатать соответствующее имя базы данных:

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

После выполнения обновляющего сценария макрос ESCAPE_NONE добавляется перед маркером A-DBN. Так как для отделения строки печати используются одинарные кавычки, необходимо обновить шаг задания, добавив макрос ESCAPE_SQUOTE следующим образом:

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

Б. Использование маркеров во вложенных строках

В сценариях шагов заданий, где маркеры используются во вложенных строках или инструкциях, перед добавлением соответствующих управляющих маркеров следует переписать вложенные инструкции в виде нескольких инструкций.

Например, рассмотрим следующий шаг задания, в котором используется маркер A-MSG и который не был обновлен с помощью управляющего макроса:

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

После выполнения обновляющего сценария макрос ESCAPE_NONE добавляется с маркером. Однако, в этом случае необходимо переписать сценарий, чтобы не использовалось вложение, как показано ниже, и добавить макрос ESCAPE_SQUOTE, чтобы правильным образом экранировать разделители, которые могут быть переданы в строку замены маркера:

DECLARE @msgString nvarchar(max)

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

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

PRINT N'Print ' + @msgString ;

Имейте в виду, что функция QUOTENAME устанавливает символ кавычки.

В. Использование маркеров с макросом ESCAPE_NONE

Следующий пример является частью сценария, который извлекает job_id из таблицы sysjobs и использует маркер JOBID, чтобы заполнить переменную @JobID, которая была объявлена как бинарный тип данных ранее в сценарии. Имейте в виду, что с маркером JOBID используется макрос ESCAPE_NONE, так как для бинарного типа данных разделители не требуются. После выполнения сценария обновления не нужно обновлять этот шаг задания.

SELECT * FROM msdb.dbo.sysjobs

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

См. также

Другие ресурсы

sp_add_jobstep (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений