Menggunakan sp_help_schedule di SQL Server

Di SQL Server, sp_help_schedule prosedur tersimpan mengembalikan informasi tentang jadwal di agen SQL Server.

Artikel ini memberikan ikhtisar tentang prosedur tersimpan ini termasuk contohnya.

Sintaks

Sintaks resminya seperti ini:

sp_help_schedule   
     [ @schedule_id = ] id ,  
     [ @schedule_name = ] 'schedule_name'   
     [ , [ @attached_schedules_only = ] attached_schedules_only ]  
     [ , [ @include_description = ] include_description ]

Anda dapat menghubungi sp_help_schedule , dengan atau tanpa parameter.

Saat Anda memanggilnya tanpa parameter apa pun, ia mengembalikan daftar semua jadwal dalam instance.

Saat Anda memberikan nama atau ID jadwal, jadwal tersebut hanya mengembalikan jadwal tersebut.

Perhatikan bahwa sp_help_schedule ada di msdb database, sehingga perlu dijalankan dari sana. Anda dapat melakukannya dengan beralih ke msdb database (misalnya dengan USE msdb ), atau dengan mengkualifikasikan prosedur dengan nama dan skema database (yaitu msdb.dbo.sp_help_schedule ).

Contoh

Berikut adalah contoh untuk mendemonstrasikan cara mengembalikan semua jadwal dalam instance:

EXEC msdb.dbo.sp_help_schedule;

Hasil:

Mengembalikan Jadwal Berdasarkan Namanya

Anda juga bisa mendapatkan jadwal berdasarkan namanya:

EXEC msdb.dbo.sp_help_schedule
	@schedule_name = 'Weekly_Sun_3AM';

Mengembalikan Jadwal Berdasarkan ID-nya

Anda juga bisa mendapatkan jadwal berdasarkan ID-nya:

EXEC msdb.dbo.sp_help_schedule
	@schedule_id = 14;

Hanya Kembalikan Jadwal Terlampir

Meskipun sp_help_schedule tidak mengembalikan jadwal untuk pekerjaan tertentu (gunakan sp_help_jobschedule untuk itu), Anda dapat menggunakannya untuk mengembalikan hanya jadwal yang dilampirkan pada pekerjaan.

Anda dapat melakukannya dengan @attached_schedules_only parameter.

@attached_schedules_only parameternya adalah bit , dengan default 0 , yang berarti mengembalikan jadwal terlampir dan tidak terlampir. Melewati nilai 1 membatasinya hanya pada jadwal terlampir.

Contoh:

EXEC sp_help_schedule
	@attached_schedules_only = 1;

Sertakan Deskripsi

Hal lain yang dapat Anda lakukan adalah menentukan apakah akan menyertakan deskripsi jadwal atau tidak.

Secara default, deskripsi tidak disertakan dalam kumpulan hasil. Sebenarnya, schedule_description kolom adalah disertakan, tetapi tidak berisi deskripsi, kecuali jika Anda memintanya secara eksplisit. Jika Anda tidak memintanya, schedule_description kolom menampilkan (Description not requested.) .

@include_description parameternya adalah bit , dengan default 0 , yang berarti tidak menampilkan deskripsi. Melewati nilai 1 menghasilkan deskripsi yang ditampilkan.

EXEC sp_help_jobschedule
	@job_name = 'SqlAgentTest',
	@include_description = 1;