sp_help_jobserver (Transact-SQL)
Возвращает сведения о сервере, на котором выполняется заданное задание.
Применимо для следующих объектов: 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)