Bagikan melalui

sp_help_jobstep (T-SQL)

  • Artikel

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 = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

Argumen

[ @job_id = ] 'job_id'

Nomor identifikasi pekerjaan untuk mengembalikan informasi pekerjaan. @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. @job_name adalah sysname, dengan default NULL.

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 = ] N'step_name'

Nama langkah dalam pekerjaan. @step_name adalah sysname, dengan default NULL.

[ @suffix = ] akhiran

Bendera yang menunjukkan apakah deskripsi teks ditambahkan ke kolom bendera dalam output. @suffix adalah 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.
subsystem 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, nilai 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, nilai 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, nilai ini menunjukkan langkah berikutnya untuk dijalankan.
server nama sysname Dicadangkan.
database_name nama sysname Untuk langkah Transact-SQL, nilai ini adalah database tempat perintah dijalankan.
database_user_name nama sysname Untuk langkah Transact-SQL, nilai ini adalah konteks pengguna database tempat perintah dijalankan.
retry_attempts int Berapa 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 dalam msdb database.

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

Konten terkait