Статья
04/01/2012

sp_help_jobserver (Transact-SQL)

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

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

Синтаксис

sp_help_jobserver
     { [ @job_id = ] job_id 
     | [ @job_name = ] 'job_name' }
     [ , [ @show_last_run_details = ] show_last_run_details ]

Аргументы

[ @job_id= ] job_id
Идентификационный номер задания, для которого возвращаются сведения. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.
[ @job_name= ] 'job_name'
Имя задания, для которого возвращаются сведения. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.

Примечание

Необходимо указать один из параметров job_id или job_name, но не оба одновременно.
[ @show_last_run_details= ] show_last_run_details
Включать ли сведения о выполнении последнего запуска в результирующий набор. Аргумент show_last_run_details имеет тип tinyint и значение по умолчанию 0. При значении 0 сведения о последнем запуске не включаются, а при 1 — включаются.

Примечание
Необходимо указать один из параметров job_id или job_name, но не оба одновременно.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

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

Если процедура sp_help_jobserver выполняется с параметром show_last_run_details, значение которого равно 1, результирующий набор будет содержать следующие дополнительные столбцы.

Имя столбца	Тип данных	Описание
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 = Неизвестно

Разрешения

По умолчанию эту хранимую процедуру могут выполнять члены предопределенной роли сервера sysadmin. Другим пользователям должна быть предоставлена одна из следующих предопределенных ролей базы данных агента 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

См. также

Справочник

sp_add_jobserver (Transact-SQL)

sp_delete_jobserver (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)

Share via