sp_help_jobserver (T-SQL)
Berlaku untuk: SQL Server
Mengembalikan informasi tentang server untuk pekerjaan tertentu.
Sintaks
sp_help_jobserver
[ [ @job_id = ] 'job_id' ]
[ , [ @job_name = ] N'job_name' ]
[ , [ @show_last_run_details = ] show_last_run_details ]
[ ; ]
Argumen
[ @job_id = ] 'job_id'
Nomor identifikasi pekerjaan untuk mengembalikan informasi. @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 yang akan mengembalikan informasi. @job_name adalah sysname, dengan default NULL
.
Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.
[ @show_last_run_details = ] show_last_run_details
Apakah informasi eksekusi yang terakhir dijalankan adalah bagian dari kumpulan hasil. @show_last_run_details kecil, dengan default 0
.
0
tidak menyertakan informasi yang terakhir dijalankan.1
termasuk informasi yang dijalankan terakhir.
Mengembalikan nilai kode
0
(berhasil) atau 1
(kegagalan).
Tataan hasil
Nama kolom | Jenis data | Deskripsi |
---|---|---|
server_id |
int | Nomor identifikasi server target. |
server_name |
nvarchar(30) | Nama komputer server target. |
enlist_date |
datetime | Tanggal server target yang terdaftar ke server master. |
last_poll_date |
datetime | Tanggal server target terakhir kali melakukan polling pada server master. |
Jika sp_help_jobserver
dijalankan dengan @show_last_run_details diatur ke 1
, kumpulan hasil memiliki kolom tambahan ini.
Nama kolom | Jenis data | Deskripsi |
---|---|---|
last_run_date |
int | Tanggal pekerjaan terakhir kali memulai eksekusi pada server target ini. |
last_run_time |
int | Waktu pekerjaan terakhir kali memulai eksekusi pada server ini. |
last_run_duration |
int | Durasi pekerjaan terakhir kali dijalankan di server target ini (dalam hitungan detik). |
last_outcome_message |
nvarchar(1024) | Menjelaskan hasil terakhir dari pekerjaan tersebut. |
last_run_outcome |
int | Hasil pekerjaan terakhir kali dijalankan di server ini:0 = Gagal1 = Berhasil3 = Dibatalkan5 = Tidak diketahui |
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 informasi untuk pekerjaan yang mereka miliki.
Contoh
Contoh berikut mengembalikan informasi, termasuk informasi yang dijalankan terakhir, tentang pekerjaan.NightlyBackups
USE msdb;
GO
EXEC dbo.sp_help_jobserver
@job_name = N'NightlyBackups',
@show_last_run_details = 1;
GO