sp_help_schedule (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mencantumkan informasi tentang jadwal.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @schedule_id = ] id Pengidentifikasi jadwal untuk dicantumkan. schedule_name int, tanpa default. Baik schedule_id atau schedule_name dapat ditentukan.

[ @schedule_name = ] 'schedule_name' Nama jadwal yang akan dicantumkan. schedule_name adalah sysname, tanpa default. Baik schedule_id atau schedule_name dapat ditentukan.

[ @attached_schedules_only = ] attached_schedules_only ]Menentukan apakah hanya menampilkan jadwal tempat pekerjaan dilampirkan. attached_schedules_only adalah bit, dengan default 0. Saat attached_schedules_only adalah 0, semua jadwal ditampilkan. Saat attached_schedules_only adalah 1, kumpulan hasil hanya berisi jadwal yang dilampirkan ke pekerjaan.

[ @include_description = ] include_description Menentukan apakah akan menyertakan deskripsi dalam tataan hasil. include_description adalah bit, dengan default 0. Saat include_description adalah 0, kolom schedule_description dari kumpulan hasil berisi tempat penampung. Saat include_description adalah 1, deskripsi jadwal disertakan dalam tataan hasil.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Tataan Hasil

Prosedur ini mengembalikan tataan hasil berikut:

Nama kolom Jenis data Deskripsi
schedule_id int Menjadwalkan nomor pengidentifikasi.
schedule_uid pengidentifikasi unik Pengidentifikasi untuk jadwal.
schedule_name nama sysname Nama jadwal.
diaktifkan 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 SQLServerAgent dimulai.
freq_interval int Hari ketika pekerjaan dijalankan. Nilai tergantung pada nilai freq_type. Untuk informasi selengkapnya, lihat sp_add_schedule (Transact-SQL).
freq_subday_type int Unit untuk freq_subday_interval. Untuk informasi selengkapnya, lihat sp_add_schedule (Transact-SQL).
freq_subday_interval int Jumlah periode freq_subday_type yang akan terjadi antara setiap eksekusi pekerjaan. Untuk informasi selengkapnya, lihat sp_add_schedule (Transact-SQL).
freq_relative_interval int Terjadinya pekerjaan terjadwal dari freq_interval dalam setiap bulan. Untuk informasi selengkapnya, lihat sp_add_schedule (Transact-SQL).
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 (jika diminta).
job_count int Mengembalikan berapa banyak pekerjaan yang mereferensikan jadwal ini.

Keterangan

Ketika tidak ada parameter yang disediakan, sp_help_schedule mencantumkan informasi untuk semua jadwal dalam instans.

Izin

Secara default, anggota peran server tetap sysadmin dapat menjalankan prosedur tersimpan ini. Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam database msdb :

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

Anggota SQLAgentUserRole hanya dapat melihat jadwal yang mereka miliki.

Contoh

J. Mencantumkan informasi untuk semua jadwal dalam instans

Contoh berikut mencantumkan informasi untuk semua jadwal dalam instans.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_schedule ;  
GO

B. Mencantumkan informasi untuk jadwal tertentu

Contoh berikut mencantumkan informasi untuk jadwal bernama NightlyJobs.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_schedule  
    @schedule_name = N'NightlyJobs' ;  
GO

Lihat Juga

sp_add_schedule (T-SQL)
sp_attach_schedule (T-SQL)
sp_delete_schedule (T-SQL)
sp_detach_schedule (T-SQL)