sp_help_jobactivity (Transact-SQL)

Предоставляет данные о состоянии выполнения заданий агента SQL Server.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

        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

Состояние, возвращенное во время последнего выполнения задания:

0 = сбой;

1 = успешное выполнение;

3 = отменено;

5 = состояние неизвестно.

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