Как поменять директорию jobs в ms sql
Есть работающий скрипт по копированию последнего файла из папки:
@echo off
setlocal
pushd «x:\in»
for /f «tokens=*» %%i in (‘ dir /b *.txt ‘) do (
for /f «tokens=1» %%j in ( «%%~ti» ) do if «%%j»==»%date%» set «file=%%i»
)
copy «%file%» «x:\out»
popd
Создал джобс с этим скриптом — не работает.
Ошибка: [136] Job . reported: The process could not be created for step 1 of job 0xC2A95A6062992C49AD3111E8DABCAB9E (reason: The system cannot find the file specified)
Пробовал менять owner’a и добавлять права на каталоги — безрезультатно. В чем может быть дело?
Причина: Система не может найти указанный файл
(1) ну если запускаю руками батник — то всё отрабатывает нормально, файлы присутствуют
агент включен если я понимаю, и все таки права . имхо
ЗЫ например болезнь винды с шедулером — запускать необходимо от локального админа данного сервера — а то те же самые грабли
Change Steps of a SQL Server Agent Master Job
В Управляемом экземпляре Azure SQL в настоящее время поддерживается большинство функций агента SQL Server (но не все). Подробные сведения см. в статье Различия в T-SQL между Управляемым экземпляром SQL Azure и SQL Server.
В этой статье описывается внесение изменений в шаги главного задания агента SQL Server в SQL Server с помощью среды SQL Server Management Studio или Transact-SQL.
Перед началом
Ограничения
Главное задание агента SQL Server не может быть ориентировано как на локальный, так и на удаленный сервер.
Безопасность
Разрешения
Если пользователь не является членом предопределенной роли сервера sysadmin , он может изменять только свои собственные задания. Дополнительные сведения см. в разделе Обеспечение безопасности агента SQL Server.
Использование среды SQL Server Management Studio
Внесение изменений в шаги главного задания агента SQL Server
- В обозревателе объектов щелкните знак «плюс», чтобы развернуть сервер, содержащий задание, в котором нужно изменить шаги.
- Щелкните знак «плюс», чтобы развернуть Агент SQL Server.
- Чтобы развернуть папку Задания , щелкните значок «плюс».
- Щелкните правой кнопкой мыши задание, шаги которого требуется изменить, и выберите пункт Свойства.
- В диалоговом окне Свойства задания —имя_задания в разделе Выберите страницу выберите пункт Шаги.
- Нажмите кнопку Изменить, чтобы открыть диалоговое окно Свойства шага задания —имя_шага_задания. Дополнительные сведения о доступных параметрах данного диалогового окна см. в разделах Свойства шага задания — создание шага задания (страница «Общие») и Свойства шага задания — создание шага задания (страница «Дополнительно»).
- После завершения нажмите кнопку ОК.
- В диалоговом окне Свойства задания —имя_задания нажмите кнопку ОК.
Использование Transact-SQL
Внесение изменений в шаги главного задания агента SQL Server
- В обозревателе объектовподключитесь к экземпляру компонента Компонент Database Engine.
- На стандартной панели выберите пункт Создать запрос.
- Скопируйте следующий пример в окно запроса и нажмите кнопку Выполнить.
-- changes the number of retry attempts for the first step -- of the Weekly Sales Data Backup job. -- After running this example, the number of retry attempts is 10 USE msdb ; GO EXEC dbo.sp_update_jobstep @job_name = N'Weekly Sales Data Backup', @step_id = 1, @retry_attempts = 10 ; GO
Дополнительные сведения см. в разделе sp_update_jobstep (Transact-SQL).
Создание задания
В Управляемом экземпляре Azure SQL в настоящее время поддерживается большинство функций агента SQL Server (но не все). Подробные сведения см. в статье Различия в T-SQL между Управляемым экземпляром SQL Azure и SQL Server.
В этой статье описывается создание задания агента SQL Server в SQL Server с помощью среды SQL Server Management Studio, Transact-SQL или управляющих объектов SQL Server (SMO).
Чтобы добавить шаги заданий, расписаний, предупреждений и уведомлений, которые можно отправить операторам, см. ссылки на разделы руководства.
- Перед началом работыОграниченияБезопасность
- Для создания задания используетсяSQL Server Management Studio, Transact-SQLУправляющие объекты SQL Server
Перед началом
Ограничения
- Чтобы создать задание, пользователь должен быть членом одной из предопределенных ролей базы данных агента SQL Server или членом предопределенной роли сервера sysadmin . Задание может быть изменено его владельцем или членом роли sysadmin . Дополнительные сведения о предопределенных ролях базы данных агента SQL Server см. в разделе Предопределенные роли базы данных агента SQL Server.
- Назначение задания другому имени входа не гарантирует того, что новый владелец обладает достаточными разрешениями для успешного запуска задания.
- Локальные задания кэшируются локальным агентом SQL Server , поэтому внесение в задание агента SQL Server любых изменений неявно вызывает его повторное кэширование. Поскольку агент SQL Server не помещает задание в кэш до вызова процедуры sp_add_jobserver , эффективнее вызывать процедуру sp_add_jobserver последней.
Безопасность
- Чтобы изменить владельца задания, необходимо быть системным администратором.
- Из соображений безопасности изменять определение задания может только его владелец или член роли sysadmin . Только члены предопределенной роли сервера sysadmin могут предоставлять права владения заданием другим пользователям, а также могут запускать любое задание, независимо от того, кто является его владельцем.
Примечание Если задать в качестве нового владельца задания пользователя, не являющегося членом предопределенной роли сервера sysadmin , а задание выполняет шаги, которым требуются учетные записи-посредники (например, выполнение пакета служб Integration Services ), убедитесь в том, что пользователь имеет доступ к этой учетной записи-посреднику, в противном случае задание завершится ошибкой.
Разрешения
Использование среды SQL Server Management Studio
Создание задания агента SQL Server
- В обозревателе объектовщелкните знак «плюс», чтобы развернуть сервер, на котором нужно создать задание агента SQL Server.
- Щелкните знак «плюс», чтобы развернуть Агент SQL Server.
- Щелкните правой кнопкой мыши папку Задания и выберите пункт Создать задание….
- На странице Общие в диалоговом окне Создание задания измените общие свойства задания. Дополнительные сведения о параметрах на этой странице см. в разделе Свойства задания — Создание задания (страница «Общие»)
- На странице Действия задайте шаги задания. Дополнительные сведения о параметрах на этой странице см. в разделе Свойства задания — Создание задания (страница «Шаги»)
- На странице Расписания задайте расписания для задания. Дополнительные сведения о параметрах на этой странице см. в разделе Свойства задания — Создание задания (страница «Расписания»)
- На странице Предупреждения задайте предупреждения для задания. Дополнительные сведения о параметрах на этой странице см. в разделе Свойства задания — Создание задания (страница «Предупреждения»)
- На странице Уведомления задайте действия, которые должен выполнять агент Microsoft SQL Server после завершения задания. Дополнительные сведения о параметрах на этой странице см. в разделе Свойства задания — Создание задания (страница «Уведомления»).
- Страница Цели используется для управления целевыми серверами в задании. Дополнительные сведения о параметрах на этой странице см. в разделе Свойства задания — Создание задания (страница «Целевые объекты»).
- После завершения нажмите кнопку ОК.
Использование Transact-SQL
Создание задания агента SQL Server
- В обозревателе объектовподключитесь к экземпляру компонента Компонент Database Engine.
- На стандартной панели выберите пункт Создать запрос.
- Скопируйте следующий пример в окно запроса и нажмите кнопку Выполнить.
USE msdb ; GO EXEC dbo.sp_add_job @job_name = N'Weekly Sales Data Backup' ; GO EXEC sp_add_jobstep @job_name = N'Weekly Sales Data Backup', @step_name = N'Set database to read only', @subsystem = N'TSQL', @command = N'ALTER DATABASE SALES SET READ_ONLY', @retry_attempts = 5, @retry_interval = 5 ; GO EXEC dbo.sp_add_schedule @schedule_name = N'RunOnce', @freq_type = 1, @active_start_time = 233000 ; USE msdb ; GO EXEC sp_attach_schedule @job_name = N'Weekly Sales Data Backup', @schedule_name = N'RunOnce'; GO EXEC dbo.sp_add_jobserver @job_name = N'Weekly Sales Data Backup'; GO
Дополнительные сведения см. в разделе:
- sp_add_job (Transact-SQL)
- sp_add_jobstep (Transact-SQL)
- sp_add_schedule (Transact-SQL)
- sp_attach_schedule (Transact-SQL)
- sp_add_jobserver (Transact-SQL)
Использование управляющих объектов SQL Server
Создание задания агента SQL Server
Вызовите метод Create класса Job на любом языке программирования, таком как Visual Basic, Visual C# или PowerShell. Пример кода см. в разделе Планирование автоматических административных задач в агенте SQL Server.
3.5. SQL Server Agent — Часть 1

В состав сервера MS SQL Server входит сервис SQL Server Agent, который состоит из сообщений, операторов и работ. Наибольший интерес программистов и администраторов вызывают работы, поэтому этой теме мы уделим достаточно подробное внимание.
Работа администратора очень часто связана с выполнением однообразных задач, что превращает рабочий день в серые будни. Для меня это самое сложное, поэтому многократно выполняемые задачи я стремлюсь автоматизировать. У MS SQL Server есть достаточно мощное средство автоматизации – работ (job). Работы – это набор определенных действий (например, SQL запросов), которые могут выполняться сервером автоматически в определенное время с помощью планировщика (Schedule) или запускаться администратором вручную.
Ярким примером задач администратора, которые могут вызывать скуку, является обслуживание баз данных, о чем мы будем достаточно много говорить в главе 4. Например, можно запрограммировать сервер так, чтобы он каждый день в конце рабочего дня создавал резервную копию базы данных.
Работы состоят из шагов, которые последовательно выполняются сервером MS SQL Server. Выполнение каждого последующего шага может зависеть от результата предыдущего. Таким образом, можно строить определенную логику задач.
Вы должны учитывать, что работы выполняются не самим сервисом MS SQL Server, а сервисом SQL Server Agent, который входит в поставку MS SQL Server. Поэтому, убедитесь, что этот сервис работает, иначе работы не смогут выполняться по расписанию.
Помимо этого, если сервис обращается к удаленным серверам по сети, то SQL Server Agent должен работать под реальной учетной записью, а не под системной. Чтобы изменить имя пользователя, с правами, которыми работает сервис, запустите оснастку Сервисы (Пуск/Панель управления/Администрирование/Сервисы). Перед вами откроется окно, как на рисунке 3.1. Найдите строку с именем сервиса SQLSERVERAGENT и дважды щелкните по ней. Перейдите на закладку «Вход в систему» (Log on) и укажите реальную учетную запись пользователя, который существует в системе и обладает правами на необходимые ресурсы вашего компьютера и удаленного сервера, к которому будет происходить подключение по сети. Если сервис SQL Server Agent будет работать с правами системного аккаунта, то у него не хватит прав на подключение к удаленной системе, потому что системный аккаунт не имеет имени пользователя и пароля, необходимых для аутентификации.
3.5.1. Добавление работы
Начнем с добавления записей. Для этого используется хранимая процедура sp_add_job, которая выглядит следующим образом:
sp_add_job [ @job_name = ] 'job_name' [ , [ @enabled = ] enabled ] [ , [ @description = ] 'description' ] [ , [ @start_step_id = ] step_id ] [ , [ @category_name = ] 'category' ] [ , [ @category_id = ] category_id ] [ , [ @owner_login_name = ] 'login' ] [ , [ @notify_level_eventlog = ] eventlog_level ] [ , [ @notify_level_email = ] email_level ] [ , [ @notify_level_netsend = ] netsend_level ] [ , [ @notify_level_page = ] page_level ] [ , [ @notify_email_operator_name = ] 'email_name' ] [ , [ @notify_netsend_operator_name = ] 'netsend_name' ] [ , [ @notify_page_operator_name = ] 'page_name' ] [ , [ @delete_level = ] delete_level ] [ , [ @job_id = ] job_id OUTPUT ]
Рассмотрим параметры, которые передаются данной процедуре:
- @job_name – имя работы, которое должно быть уникальным и не может содержать символ процента;
- @enabled – индикатор активности работы. Если параметр равен 1, то работа активна и может выполняться из планировщика задач. Если указать 0, то работа не может выполняться автоматически, запуск доступен только вручную;
- @description – текстовое описание работы;
- @start_step_id – идентификатор работы, которая должна выполняться первой, по умолчанию используется число 1;
- @category_name – имя категории;
- @category_id – идентификатор категории. Этот параметр может использоваться в определенных языках программирования;
- @owner_login_name – имя пользователя, который будет являться владельцем работы. Если ничего не указано, то владельцем будет текущий пользователь;
- @notify_level_eventlog – какие сообщения должны сохраняться в журнале событий Windows. Здесь можно указать одно из следующих значений:
- 0 – никакие сообщения;
- 1 – сообщения об удачном завершении;
- 2 – сообщения об ошибках (значение по умолчанию);
- 3 – все сообщения.
Прежде чем использовать процедуру, необходимо отметить, что она принадлежит базе данных msdb, поэтому необходимо подключиться именно к этой базе.
Есть еще одно ограничение – вы должны указывать имена только реально существующих в базе данных операторов, поэтому посмотрим на пример без указания операторов:
USE msdb EXEC sp_add_job @job_name = 'Тестовая работа', @enabled = 1, @description = 'Это тестовая работа', @notify_level_eventlog = 3, @notify_level_email = 2, @notify_level_netsend = 1
3.5.2. Управление операторами
Оператор – это описание человека, который должен получать сообщения сервера MS SQL Server и сообщения о ходе выполнения работы. Для создания оператора используется процедура sp_add_operator, которая выглядит следующим образом:
sp_add_operator [ @name = ] 'name' [ , [ @enabled = ] enabled ] [ , [ @email_address = ] 'email_address' ] [ , [ @pager_address = ] 'pager_address' ] [ , [ @weekday_pager_start_time = ] weekday_pager_start_time ] [ , [ @weekday_pager_end_time = ] weekday_pager_end_time ] [ , [ @saturday_pager_start_time = ] saturday_pager_start_time ] [ , [ @saturday_pager_end_time = ] saturday_pager_end_time ] [ , [ @sunday_pager_start_time = ] sunday_pager_start_time ] [ , [ @sunday_pager_end_time = ] sunday_pager_end_time ] [ , [ @pager_days = ] pager_days ] [ , [ @netsend_address = ] 'netsend_address' ] [ , [ @category_name = ] 'category' ]
Рассмотрим параметры этой процедуры:
- @name – имя оператора;
- @enabled – если параметр равен 1, то оператор активен, а если указать 0, то оператор не доступен и не должен получать сообщений;
- @email_address – электронный адрес (e-mail) оператора. Если значение этого параметра является физическим адресом SMTP:flenov@mail.ru, а не псевдонимом flenov, то он должен быть заключен в квадратные скобки [SMTP:flenov@mail.ru]. Дело в том, что по умолчанию MS SQL Server использует почтовый сервис Exchange Service, который использует свою систему именования ящиков;
- @pager_address – адрес Интернет пейджера;
- @weekday_pager_start_time – время, после которого можно отправлять сообщения на пейджер в рабочий день. Время указывается в формате ЧЧММСС, например, число 100100 соответствует 10 часам, 01 минуте и 00 секундам;
- @weekday_pager_end_time – время, до которого можно отправлять сообщения на пейджер в рабочий день. Время указывается в формате ЧЧММСС, например, число 100100 соответствует 10 часам, 01 минуте и 00 секундам;
- @saturday_pager_start_time и @sunday_pager_start_time – время, после которого можно отправлять сообщения на пейджер в субботу и в воскресенье соответственно. Время указывается в формате ЧЧММСС, например, число 100100 соответствует 10 часам, 01 минуте и 00 секундам;
- @saturday_pager_end_time и @sunday_pager_end_time – время, до которого можно отправлять сообщения на пейджер в субботу и в воскресенье соответственно. Время указывается в формате ЧЧММСС, например, число 100100 соответствует 10 часам, 01 минуте и 00 секундам;
- @pager_days – этот параметр определяет дни, в которые оператор доступен для получения сообщений на пейджер. Здесь можно указать одно из следующих значений или сумму из нескольких чисел:
- 0 – никогда (это значение по умолчанию);
- 1 – по воскресеньям;
- 2 – по понедельникам;
- 4- по вторникам;
- 8 – по средам;
- 16- по четвергам;
- 32 – по пятницам;
- 64 – по субботам.
Как указать, что пользователь доступен с понедельника по пятницу? Для этого складываем соответствующие числа 2+4+8+16+32. В результате мы получим 62 и именно это значение необходимо указать в параметре @pager_days.
- @netsend_address – сетевой адрес оператора (имя компьютера), на который нужно отправлять сообщения;
- @category_name – имя категории сообщений.
Посмотрим, как можно создать оператора, который будет получать сообщения на e-mail адрес:
use msdb exec sp_add_operator @name = 'Андрей', @enabled = 1, @email_address ='[SMTP:flenov@mail.ru]'
Следующий пример создает оператора, который может получать e-mail и NET SEND сообщения:
use msdb exec sp_add_operator @name = 'Михаил', @enabled = 1, @email_address ='[SMTP:admin@mail.ru]', @netsend_address ='admincomp'
Теперь посмотрим, как можно создать работу, в которой сообщения о статусе выполнения работы передаются операторам:
USE msdb EXEC sp_add_job @job_name = 'Тестовая работа 2', @enabled = 1, @description = 'Это тестовая работа с указанием оператора', @notify_level_eventlog = 3, @notify_level_email = 2, @notify_level_netsend = 1, @notify_email_operator_name = 'Андрей', @notify_netsend_operator_name = 'Михаил'
Если хотя бы один из операторов, указанных в примере не будет существовать в базе данных, выполнение процедуры завершиться неудачей.
Изменение оператора
Для изменения параметров оператора используется процедура sp_update_operator, которая выглядит так:
sp_update_operator [@name =] 'name' [, [@new_name =] 'new_name'] [, [@enabled =] enabled] [, [@email_address =] 'email_address'] [, [@pager_address =] 'pager_number'] [, [@weekday_pager_start_time =] weekday_pager_start_time] [, [@weekday_pager_end_time =] weekday_pager_end_time] [, [@saturday_pager_start_time =] saturday_pager_start_time] [, [@saturday_pager_end_time =] saturday_pager_end_time] [, [@sunday_pager_start_time =] sunday_pager_start_time] [, [@sunday_pager_end_time =] sunday_pager_end_time] [, [@pager_days =] pager_days] [, [@netsend_address =] 'netsend_address'] [, [@category_name =] 'category']
Параметры процедуры изменения оператора такие же, как и при создании, поэтому не будем тратить время на рассмотрения оператора, а лучше посмотрим его работу на практике. Следующий пример изменяет e-mail и сетевой адрес:
exec sp_update_operator @name = 'Михаил', @email_address ='[SMTP:mikhail@mail.ru]', @netsend_address ='notebook'
Указание имени оператора является обязательным, потому что процедура должна знать, какого именно оператора нужно обновлять.
Следующий пример делает оператора не активным, после чего он не будет получать информационные сообщения:
exec sp_update_operator @name = 'Михаил', @enabled=0
Изменяется только параметр @enabled, а все остальные не изменяются и сохраняют свои значения.
Информация об операторе
Чтобы убедится в том, что изменения прошли успешно, можно воспользоваться процедурой sp_help_operator, которая выводит информацию об операторе. В качестве параметра @operator_name нужно передать имя интересующего вас оператора, например, так:
exec sp_help_operator @operator_name = 'Михаил'
Давайте снова сделаем Михаила активным, чтобы он мог получать информационные сообщения:
exec sp_update_operator @name = 'Михаил', @enabled=1
Удаление оператора
Для удаления оператора используется процедура sp_delete_operator, которая выглядит следующим образом:
sp_delete_operator [ @name = ] 'name' [ , [ @reassign_to_operator = ] 'reassign_operator' ]
Здесь всего два параметра:
- @name – имя удаляемого оператора;
- @reassign_to_operator – не обязательный параметр, где можно указать оператора, которому должны быть назначены события, отслеживаемые удаляемым оператором.
Следующий пример удаляет оператора Михаил, а все события, которые он отслеживал, будет теперь отслеживать Андрей:
EXEC sp_delete_operator @name = 'Михаил', @reassign_to_operator = 'Андрей'
3.5.3. Добавление шага
Мы научились создавать и удалять работу, а также добавлять операторов, но все это пока лишено смысла, ведь создаваемая работа еще ничего не умеет делать. Чтобы наделить смыслом предыдущие несколько страниц данной книги, необходимо научиться создавать шаги работы. Для этого используется процедура sp_add_jobstep. В общем виде процедура выглядит следующим образом:
sp_add_jobstep [ @job_id = ] job_id | [ @job_name = ] 'job_name' [ , [ @step_id = ] step_id ] < , [ @step_name = ] 'step_name' >[ , [ @subsystem = ] 'subsystem' ] [ , [ @command = ] 'command' ] [ , [ @additional_parameters = ] 'parameters' ] [ , [ @cmdexec_success_code = ] code ] [ , [ @on_success_action = ] success_action ] [ , [ @on_success_step_id = ] success_step_id ] [ , [ @on_fail_action = ] fail_action ] [ , [ @on_fail_step_id = ] fail_step_id ] [ , [ @server = ] 'server' ] [ , [ @database_name = ] 'database' ] [ , [ @database_user_name = ] 'user' ] [ , [ @retry_attempts = ] retry_attempts ] [ , [ @retry_interval = ] retry_interval ] [ , [ @os_run_priority = ] run_priority ] [ , [ @output_file_name = ] 'file_name' ] [ , [ @flags = ] flags ]
В первой строке указано, что процедуре необходимо указать или идентификатор или имя работы, которой нужно добавить новый шаг. Давайте рассмотрим параметры более подробно:
- @job_id – идентификатор работы, куда нужно добавить шаг;
- @job_name – имя работы, которой нужно добавить шаг;
- @step_id – автоматически увеличиваемое число, начиная с единицы. Если параметр не указан, то значение будет установлено автоматически (следующее за максимально существующим номером шага), т.е. шаг будет добавлен в конец цепочки шагов. Если у вас уже есть шаги с номерами 1, 2 и 3, и вы указали в параметре @step_id число 3, то новое значение будет вставлено на третью позицию, а шаг, который был на этом месте ранее, сместиться на четвертую. При этом, идентификаторы шагов будут перенумерованы автоматически;
- @step_name – имя шага;
- @subsystem – система команд, которые будут выполняться сервером на данном шаге. В этом параметре можно указать одно из следующих значений:
- ACTIVESCRIPTING – выполняться должен активный сценарий;
- CMDEXEC – на данном шаге будет выполняться команда ОС или внешняя программа;
- DISTRIBUTION – выполнение дистрибутора репликации;
- SNAPSHOT – выполнение агента репликации снятия снимка;
- LOGREADER – выполнение агента чтения журнала;
- MERGE – выполнение агента репликации смешивания (Merge);
- TSQL – шаг будет выполнять команду Transact-SQL (это значение по умолчанию).
- 1 – выход с сообщением об удачном завершении. Если работе установлен оператор, отслеживающий удачное завершение работы, то он получит соответствующее уведомление;
- 2 – выход с ошибкой. Иногда удачное выполнение команды является отрицательным результатом. Например, запрос может проверять наличие несвязанных строк. Если строки найдены, то по идее шаг должен вернуть положительный результат, но не связанные строки – это нарушение целостности. Поэтому можно указать, что при удачном выполнении сценария, необходимо завершить работу с ошибкой и проинформировать оператора, если он установлен;
- 3 – перейти к выполнению следующего оператора;
- 4 – перейти к выполнению шага, указанного в параметре @on_success_step_id.
- 0 – нет никаких дополнительных опций (это значение по умолчанию);
- 2 – результат выполнения должен добавляться в выходной файл, указанный в параметре @output_file_name;
- 4 – перезаписать выходной файл. Существующее содержимое будет уничтожено.
Давайте добавим в работу с именем ‘Тестовая работа 2’ два шага. На первом шаге будет удаляться таблица tbAndrey, а на втором, эта же таблица будет создаваться с помощью оператора SELECT INTO. Создание первого шага для решения данной задачи может выглядеть примерно следующим образом:
EXEC sp_add_jobstep @job_name = 'Тестовая работа 2', @step_name = 'Удаляем таблицу', @subsystem = 'TSQL', @command = 'DROP TABLE tbAndrey', @database_name = 'FlenovSQLBook', @on_success_action = 3, @on_fail_action = 3
Данный шаг будет выполнять команду Transact-SQL, а значит, в параметре @subsystem указываем значение ‘TSQL’. В параметре @command указываем непосредственно SQL команду. Так как по умолчанию запрос будет выполняться в базе данных master, то в параметре @database_name явно указываем свою базу.
Основанная задача работы – создать таблицу tbAndrey и заполнить значениями, но для этого сначала старую таблицу нужно удалить. А что если старой таблицы нет (ее кто-то удалил или вообще ее небыло)? В этом случае все равно работа должна продолжать выполняться, поэтому в параметрах @on_success_action и @on_fail_action указываем значение 3, то есть переход на следующий шаг.
Теперь создадим второй шаг, на котором будет производиться создание таблицы:
EXEC sp_add_jobstep @job_name = 'Тестовая работа 2', @step_name = 'Выбираем Андреев', @subsystem = 'TSQL', @command = 'SELECT * INTO tbAndrey FROM tbPeoples WHERE vcName=''Андрей''', @database_name = 'FlenovSQLBook', @on_success_action = 1, @on_fail_action = 2
В данном случае переход на следующий шаг не ожидается, поэтому завершаем работу с соответствующим кодом.
Когда вы пишете сценарий для работы, вы можете использовать некоторые вспомогательные конструкции, которые во время выполнения будут заменяться на определенные параметры. Во как сказал! Рассмотрим возможные конструкции, и на что они заменяются:
- [A-DBN] – заменяется именем базы данных;
- [A-SVR] – заменяется именем сервера;
- [A-ERR] – номер ошибки;
- [A-SEV] – критичность ошибки;
- [A-MSG] – заменяется текстовым сообщением;
- [DATE] – текущая дата;
- [JOBID] – идентификатор работы;
- [MACH] – имя компьютера;
- [MSSA] – имя сервиса SQLServerAgent;
- [SQLDIR] – директория, в которую установлен SQL сервер;
- [STEPCT] – сколько раз был запущена работа (количество попыток);
- [STEPID] – идентификатор шага;
- [TIME] – текущее время в формате HHMMSS;
- [STRTTM] — время в формате HHMMSS, когда работа была запущена;
- [STRTDT] – дата в формате YYYYMMDD когда работа была запущена.
Будьте внимательны, все конструкции должны заключаться в квадратные скобки, и все они чувствительны к регистру.
Давайте посмотрим, как использовать эти конструкции, а заодно увидим, как можно вставлять новые шаги. Следующим пример не добавляет новый шаг, а вставляет его на первую позицию (параметр @step_id равен 1):
EXEC sp_add_jobstep @job_name = 'Тестовая работа 2', @step_id=1, @step_name = 'Вставляем строку', @subsystem = 'TSQL', @command = 'INSERT INTO tbPeoples (vcName, vcSurname) VALUES(''[MACH]'', ''[STEPID]'')', @database_name = 'FlenovSQLBook', @on_success_action = 3, @on_fail_action = 3В данном примере, в качестве команды в таблицу tbPeoples вставляется строка, в которой имени назначается имя компьютера (конструкция [MACH]), а в качестве фамилии указывается текущий номер шага (конструкция [STEPID]).
Обратите внимание, что в параметре @command, в SQL запросе в параметре VALUES вставляемые в таблицу значения должны быть в одинарных кавычках, а мы указали по две одинарных с каждой стороны. Почему? Дело в том, что вся команда INSERT должна быть в одинарных кавычках:
@command='КОМАНДА'
Если внутри команды используется одинарная кавычка, то сервер воспримет ее как конец команды, и он станет преждевременным. Например:
@command = 'INSERT INTO tbPeoples (vcName, vcSurname) VALUES('[MACH]', '[STEPID]')'В данном случае, сервер поместит в параметр @command только строку:
@command = 'INSERT INTO tbPeoples (vcName, vcSurname) VALUES('Именно этот текст находиться между первыми двумя кавычками. Чтобы этого не произошло, внутри команды нужно продублировать все одинарные кавычки, что и происходит в примере выше.
Автоматически заменяемые во время выполнения конструкции действительно могут упростить разработку работ и иногда оказываются незаменимыми, особенно даты и время выполнения работы.
Давайте создадим еще один шаг, на котором будет выполняться системная команда, и при этом этот шаг мы вставим под номером 2:
EXEC sp_add_jobstep @job_name = 'Тестовая работа 2', @step_id=2, @step_name = 'Системная команда', @subsystem = 'CMDEXEC', @command = 'del c:\text.txt', @on_success_action = 3, @on_fail_action = 3
Так как будет выполняться системная команда, параметр @subsystem устанавливаем в CMDEXEC. В параметре @command для примера я указал команду удаления файла text.txt из корня диска С:. Когда вы будете тестировать пример (о том, как это сделать мы узнаем в разделе 3.5.5), не забудьте создать этот файл, чтобы убедиться в том, что файл после выполнения работы исчезает.
При выполнении системных команд вы должны учитывать следующее:
- Команды выполняются в контексте и с правами MS SQL Server. Это значит, что на экране не будет отображаться результат, даже если вы запускаете программу, которая должна что-то отображать на экране или должна иметь визуальный интерфейс. Чтобы убедиться в этом, можно в качестве системной команды указать calc (калькулятор). После запуска работы, вы ничего не увидите на экране;
- Не запускайте в качестве команды программы с визуальным интерфейсом. Такие программы не видны на экране, поэтому их невозможно будет закрыть, а значит, работа просто зависнет и не сможет завершить работу;
- Будьте аккуратны при задании команд, чтобы их выполнение было конечным, и не произошло зависания всей работы. Например, если задать команду ping -t localhost, то работа будет бесконечно пинговать локальный компьютер. Это приведет к зацикливанию шага и дальнейшее выполнение работы станет невозможным.