Udostępnij za pośrednictwem


sp_help_jobschedule (Transact-SQL)

Zwraca informacje o planowaniu zadań, używane przez SQL Server Management Studio do wykonywania automatycznych działań.

Topic link iconKonwencje składni języka Transact-SQL

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