sp_help_jobstep (T-SQL)

Berlaku untuk:SQL Server

Mengembalikan informasi untuk langkah-langkah dalam pekerjaan yang digunakan oleh layanan SQL Server Agent untuk melakukan aktivitas otomatis.

Konvensi sintaks transact-SQL

Sintaks

  
sp_help_jobstep { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }  
     [ , [ @step_id = ] step_id ]   
     [ , [ @step_name = ] 'step_name' ]   
     [ , [ @suffix = ] suffix ]   

Argumen

[ @job_id = ] 'job_id' Nomor identifikasi pekerjaan untuk mengembalikan informasi pekerjaan. job_id adalah uniqueidentifier, dengan default NULL.

[ @job_name = ] 'job_name' Nama pekerjaan. job_name adalah sysname, dengan NULL default.

Catatan

Baik job_id atau job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.

[ @step_id = ] step_id Nomor identifikasi langkah dalam pekerjaan. Jika tidak disertakan, semua langkah dalam pekerjaan disertakan. step_id int, dengan default NULL.

[ @step_name = ] 'step_name' Nama langkah dalam pekerjaan. step_name adalah sysname, dengan default NULL.

[ @suffix = ] suffix Bendera yang menunjukkan apakah deskripsi teks ditambahkan ke kolom bendera dalam output. akhiranadalah bit, dengan default 0. Jika akhiran adalah 1, deskripsi ditambahkan.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Tataan Hasil

Nama kolom	Jenis data	Deskripsi
step_id	int	Pengidentifikasi unik untuk langkah tersebut.
step_name	nama sysname	Nama langkah dalam pekerjaan.
Subsistem	nvarchar(40)	Subsistem untuk menjalankan perintah langkah.
command	nvarchar(maks)	Perintah dijalankan dalam langkah .
flags	int	Bitmask nilai yang mengontrol perilaku langkah.
cmdexec_success_code	int	Untuk langkah CmdExec, ini adalah kode keluar proses dari perintah yang berhasil.
on_success_action	kecil	Tindakan yang harus diambil jika langkah tersebut berhasil: 1 = Keluar dari keberhasilan pelaporan pekerjaan. 2 = Keluar dari kegagalan pelaporan pekerjaan. 3 = Buka langkah berikutnya. 4 = Buka langkah.
on_success_step_id	int	Jika on_success_action adalah 4, ini menunjukkan langkah berikutnya untuk dijalankan.
on_fail_action	kecil	Apa yang harus dilakukan jika langkah gagal. Nilai sama dengan on_success_action.
on_fail_step_id	int	Jika on_fail_action adalah 4, ini menunjukkan langkah berikutnya untuk dijalankan.
server	nama sysname	Dicadangkan.
database_name	nama sysname	Untuk langkah Transact-SQL, ini adalah database tempat perintah dijalankan.
database_user_name	nama sysname	Untuk langkah Transact-SQL, ini adalah konteks pengguna database tempat perintah dijalankan.
retry_attempts	int	Jumlah maksimum kali perintah harus dicoba ulang (jika tidak berhasil).
retry_interval	int	Interval (dalam menit) untuk setiap upaya coba lagi.
os_run_priority	int	Dicadangkan.
output_file_name	nvarchar(200)	File yang output perintahnya harus ditulis (langkah-langkah Transact-SQL, CmdExec, dan PowerShell saja).
last_run_outcome	int	Hasil langkah terakhir kali dijalankan: 0 = Gagal 1 = Berhasil 2 = Coba lagi 3 = Dibatalkan 5 = Tidak diketahui
last_run_duration	int	Durasi (hhmmss) dari langkah terakhir kali dijalankan.
last_run_retries	int	Berapa kali perintah dicoba kembali terakhir kali langkah dijalankan.
last_run_date	int	Tanggal langkah terakhir memulai eksekusi.
last_run_time	int	Waktu langkah terakhir memulai eksekusi.
proxy_id	int	Proksi untuk langkah pekerjaan.

Keterangan

sp_help_jobstep ada di database msdb.

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 langkah-langkah pekerjaan untuk pekerjaan yang mereka miliki.

Contoh

J. Mengembalikan informasi untuk semua langkah dalam pekerjaan tertentu

Contoh berikut mengembalikan semua langkah pekerjaan untuk pekerjaan bernama Weekly Sales Data Backup.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobstep  
    @job_name = N'Weekly Sales Data Backup' ;  
GO  

B. Mengembalikan informasi tentang langkah pekerjaan tertentu

Contoh berikut mengembalikan informasi tentang langkah pekerjaan pertama untuk pekerjaan bernama Weekly Sales Data Backup.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_id = 1 ;  
GO  

Lihat Juga

sp_add_jobstep (T-SQL)
sp_delete_jobstep (T-SQL)
sp_help_job (T-SQL)
sp_update_jobstep (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)