sp_help_schedule (T-SQL)
Berlaku untuk: SQL Server
Mencantumkan informasi tentang jadwal.
Sintaks
sp_help_schedule
[ [ @schedule_id = ] schedule_id ]
[ , [ @schedule_name = ] N'schedule_name' ]
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
[ ; ]
Argumen
[ @schedule_id = ] schedule_id
Pengidentifikasi jadwal untuk dicantumkan. @schedule_id int, dengan default NULL
.
Baik @schedule_id atau @schedule_name dapat ditentukan.
[ @schedule_name = ] N'schedule_name'
Nama jadwal yang akan dicantumkan. @schedule_name adalah sysname, dengan default NULL
.
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. |
enabled |
int | Apakah jadwal diaktifkan (1 ) atau tidak diaktifkan (0 ). |
freq_type |
int | Nilai yang menunjukkan kapan pekerjaan akan dijalankan.1 = Sekali4 = Harian8 = Mingguan16 = Bulanan32 = 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. |
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 (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
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 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