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


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 — включаются.

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

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