Share via

  • Статья

sp_help_jobcount (Transact-SQL)

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

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

Синтаксис

sp_help_jobcount 
     [ @schedule_name = ] 'schedule_name' ,
     [ @schedule_id = ] schedule_id

Аргументы

  • [ @schedule_id= ] schedule_id
    Идентификатор расписания для занесения в список. Аргумент schedule_id имеет тип int и не имеет значения по умолчанию. Можно указать либо аргумент schedule_id, либо аргумент schedule_name.

  • [ @schedule_name= ] 'schedule_name'
    Идентификатор расписания для занесения в список. Аргумент schedule_name имеет тип sysname и не имеет значения по умолчанию. Можно указать либо аргумент schedule_id, либо аргумент schedule_name.

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

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

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

Возвращает следующий результирующий набор:

Имя столбца

Тип данных

Описание

JobCount

int

Количество заданий в указанном расписании.

Замечания

Эта процедура возвращает количество заданий, связанных с указанным расписанием.

Разрешения

По умолчанию члены предопределенной роли сервера sysadmin могут выполнять эту хранимую процедуру. Другим пользователям должна быть предоставлена одна из следующих предопределенных ролей базы данных агента SQL Server в базе данных msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Подробные сведения о разрешениях для этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.

Только члены роли sysadmin могут просматривать количество заданий других владельцев.

Примеры

Следующий пример возвращает количество заданий, связанных с расписанием NightlyJobs.

USE msdb ;
GO

EXEC sp_help_jobcount
    @schedule_name = N'NightlyJobs' ;
GO