Udostępnij za pośrednictwem

  • Artykuł

sp_help_schedule (języka Transact-SQL)

Wyświetla informacje na temat harmonogramów.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

sp_help_schedule 
     [ @schedule_id = ] id ,
     [ @schedule_name = ] 'schedule_name' 
     [ , [ @attached_schedules_only = ] attached_schedules_only ]
     [ , [ @include_description = ] include_description ]

Argumenty

  • [ @ schedule_id = ] id
    Identyfikator harmonogramu do listy.schedule_namejest int, z braku domyślne.Albo schedule_id lub schedule_name może zostać określona.

  • [ @ schedule_name = ] 'schedule_name"
    Nazwa harmonogramu do listy.schedule_namejest sysname, z braku domyślne.Albo schedule_id lub schedule_name może zostać określona.

  • [ @ attached_schedules_only =] attached_schedules_only[]
    Określa, czy pokazać harmonogramów tylko, że zadanie jest dołączony do.attached_schedules_onlyjest bit, domyślnie 0.Gdy attached_schedules_only jest 0, wyświetlane są wszystkie harmonogramy.Gdy attached_schedules_only jest 1, zestaw wyników zawiera tylko harmonogramy, które są dołączone do zadanie.

  • [ @ include_description =] include_description
    Określa, czy należy dołączyć opisy, zestaw wyników.include_descriptionjest bit, domyślnie 0.Gdy include_description jest 0, schedule_description, zestaw wynikówkolumna zawiera symbol zastępczy. Gdy include_description jest 1, opis harmonogramu znajduje się w zestaw wyników.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

Procedura ta zwraca następujące zestaw wyników:

Nazwa kolumny

Typ danych

Opis

schedule_id

int

Planowanie numer identyfikatora.

schedule_uid

uniqueidentifier

Identyfikator harmonogramu.

schedule_name

sysname

Nazwa harmonogramu.

włączone

int

Czy harmonogram jest włączone (1) lub wyłączone (0).

freq_type

int

Wartość wskazująca, kiedy zadanie ma zostać wykonana.

1 = Raz

4 = Codziennie

8 = Co tydzień

16 = Co miesiąc

32 = Co miesiąc, w stosunku do freq_interval

64 = Uruchom po uruchomieniu SQLServerAgent usługa .

freq_interval

int

Dni po wykonaniu zadanie .Wartość zależy od wartości freq_type.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_subday_type

int

Jednostki dla freq_subday_interval.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_subday_interval

int

Liczba freq_subday_type okresów między każdym wykonanie zadanie.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_relative_interval

int

Zaplanowane zadaniewystępowania freq_interval w każdym miesiącu.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_recurrence_factor

int

Liczba miesięcy między planowane wykonanie zadanie.

active_start_date

int

Data harmonogram jest aktywny.

active_end_date

int

data zakończenia harmonogramu.

active_start_time

int

Godzina rozpoczęcia harmonogramu.

active_end_time

int

Kończy się czas harmonogram dzienny.

date_created

datetime

Data utworzenia harmonogramu.

schedule_description

nvarchar(4000)

Angielski opis harmonogramu (Jeśli wymagane).

job_count

int

Zwraca liczbę zadań odwołania tego harmonogramu.

Uwagi

Jeśli zostały podane żadne parametry, sp_help_schedule Wyświetla informacje dotyczące wszystkich harmonogramów w wystąpienie.

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera można wykonać tę procedura składowana.Inni użytkownicy muszą być przyznawane jedną z następujących SQL Server Agent ról stałej bazy danych w msdb bazy danych:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Szczegółowe informacje na temat uprawnień tych ról, zobacz Ról stałej bazy danych programu SQL Server Agent.

Członkowie SQLAgentUserRole mogą tylko przeglądać harmonogramy, których jest właścicielem.

Przykłady

A.Wyświetlanie informacji dla wszystkich harmonogramów w wystąpienie

Poniższy przykład wyświetla informacje dotyczące wszystkich harmonogramów w wystąpienie.

USE msdb ;
GO

EXEC dbo.sp_help_schedule ;
GO

B.Wyświetlanie informacji dla określonego harmonogramu

Poniższy przykład wyświetla informacje dotyczące harmonogram o nazwie NightlyJobs.

USE msdb ;
GO

EXEC dbo.sp_help_schedule
    @schedule_name = N'NightlyJobs' ;
GO