Aracılığıyla paylaş

sp_help_jobstep (Transact-SQL)

Şunlar için geçerlidir: SQL Server

SQL Server Agent servisinin otomatik faaliyetleri gerçekleştirmek için kullandığı bir işteki adımlar için bilgi döndürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

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

Arguments

[ @job_id = ] 'job_id'

İş bilgilerini iade etmek için iş kimlik numarası. @job_iduniqueidentifier'dır ve varsayılan olarak ' NULLdir.

Ya @job_id ya da @job_name belirtilmelidir, ancak ikisi de belirtilemez.

[ @job_name = ] N'job_name'

İşin adı. @job_namesysname'dir ve varsayılan olarak .NULL

Ya @job_id ya da @job_name belirtilmelidir, ancak ikisi de belirtilemez.

[ @step_id = ] step_id

İşin adım numarası. Dahil edilmediyse, işin tüm adımları dahil edilir. @step_idint, varsayılan olarak .NULL

[ @step_name = ] N'step_name'

İşin adımının adı. @step_namesysname'dir, varsayılan NULLolarak .

[ @suffix = ] eki

Çıktıdaki bayrak sütununa metin açıklamasının eklenmiş olup olmadığını gösteren bir bayrak. @suffixbit'tir, varsayılan olarak .0 Eğer @sek eki 1ise, bir açıklama eklenir.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Sütun adı Veri türü Description
step_id int Adım için benzersiz tanımlayıcı.
step_name sysname İşin adımının adı.
subsystem nvarchar(40) Adım komutunun yürütüleceği alt sistem.
command nvarchar(max) Komut adımda uygulandı.
flags int Adım davranışını kontrol eden bir değer maskesi.
cmdexec_success_code int Bir CmdExec adımı için, bu değer başarılı bir komutun süreç çıkış kodudur.
on_success_action tinyint Adım başarılı olursa yapılacak önlemler:

1 = İşi başarı haberinden bırak.
2 = İşi rapor etmeyi bırakın.
3 = Bir sonraki adıma geç.
4 = Adım at.
on_success_step_id int Eğer on_success_action 4 ise, bu değer bir sonraki adımı gösterir.
on_fail_action tinyint Adım başarısız olursa ne yapılmalı. Değerler ile on_success_actionaynıdır.
on_fail_step_id int Eğer on_fail_action ise 4, bu değer bir sonraki yürütülecek adımı gösterir.
server sysname Rezerve edilmiş.
database_name sysname Transact-SQL adım için, bu değer komutun çalıştığı veritabanıdır.
database_user_name sysname Transact-SQL adım için, bu değer komutun çalıştığı veritabanı kullanıcı bağlamıdır.
retry_attempts int Komutun en fazla tekrar denenmesi gereken sayısı (başarısızsa).
retry_interval int Tekrar deneme girişimleri için aralık (dakikalarca).
os_run_priority int Rezerve edilmiş.
output_file_name nvarchar(200) Hangi komut çıktısının yazılması gereken dosya (yalnızca Transact-SQL, CmdExec ve PowerShell adımları).
last_run_outcome int Son kez yapılan adımın sonucu:

0 = Başarısız oldu
1 = Başarılı oldu
2 = Tekrar deneme
3 = İptal edildi
5 = Bilinmiyor
last_run_duration int Adımın son çalıştırıldığında süresi (hhmmss) var.
last_run_retries int Adım en son çalıştırıldığında komut kaç kez tekrar denendi.
last_run_date int Adımın en son başlatılmış tarihini belirt.
last_run_time int Adımın son başlatma zamanı.
proxy_id int İş adımı için vekil.

Açıklamalar

sp_help_jobstep veritabanında msdb yer alıyor.

Permissions

EXECUTE Bu prosedür üzerinde izinler verebilirsiniz, ancak bu izinler SQL Server yükseltmesi sırasında geçersiz kalabilir.

Diğer kullanıcılara, veritabanındaki aşağıdaki sabit veritabanı rollerinden birine msdb sahip olmalıdır:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Bu rollerin izinleri hakkında detaylar için SQL Server Agent Fixed Database Roles bölümüne bakınız.

SQLAgentUserRole üyeleri yalnızca sahip oldukları işler için iş adımlarını görebilir.

Örnekler

A. Belirli bir işteki tüm adımlar için iade bilgileri

Aşağıdaki örnek, adıyla Weekly Sales Data Backupolan iş için tüm iş adımlarını geri getirir.

USE msdb;
GO

EXECUTE dbo.sp_help_jobstep @job_name = N'Weekly Sales Data Backup';
GO

B. Belirli bir iş aşaması hakkında bilgi iade edin

Aşağıdaki örnek, adında Weekly Sales Data Backupolan iş için ilk iş adımı hakkında bilgi verir.

USE msdb;
GO

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

İlgili içerik

  • Last updated on