sp_help_schedule (Transact-SQL)
Применимо к:SQL Server
Возвращает информацию о расписаниях.
Соглашения о синтаксисе Transact-SQL
Синтаксис
sp_help_schedule
[ [ @schedule_id = ] schedule_id ]
[ , [ @schedule_name = ] N'schedule_name' ]
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
[ ; ]
Аргументы
[ @schedule_id = ] schedule_id
Идентификатор расписания, сведения о котором следует возвратить. @schedule_id имеет значение int с значением по умолчаниюNULL
.
Можно указать @schedule_id или @schedule_name.
[ @schedule_name = ] N'schedule_name'
Имя расписания, сведения о котором следует возвратить. @schedule_name — sysname с значением по умолчаниюNULL
.
Можно указать @schedule_id или @schedule_name.
[ @attached_schedules_only = ] attached_schedules_only
Этот аргумент указывает, следует ли возвратить информацию только о расписаниях, связанных с заданиями. @attached_schedules_only имеет значение по умолчанию0
. При @attached_schedules_only0
отображаются все расписания. Если @attached_schedules_only , 1
результирующий набор содержит только расписания, присоединенные к заданию.
[ @include_description = ] include_description
Этот аргумент указывает, следует ли включить в результирующий набор описания. @include_description бит с значением по умолчанию0
. Если @include_description, столбец @schedule_description 0
результирующий набор содержит заполнитель. При @include_description1
описание расписания включается в результирующий набор.
Значения кода возврата
0
(успешно) или 1
(сбой).
Результирующий набор
Данная процедура возвращает следующий результирующий набор:
Замечания
Если параметры отсутствуют, sp_help_schedule
выводится список сведений обо всех расписаниях в экземпляре.
Разрешения
Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE
разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.
Другим пользователям необходимо предоставить одну из следующих агент SQL Server предопределенных ролей базы данных в msdb
базе данных:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Дополнительные сведения о разрешениях этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.
Члены SQLAgentUserRole могут просматривать только собственные расписания.
Примеры
А. Список сведений обо всех расписаниях в экземпляре
Следующий пример выводит информацию о всех расписаниях в экземпляре.
USE msdb;
GO
EXEC dbo.sp_help_schedule;
GO
B. Перечисление сведений для определенного расписания
Следующий пример выводит информацию о расписании NightlyJobs
.
USE msdb;
GO
EXEC dbo.sp_help_schedule
@schedule_name = N'NightlyJobs';
GO
Связанный контент
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по