sp_help_jobschedule (Transact-SQL)
Zwraca informacje o planowaniu zadań, używane przez SQL Server Management Studio do wykonywania automatycznych działań.
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
The job identification number.job_idis uniqueidentifier, with a default of NULL.[ @job_name= ] 'job_name'
The name of the job.job_nameis sysname, with a default of NULL.Uwaga
Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.
[ @schedule_name= ] 'schedule_name'
The name of the schedule item for the job.schedule_nameis sysname, with a default of NULL.[ @schedule_id= ] schedule_id
The identification number of the schedule item for the job.schedule_idis int, with a default of NULL.[ @include_description= ] include_description
Specifies whether to include the description of the schedule in the result set.include_description is bit, with a default of 0.Kiedy include_description jest 0, opis harmonogramu nie znajduje się zestaw wyników.Kiedy include_description jest 1, opis harmonogramu znajduje się zestaw wyników.
Wartości kodów powrotnych
0 (sukces) lub 1 (brak)
Zestawy wyników
Nazwa kolumna |
Typ danych |
Description |
---|---|---|
schedule_id |
int |
Planowanie numer identyfikacyjny. |
schedule_name |
sysname |
Nazwa arkusza. |
włączone |
int |
Określa, czy w harmonogramie włączone)1) lub nie jest włączony (0). |
freq_type |
int |
Wartość wskazująca, kiedy zadanie ma zostać wykonana. 1 = Once 4 = Daily 8 = Weekly 16 = Monthly 32 = Monthly, relative to the freq_interval 64 = Run when SQLServerAgent usługa jest uruchamiana. |
freq_interval |
int |
Dni po wykonaniu zadanie.Wartość zależy od wartości freq_type.Aby uzyskać więcej informacji zobaczsp_add_schedule (języka Transact-SQL). |
freq_subday_type |
int |
Jednostki freq_subday_interval.Aby uzyskać więcej informacji zobaczsp_add_schedule (języka Transact-SQL). |
freq_subday_interval |
int |
Liczba freq_subday_type okresy występuje między wykonanie każdego zadanie.Aby uzyskać więcej informacji zobaczsp_add_schedule (języka Transact-SQL). |
freq_relative_interval |
int |
Wystąpienie zadanie zaplanowane freq_interval w każdym miesiącu.Aby uzyskać więcej informacji zobaczsp_add_schedule (języka Transact-SQL). |
freq_recurrence_factor |
int |
Liczba miesięcy między wykonywania zaplanowanego zadanie. |
active_start_date |
int |
Data harmonogram jest aktywny. |
active_end_date |
int |
Data zakończenia w harmonogramie. |
active_start_time |
int |
czas dnia uruchamia się w harmonogramie. |
active_end_time |
int |
Kończy się czas w harmonogramie na dzień. |
date_created |
datetime |
Data jest tworzony w harmonogramie. |
schedule_description |
nvarchar(4000) |
Angielski temat harmonogram, który jest określany na podstawie wartości w msdb.dbo.sysschedules.Kiedy include_description jest 0, ta kolumna zawierała tekst informujący, że opis nie żądano. |
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ń. |
Uwaga
sp_help_jobschedule returns values from the dbo.sysjobschedules and dbo.sysschedules system tables in msdb.sysjobschedules updates every 20 minutes.Może to mieć wpływ na wartości, które są zwracane przez tę procedura przechowywana.
Remarks
Parametry sp_help_jobschedule można użyć tylko w niektórych kombinacji.Jeśli schedule_id jest określony, ani job_id ani job_name może być określony. W przeciwnym razie job_id lub job_name można użyć parametrów z schedule_name.
Uprawnienia
Członkostwo w grupie wymaga sysadmin stała rola serwera.Inni użytkownicy klastrowa musi mieć jedną z następujących czynności SQL Server Agent stałe role bazy danych w msdb bazy danych:
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Aby uzyskać szczegółowe informacje o uprawnieniach z tych ról zobacz SQL Server Agent Fixed Database Roles.
Członkowie SQLAgentUserRole można przeglądać tylko właściwości zadanie harmonogramy, których jest właścicielem.
Przykłady
A.Zwracanie Planowanie zadań dla określonego zadanie
W poniższym przykładzie są zwracane informacji dotyczących planowania dla zadanie o nazwie BackupDatabase.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'BackupDatabase' ;
GO
B.Zwracanie zadanie harmonogramu dla określonego planu
W poniższym przykładzie zwraca informacje o nazwie harmonogramu 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 Planowanie zadań oraz opis harmonogramu dla określonego planu
W poniższym przykładzie zwraca informacje o nazwie harmonogramu NightlyJobs i zadanie, o nazwie RunReports. Zwracany zestaw wyników zawiera opis harmonogramu.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs',
@include_description = 1 ;
GO