Bagikan melalui

sp_help_schedule (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mencantumkan informasi tentang jadwal.

Konvensi sintaks transact-SQL

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 = 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.
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

Konten terkait