sp_help_jobactivity (Transact-SQL)
Предоставляет данные о состоянии выполнения заданий агента SQL Server.
Синтаксис
sp_help_jobactivity { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
[ , [ @session_id = ] session_id ]
Аргументы
- [ @job_id =] job_id
Идентификационный номер задания. Аргумент job_idимеет тип uniqueidentifier и значение по умолчанию NULL.
[ @job_name =] 'job_name'
Имя задания. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.Примечание. Необходимо задать либо аргумент job_id, либо аргумент job_name, но не оба аргумента сразу.
- [ @session_id = ] session_id
Идентификатор сеанса, о котором предоставляются данные. Аргумент session_id имеет тип int и значение по умолчанию NULL.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
Возвращает следующий набор результатов:
Имя столбца | Тип данных | Описание |
---|---|---|
session_id |
int |
Идентификационный номер сеанса агента. |
job_id |
uniqueidentifier |
Идентификатор задания. |
job_name |
sysname |
Имя задания. |
run_requested_date |
datetime |
Дата, указанная в запросе для запуска задания. |
run_requested_source |
sysname |
Источник запроса на выполнение задания. Может принимать одно из следующих значений: 1 = запуск по расписанию 2 = запуск в ответ на оповещение 3 = запуск после начальной загрузки сервера 4 = запуск пользователем 6 = запуск по расписанию бездействия процессора |
queued_date |
datetime |
Когда запрос был поставлен в очередь. NULL, если задание было запущено непосредственно. |
start_execution_date |
datetime |
Когда задание было назначено потоку, готовому к запуску. |
last_executed_step_id |
int |
Идентификатор последнего выполненного шага задания. |
last_exectued_step_date |
datetime |
Время начала последнего выполненного шага задания. |
stop_execution_date |
datetime |
Время окончания выполнения задания. |
next_scheduled_run_date |
datetime |
Время следующего выполнения задания по расписанию. |
job_history_id |
int |
Идентификатор журнала задания в таблице журналов заданий. |
message |
nvarchar(1024) |
Сообщение, сформированное во время последнего выполнения задания. |
run_status |
int |
Состояние, возвращенное во время последнего выполнения задания. |
operator_id_emailed |
int |
Идентификационный номер оператора, которому по электронной почте было послано оповещение об окончании задания. |
operator_id_netsent |
int |
Идентификационный номер оператора, которому командой net send было послано оповещение об окончании задания. |
operator_id_paged |
int |
Идентификационный номер оператора, которому по пейджеру было послано оповещение об окончании задания. |
Замечания
Эта хранимая процедура создает моментальный снимок текущего состояния выполняющихся заданий. Возвращаемые результаты представляют собой данные на момент выполнения запроса.
Агент SQL Server создает идентификатор сеанса каждый раз, когда запускается служба агента. Идентификатор сеанса хранится в таблице msdb.dbo.syssessions.
Если аргумент session_id не предоставлен, выдается сведения обо всех сеансах.
Если не заданы ни аргумент job_name, ни аргумент job_id, выдаются сведения обо всех заданиях.
Разрешения
По умолчанию эту хранимую процедуру могут выполнять члены фиксированной серверной роли sysadmin. Другим пользователям должно быть предоставлено членство в одной из следующих фиксированных ролей базы данных агента SQL Server в базе данных msdb:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Сведения о разрешениях для этих ролей см. в разделе Фиксированные роли базы данных агента SQL Server.
Просмотр состояния заданий, принадлежащих другим пользователям, могут выполнять только члены роли sysadmin.
Примеры
В следующем примере предоставляются сведения о состоянии всех заданий, на просмотр которых текущий пользователь имеет разрешение.
USE msdb ;
GO
EXEC dbo.sp_help_jobactivity ;
GO