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


sp_help_jobcount (Transact-SQL)

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

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

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

См. также

Справочник

Хранимые процедуры агента SQL Server (Transact-SQL)

sp_add_schedule (Transact-SQL)

sp_attach_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_detach_schedule (Transact-SQL)