sp_help_jobserver (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)