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