Bagikan melalui


sp_help_jobsteplog (T-SQL)

Berlaku untuk: SQL Server

Mengembalikan metadata tentang log langkah pekerjaan SQL Server Agent tertentu. sp_help_jobsteplog tidak mengembalikan log aktual.

Konvensi sintaks transact-SQL

Sintaks

sp_help_jobsteplog
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
[ ; ]

Argumen

[ @job_id = ] 'job_id'

Nomor identifikasi pekerjaan untuk mengembalikan informasi log langkah 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.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Nama kolom Jenis data Deskripsi
job_id pengidentifikasi unik Pengidentifikasi unik pekerjaan.
job_name nama sysname Nama pekerjaan.
step_id int Pengidentifikasi untuk langkah dalam pekerjaan. Misalnya, jika langkahnya adalah langkah pertama dalam pekerjaan, itu step_id adalah 1.
step_name nama sysname Nama langkah dalam pekerjaan.
step_uid pengidentifikasi unik Pengidentifikasi unik langkah (sistem yang dihasilkan) dalam pekerjaan.
date_created datetime Tanggal langkah dibuat.
date_modified datetime Tanggal saat langkah terakhir diubah.
log_size float Ukuran log langkah pekerjaan, dalam megabyte (MB).
log nvarchar(maks) Output log langkah pekerjaan.

Keterangan

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

Contoh

J. Mengembalikan informasi log langkah pekerjaan untuk semua langkah dalam pekerjaan tertentu

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

USE msdb;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup';
GO

B. Mengembalikan informasi log langkah pekerjaan tentang langkah pekerjaan tertentu

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

USE msdb;
GO

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