sp_help_job (Transact-SQL)

Sözdizimi

sp_help_job { [ @job_id = ] job_id
[ @job_name = ] 'job_name' } 
     [ , [ @job_aspect = ] 'job_aspect' ] 
     [ , [ @job_type = ] 'job_type' ] 
     [ , [ @owner_login_name = ] 'login_name' ] 
     [ , [ @subsystem = ] 'subsystem' ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @enabled = ] enabled ] 
     [ , [ @execution_status = ] status ] 
     [ , [ @date_comparator = ] 'date_comparison' ] 
     [ , [ @date_created = ] date_created ] 
     [ , [ @date_last_modified = ] date_modified ] 
     [ , [ @description = ] 'description_pattern' ]

Bağımsız değişkenler

• [ @ job_id =] job_id
  iş kimlik numarası.job_idİş uniqueidentifier, varsayılan değer null.

• [ @ job_name =] 'job_name'
  işadı.job_nameİş sysname, varsayılan değer null.

  Not

  Ya da job_id veya job_name belirtilmesi gerekir, ancak her ikisi de belirtilemez.

• [ @ job_aspect =] 'job_aspect'
  Görüntülenecek iş öznitelik .job_aspectİş varchar(9), null, varsayılan değer ve biri bu değerler. olabilir

  Değer	Açıklama
  ALL	İş boy bilgileri
  İŞ	İş bilgileri
  ZAMANLAMALARI	Zamanlama bilgileri
  ADIMLARI	İş adım bilgileri
  HEDEFLERİ	Hedef bilgileri

• [ @ job_type =] 'job_type'
  Rapora dahil etmek için işleri türü.job_typeİş varchar(12), varsayılan değer null.job_typeolabilir yerel veya MULTI-SERVER.

• [ @ owner_login_name = ] 'login_name'
  işsahibinin oturum açma adı.login_nameİş sysname, varsayılan değer null.

• [ @ alt =] 'subsystem'
  Alt sisteminin adı.subsystemİş nvarchar(40), varsayılan değer null.

• [ @ category_name =] 'category'
  Kategori adı.categoryİş sysname, varsayılan değer null.

• [ @ Etkin =] enabled
  Bilgi için gösterilen olup olmadığını belirten bir sayı, işleri ya da devre dışı işleri etkin.enabledİş tinyint, varsayılan değer null.1 etkin işleri gösterir ve 0 devre dışı işleri gösterir.

• [ @ execution_status =] status
  İşleri yürütme durumu.statusİş int, null, varsayılan değer ve biri bu değerler. olabilir

  Değer	Açıklama
  0	Boşta kalma veya askıya alınmış olmayan işleri döndürür.
  1	Çalıştırılıyor.
  2	iş parçacığıiçin bekleniyor.
  3	Yeniden denemeler arasında.
  4	Boşta.
  5	Askıya alındı.
  7	Tamamlanma eylemleri gerçekleştirme.

• [ @ date_comparator =] 'date_comparison'
  Karşılaştırmaları içinde kullanmak için karşılaştırma işleç date_created ve date_modified.date_comparisonis char(1),and can be =, <, or >.

• [ @ date_created =] date_created
  tarih iş oluşturuldu.date_createdİş datetime, varsayılan değer null.

• [ @ date_last_modified =] date_modified
  tarih iş son değiştirildiği.date_modifiedİş datetime, varsayılan değer null.

• [ @ Description = ] 'description_pattern'
  işaçıklaması.description_patternİş nvarchar(512), varsayılan değer null.description_patternDesen eşleştirme için SQL Server joker karakterler içerebilir.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (başarısız)

Sonuç Kümeleri

Hiçbir bağımsız değişken belirtilmezse, sp_help_job bu sonuç kümesidöndürür.

job_id Veya job_name belirlendiğinde, sp_help_jobhedef sunucuları iş adımları, iş zamanlamalarını ve işiçin bu ek sonuç kümeleri döndürür.

sonuç kümesi için iş adımları budur.

sonuç kümesi için iş zamanlamalarını budur.

Bu sonuç kümesi iş hedef sunucular için geçerlidir.

İzinler

Varsayılan olarak, üye sysadmin sabit sunucu rolü olabilir yürütmek bu saklı yordam.Diğer kullanıcıların aşağıdakilerden birini verilmelidir SQL Server Agent veritabanı rolleri sabit msdb veritabanı:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Bu roller, izinler hakkında daha fazla bilgi için bkz: SQL Server Agent veritabanı rolleri sabit.

Üyeleri SQLAgentUserRole yalnızca sahip oldukları işleri görmek için.Üyeleri sysadmin, SQLAgentReaderRole, ve SQLAgentOperatorRole tüm yerel ve çoklu sunucu işleri görebilirsiniz.

Örnekler

A.Bilgileri tüm işleri listelemek

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B.Belirli bir ölçütle eşleşen işleri için bilgi listeleme

USE msdb ;
GO

EXEC dbo.sp_help_job 
   @job_type = N'MULTI-SERVER',
   @owner_login_name = N'françoisa',
   @enabled = 1,
   @execution_status = 1 ;
GO

C.Bir işiçin bilgi tüm yönlerini listeleme

USE msdb ;
GO

EXEC dbo.sp_help_job
    @job_name = N'NightlyBackups',
    @job_aspect = N'ALL' ;
GO

Ayrıca bkz.

Başvuru