sp_help_jobserver (T-SQL)

Artikel
08/21/2023

Berlaku untuk:SQL Server

Mengembalikan informasi tentang server untuk pekerjaan tertentu.

Sintaks

  
sp_help_jobserver  
     { [ @job_id = ] job_id   
     | [ @job_name = ] '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.

[ @job_name = ] 'job_name' Nama pekerjaan yang akan mengembalikan informasi. job_name adalah sysname, dengan default NULL.

Catatan

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 dijalankan terakhir, dan 1 tidak.

Mengembalikan Nilai Kode

0 (keberhasilan) 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 = Gagal 1 = Berhasil 3 = Dibatalkan 5 = Tidak diketahui

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

Lihat Juga

sp_add_jobserver (T-SQL)
sp_delete_jobserver (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)