Bagikan melalui

sp_help_jobschedule (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

Mengembalikan informasi tentang penjadwalan pekerjaan yang digunakan oleh SQL Server Management Studio untuk melakukan aktivitas otomatis.

Konvensi sintaks transact-SQL

Sintaks

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 ]
[ ; ]

Argumen

[ @job_id = ] 'job_id'

Nomor identifikasi pekerjaan. @job_id adalah uniqueidentifier, dengan default NULL.

Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.

[ @job_name = ] N'job_name'

Nama pekerjaan. @job_name adalah sysname, dengan default NULL.

Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.

[ @schedule_name = ] N'schedule_name'

Nama item jadwal untuk pekerjaan tersebut. @schedule_name adalah sysname, dengan default NULL.

[ @schedule_id = ] schedule_id

Nomor identifikasi item jadwal untuk pekerjaan tersebut. @schedule_id int, dengan default NULL.

[ @include_description = ] include_description

Menentukan apakah akan menyertakan deskripsi jadwal dalam tataan hasil. @include_description adalah bit, dengan default .0

  • Ketika 0, deskripsi jadwal tidak disertakan dalam tataan hasil.
  • Ketika 1, deskripsi jadwal disertakan dalam tataan hasil.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Nama kolom Jenis data Deskripsi
schedule_id int Menjadwalkan nomor pengidentifikasi.
schedule_name nama sysname Nama jadwal.
enabled int Apakah jadwal diaktifkan (1) atau tidak diaktifkan (0).
freq_type int Nilai yang menunjukkan kapan pekerjaan akan dijalankan.

1 = Sekali
4 = Harian
8 = Mingguan
16 = Bulanan
32 = Bulanan, relatif terhadap freq_interval
64 = Jalankan saat layanan SQL Server Agent dimulai.
freq_interval int Hari ketika pekerjaan dijalankan. Nilai tergantung pada nilai freq_type. Untuk informasi selengkapnya, lihat sp_add_schedule.
freq_subday_type int Unit untuk freq_subday_interval. Untuk informasi selengkapnya, lihat sp_add_schedule.
freq_subday_interval int Jumlah freq_subday_type periode yang akan terjadi antara setiap eksekusi pekerjaan. Untuk informasi selengkapnya, lihat sp_add_schedule.
freq_relative_interval int Kemunculan freq_interval pekerjaan terjadwal dalam setiap bulan. Untuk informasi selengkapnya, lihat sp_add_schedule.
freq_recurrence_factor int Jumlah bulan antara eksekusi pekerjaan yang dijadwalkan.
active_start_date int Tanggal jadwal diaktifkan.
active_end_date int Tanggal akhir jadwal.
active_start_time int Waktu hari jadwal dimulai.
active_end_time int Waktu jadwal hari berakhir.
date_created datetime Tanggal jadwal dibuat.
schedule_description nvarchar(4000) Deskripsi bahasa Inggris tentang jadwal yang berasal dari nilai di msdb.dbo.sysschedules. Saat @include_description adalah 0, kolom ini berisi teks yang menyatakan bahwa deskripsi tidak diminta.
next_run_date int Tanggal jadwal berikutnya menyebabkan pekerjaan berjalan.
next_run_time int Waktu jadwal berikutnya menyebabkan pekerjaan berjalan.
schedule_uid pengidentifikasi unik Pengidentifikasi untuk jadwal.
job_count int Jumlah pekerjaan yang dikembalikan.

Catatan

sp_help_jobschedule mengembalikan nilai dari dbo.sysjobschedules tabel sistem dan dbo.sysschedules dalam msdb.sysjobschedules pembaruan setiap 20 menit. Ini mungkin memengaruhi nilai yang dikembalikan oleh prosedur tersimpan ini.

Keterangan

Parameter sp_help_jobschedule hanya dapat digunakan dalam kombinasi tertentu. Jika @schedule_id ditentukan, @job_id dan @job_name tidak dapat ditentukan. Jika tidak, parameter @job_id atau @job_name dapat digunakan dengan @schedule_name.

Izin

Prosedur tersimpan ini dimiliki oleh peran db_owner . Anda dapat memberikan EXECUTE izin untuk pengguna mana pun, tetapi izin ini dapat ditimpa selama peningkatan SQL Server.

Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam msdb database:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Untuk detail tentang izin peran ini, lihat Peran Database Tetap Agen SQL Server.

Anggota SQLAgentUserRole hanya dapat melihat properti jadwal pekerjaan yang mereka miliki.

Contoh

J. Mengembalikan jadwal pekerjaan untuk pekerjaan tertentu

Contoh berikut mengembalikan informasi penjadwalan untuk pekerjaan bernama BackupDatabase.

USE msdb;
GO

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

B. Mengembalikan jadwal pekerjaan untuk jadwal tertentu

Contoh berikut mengembalikan informasi untuk jadwal bernama NightlyJobs dan pekerjaan bernama RunReports.

USE msdb;
GO

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

C. Mengembalikan jadwal pekerjaan dan menjadwalkan deskripsi untuk jadwal tertentu

Contoh berikut mengembalikan informasi untuk jadwal bernama NightlyJobs dan pekerjaan bernama RunReports. Kumpulan hasil yang dikembalikan mencakup deskripsi jadwal.

USE msdb;
GO

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

Konten terkait