Поделиться через

sp_help_jobactivity (Transact-SQL)

  • Статья

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_help_jobactivity
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @session_id = ] session_id ]
[ ; ]

Аргументы

[ @job_id = ] 'job_id'

Идентификационный номер задания. @job_id является уникальным идентификатором по умолчаниюNULL.

Необходимо указать @job_id или @job_name, но их нельзя указать.

[ @job_name = ] N'job_name'

Имя задания. @job_name — sysname с значением по умолчаниюNULL.

Необходимо указать @job_id или @job_name, но их нельзя указать.

[ @session_id = ] session_id

Идентификатор сеанса для отправки сведений о ней. @session_id имеет значение int с значением по умолчаниюNULL.

Значения кода возврата

0 (успешно) или 1 (сбой).

Результирующий набор

Возвращает следующий результирующий набор.

Имя столбца Тип данных Description
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 не предоставляется, выводится список сведений для всех заданий.

Разрешения

Вы можете предоставить EXECUTE разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.

Другим пользователям необходимо предоставить одну из следующих агент SQL Server предопределенных ролей базы данных в msdb базе данных:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Дополнительные сведения о разрешениях этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.

Только члены sysadmin могут просматривать действия для заданий, принадлежащих другим пользователям.

Примеры

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

USE msdb;
GO

EXEC dbo.sp_help_jobactivity;
GO

Связанный контент