Aracılığıyla paylaş

sp_help_jobschedule (Transact-SQL)

Şunlar için geçerlidir: SQL Server

SQL Server Management Studio tarafından otomatik faaliyetler gerçekleştirmek için kullanılan işlerin zamanlanması hakkında bilgi döndürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

sp_help_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

İş kimlik numarası. @job_iduniqueidentifier'dır ve varsayılan olarak ' NULLdir.

Ya @job_id ya da @job_name belirtilmelidir, ancak ikisi de belirtilemez.

[ @job_name = ] N'job_name'

İşin adı. @job_namesysname'dir ve varsayılan olarak .NULL

Ya @job_id ya da @job_name belirtilmelidir, ancak ikisi de belirtilemez.

[ @schedule_name = ] N'schedule_name'

İşin program maddesinin adı. @schedule_namesysname'dir ve varsayılan olarak ' NULLdir.

[ @schedule_id = ] schedule_id

İşin takvim maddesinin kimlik numarası. @schedule_idint, varsayılan olarak NULL.

[ @include_description = ] include_description

Sonuçlar kümesine takvim tanımının dahil edilip edilmeyeceğini belirtir. @include_descriptionbit'tir, varsayılan olarak .0

  • Ne 0olduğunda, program açıklaması sonuç setine dahil edilmez.
  • Eğer 1, program açıklaması sonuç kümesine dahil edilir.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Sütun adı Veri türü Description
schedule_id int Program tanımlayıcı numarası.
schedule_name sysname Zamanlamanın adı.
enabled int Programın etkinleştirilmiş (1) veya etkinleştirilmediği (0).
freq_type int Değer, işin ne zaman yapılacağını gösterir.

1 = Bir kez
4 = Günlük
8 = Haftalık
16 = Aylık
32 = Aylık, kıyasıyla freq_interval
64 = SQL Server Agent hizmeti başladığında çalıştırılır.
freq_interval int İşin yapıldığı günler. Değer, 'nin freq_typedeğerine bağlıdır. Daha fazla bilgi için bkz. sp_add_schedule.
freq_subday_type int için birimler freq_subday_interval. Daha fazla bilgi için bkz. sp_add_schedule.
freq_subday_interval int İşin her yürütülmesi arasında gerçekleşecek dönem freq_subday_type sayısı. Daha fazla bilgi için bkz. sp_add_schedule.
freq_relative_interval int Her ay planlanmış işin gerçekleşmesi freq_interval . Daha fazla bilgi için bkz. sp_add_schedule.
freq_recurrence_factor int İşin planlanan uygulaması arasındaki ay sayısı.
active_start_date int Programın aktif olduğu tarih.
active_end_date int Programın bitiş tarihi.
active_start_time int Programın başladığı saat.
active_end_time int Günün saati programı sona eriyor.
date_created datetime Programın oluşturulma tarihi.
schedule_description nvarchar(4000) Çizelgedeki değerlerden msdb.dbo.sysschedulestüretilen İngilizce bir çizelge tanımı. @include_description0olduğunda, bu sütunda açıklamanın istenmediğini belirten metin bulunur.
next_run_date int Bir sonraki çalışma tarihini çiz.
next_run_time int Takvim bir sonraki işin başlamasına neden olur.
schedule_uid uniqueidentifier Takvim için tanımlayıcı.
job_count int Geri dönen işlerin sayısı.

Uyarı

sp_help_jobschedule ve sistem tablolarından dbo.sysjobschedulesdbo.sysschedulesmsdb.sysjobschedules her 20 dakikada bir güncellemeler halinde değer döndürür. Bu, bu depolanmış prosedürün döndürülen değerlerini etkileyebilir.

Açıklamalar

Parametreleri sp_help_jobschedule yalnızca belirli kombinasyonlarda kullanılabilir. Eğer @schedule_id belirtiliyorsa, @job_id ve @job_name belirtilemez. Aksi takdirde, @job_id veya @job_name parametreleri @schedule_name ile kullanılabilir.

Permissions

EXECUTE Bu prosedür üzerinde izinler verebilirsiniz, ancak bu izinler SQL Server yükseltmesi sırasında geçersiz kalabilir.

Diğer kullanıcılara, veritabanındaki aşağıdaki sabit veritabanı rollerinden birine msdb sahip olmalıdır:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Bu rollerin izinleri hakkında detaylar için SQL Server Agent Fixed Database Roles bölümüne bakınız.

SQLAgentUserRole üyeleri yalnızca sahip oldukları iş takvilerinin özelliklerini görebilir.

Örnekler

A. Belirli bir iş için iş programını geri gönderin

Aşağıdaki örnek, ' adlı BackupDatabasebir iş için zamanlama bilgilerini geri döner.

USE msdb;
GO

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

B. İş programını belirli bir program için geri gönderin

Aşağıdaki örnek, adlanan NightlyJobs ve adlanan iş RunReportsiçin bilgileri geri döner.

USE msdb;
GO

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

C. Belirli bir program için iş programını ve program tanımını geri gönderin

Aşağıdaki örnek, adlanan NightlyJobs ve adlanan iş RunReportsiçin bilgileri geri döner. Geri dönen sonuç kümesi, takvimin bir açıklamasını içerir.

USE msdb;
GO

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

İlgili içerik

  • Last updated on