sp_help_jobserver (Transact-SQL)

Статья
03/07/2014

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

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

Значок ссылки на раздел Cинтаксические обозначения в 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 — включаются.

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

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)

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