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

sp_help_jobserver (Transact-SQL)

  • Статья

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

Возвращает сведения о сервере, на котором выполняется заданное задание.

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

Синтаксис

sp_help_jobserver
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @show_last_run_details = ] show_last_run_details ]
[ ; ]

Аргументы

[ @job_id = ] 'job_id'

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

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

[ @job_name = ] N'job_name'

Имя задания, для которого возвращаются сведения. @job_name — sysname с значением по умолчаниюNULL.

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

[ @show_last_run_details = ] show_last_run_details

Является ли информация о выполнении последнего запуска частью результирующий набор. @show_last_run_details имеет крошечный размер с значением по умолчанию0.

  • 0 не включает сведения о последнем запуске.
  • 1 содержит сведения о последнем запуске.

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

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

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

Имя столбца Тип данных Description
server_id int Идентификационный номер целевого сервера.
server_name nvarchar(30) Имя компьютера целевого сервера.
enlist_date datetime Дата прикрепления целевого сервера к главному серверу.
last_poll_date datetime Дата последнего опроса главного сервера целевым сервером.

Если sp_help_jobserver задано значение @show_last_run_details1, результирующий набор содержит эти дополнительные столбцы.

Имя столбца Тип данных Description
last_run_date int Дата последнего запуска задания на выполнение на данном целевом сервере.
last_run_time int Время выполнения последнего запуска задания на данном целевом сервере.
last_run_duration int Продолжительность задания при последнем его выполнении на целевом сервере (в секундах).
last_outcome_message nvarchar(1024) Описание последнего результата задания.
last_run_outcome int Результат последнего выполнения задания на данном сервере:

0 = сбой
1 = успешно выполнено
3 = отменено
5 = неизвестно

Разрешения

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

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

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

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

Примеры

В следующем примере возвращаются сведения о задании NightlyBackups, включая данные о последнем запуске.

USE msdb;
GO

EXEC dbo.sp_help_jobserver
    @job_name = N'NightlyBackups',
    @show_last_run_details = 1;
GO

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