• Artykuł

sp_help_jobschedule (języka Transact-SQL)

Zwraca informacje o planowaniu zadań używane przez SQL Server Management Studio Wykonywanie zautomatyzowanych czynności.

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

Składnia

sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @schedule_name = ] 'schedule_name' ]
     [ , [ @schedule_id = ] schedule_id ]
     [ , [ @include_description = ] include_description ]

Argumenty

  • [ @job_id= ] job_id
    Numer identyfikacyjny zadanie .job_idjest uniqueidentifier, domyślna wartość NULL.

  • [ @job_name= ] 'job_name'
    Nazwa zadanie.job_namejest sysname, domyślna wartość NULL.

    Ostrzeżenie

    Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.

  • [ @ schedule_name= ] 'schedule_name"
    Nazwę element harmonogramu zadanie.schedule_namejest sysname, domyślna wartość NULL.

  • [ @schedule_id= ] schedule_id
    Numer identyfikacyjny harmonogramu element dla zadanie.schedule_idjest int, domyślna wartość NULL.

  • [ @ include_description= ] include_description
    Określa, czy dołączyć opis harmonogramu zestaw wyników.include_descriptionjest bit, domyślnie 0.Gdy include_description jest 0, opis harmonogramu nie jest uwzględniony w zestaw wyników.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

Nazwa kolumny

Typ danych

Opis

schedule_id

int

Planowanie numer identyfikatora.

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 = Uruchomione po SQLServerAgenturuchomieniuusł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, który jest pochodną wartości w msdb. dbo.sysschedules.Gdy include_description jest 0, ta kolumna zawiera tekst informujący nie żądano opis.

next_run_date

int

Data harmonogramu dalej spowoduje uruchomienie zadanie .

next_run_time

int

Czas harmonogramu dalej spowoduje uruchomienie zadanie .

schedule_uid

uniqueidentifier

Identyfikator harmonogramu.

job_count

int

Zwracana liczba zadań.

Ostrzeżenie

sp_help_jobschedule zwraca wartości z dbo.sysjobschedules i dbo.sysschedules tabele systemowe w msdb.sysjobschedules aktualizuje co 20 minut.Może to mieć wpływ na wartości, które są zwracane przez tę procedura składowana.

Uwagi

Parametry sp_help_jobschedule mogą być używane tylko w niektórych kombinacji.Jeśli schedule_id jest określony, ani job_id ani job_name można określić.W przeciwnym razie job_id lub job_name można użyć parametrów z schedule_name.

Uprawnienia

Wymaga członkostwa w sysadmin stała rola serwera.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 można tylko wyświetlać właściwości harmonogramów zadanie , których jest właścicielem.

Przykłady

A.Zwracanie harmonogram zadanie dla określonego zadanie

Poniższy przykład zwraca informacje dotyczące planowania dla zadanie o nazwie BackupDatabase.

USE msdb ;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'BackupDatabase' ;
GO

B.Zwracanie harmonogramu zadanie dla określonego harmonogramu

Poniższy przykład zwraca informacje dotyczące harmonogram o nazwie NightlyJobs i zadanie o nazwie RunReports.

USE msdb ;
GO

EXEC dbo.sp_help_jobschedule 
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs' ;
GO

C.Zwracanie harmonogram zadanie oraz opis harmonogramu dla określonego harmonogramu

Poniższy przykład zwraca informacje dotyczące harmonogram o nazwie NightlyJobs i zadanie o nazwie RunReports.zestaw wyników zwrócone zawiera opis harmonogramu.

USE msdb ;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs',
    @include_description = 1 ;
GO