sp_help_job (Transact-sql)

Kullandığı işlemler hakkında bilgi döndüren SQL ServerAgent otomatikleştirilmiş faaliyetleri gerçekleştirilecek SQL Server. 

Transact-SQL Sözdizim Kuralları

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
  İş kimlik numarası. job_idise uniqueidentifier, null varsayılan.

• @job_name ='job_name'
  Iş adı. job_nameise sysname, null varsayılan.

  [!NOT]

  Ya job_idya job_namebelirtilmesi gerekir, ancak her ikisi de belirtilemez.

• @ job_aspect ='job_aspect'
  Görüntülenecek iş özniteliği. job_aspectise varchar(9), null varsayılan ile ve bu değerlerden birini olabilir.

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

• @job_type ='job_type'
  Rapora dahil etmek için iş türü. job_typeise varchar(12), null varsayılan. job_typeolabilir Yerel veya MULTI-SERVER.

• @ owner_login_name ='login_name'
  İş sahibinin oturum açma adı. login_nameise sysname, null varsayılan.

• @ alt ='subsystem'
  Alt sisteminin adı. subsystemise nvarchar(40), null varsayılan.

• @ category_name ='category'
  Kategori adı. categoryise sysname, null varsayılan.

• **@enabled =**enabled
  Bilgi için görünür olup olmadığını gösteren bir sayı işleri ya da Engelli işleri etkin. enabledise tinyint, null varsayılan. 1 etkin işler, gösterir ve 0 Engelli işleri gösterir.

• **@ execution_status =**status
  İşleri yürütme durumu. statusise int, null varsayılan ile ve bu değerlerden birini olabilir.

  Değer	Açıklama
  0	Yalnızca boş ya da yarım kalmış işleri döndürür.
  1	Yürütme.
  2	İş parçacığı için bekleniyor.
  3	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şlecini date_createdve date_modified. date_comparisonis char(1),and can be =, <, or >.

• **@ date_created =*date_created
  Iş oluşturulduğu tarih. date_created *ise datetime, null varsayılan.

• **@ date_last_modified =**date_modified
  Işin son değiştirildiği tarih. date_modifiedise datetime, null varsayılan.

• @ description ='description_pattern'
  İşin açıklaması. description_patternise nvarchar(512), null varsayılan. description_patterndesen eşleştirme için SQL Server joker karakterler içerebilir.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Sonuç Kümeleri

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

Eğer job_idveya job_namebelirtilen sp_help_job iş adımları, iş zamanlamaları ve iş hedef sunucular için bu ek sonuç kümeleri döndürür.

Bunun için iş adımları ayarlamak sonucudur.

Bu iş zamanlamalarını ayarlamak sonucudur.

Bu iş için hedef sunucuları ayarlamak sonucudur.

İzinler

Varsayılan olarak, üye sysadmin sabit sunucu rolü bu saklı yordam yürütebilirsiniz. Diğer kullanıcıların aşağıdakilerden birini verilmesi gereken SQL ServerAgent veritabanı rolleri sabit msdb veritabanı:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

Üyeleri SQLAgentUserRole işleri yalnızca görüntüleyebilir. Üyeleri sysadmin, SQLAgentReaderRole, ve SQLAgentOperatorRole tüm yerel ve multiserver işleri görebilirsiniz.

Örnekler

A.Tüm işleri listesi bilgileri

Aşağıdaki örnek yürütür sp_help_jobiçin şu anda tanımlanmış işlerin tüm bilgileri döndürmek için parametresiz yordamı msdbveritabanı.

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B.Belirli bir ölçüte uyan İşler Listeleme

Aşağıdaki örnek, iş bilgi sahibi multiserver işleri listeler françoisaişi olduğu etkin ve yürütülen.

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

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

Aşağıdaki örnek, iş için bilgi tüm yönlerini listeler NightlyBackups.

USE msdb ;
GO

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

USE msdb ;
GO

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

Ayrıca bkz.

Başvuru

sp_add_job (Transact-sql)

sp_delete_job (Transact-sql)

sp_update_jobmsdb (Transact-sql)

Sistem saklı yordamları (Transact-sql)