sp_help_job (Transact-SQL)
Tarafından kullanılan işleri hakkında bilgi verir SQL Server Aracısı otomatik faaliyetleri gerçekleştirmek için SQL Server.
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. olabilirDeğ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. olabilirDeğ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.
Sütun adı |
Veri türü |
Açıklama |
---|---|---|
job_id |
uniqueidentifier |
işbenzersiz kimliği. |
originating_server |
nvarchar(30) |
Hangi iş gelen sunucu adı. |
name |
sysname |
işadı. |
Etkin |
tinyint |
iş yürütülecek etkin olup olmadığını gösterir. |
Açıklama |
nvarchar(512) |
işaçıklaması. |
start_step_id |
int |
Adımı yürütme nerede başlaması gerektiğini iş kimliği. |
Kategori |
sysname |
İş kategorisi. |
Sahip |
sysname |
İş sahibi. |
notify_level_eventlog |
int |
Bit maskesi Microsoft Windows Uygulama günlüğüne hangi koşullar altında bir bildirim olay günlüğe gösteren.Bu değerlerden biri olabilir: 0 Hiçbir zaman = 1 = iş başarılı olduğunda 2 = iş başarısız olduğunda 3 iş ( iş sonucu ne olursa olsun) tamamlandıktan her = |
notify_level_email |
int |
Bit maskesi gösteren bir iş tamamlandığında e-posta bildirim hangi koşullar altında gönderilmelidir.Olası değerler şunlardır: aynı notify_level_eventlog. |
notify_level_netsend |
int |
Bit maskesi gösteren bir iş tamamlandığında hangi koşullar altında bir ağ iletisi gönderilmelidir.Olası değerler şunlardır: aynı notify_level_eventlog. |
notify_level_page |
int |
Bit maskesi gösteren bir iş tamamlandığında bir sayfa hangi koşullar altında gönderilmelidir.Olası değerler şunlardır: aynı notify_level_eventlog. |
notify_email_operator |
sysname |
E-posta işleç bildirmek için adıdır. |
notify_netsend_operator |
sysname |
Bilgisayar veya ağ iletileri gönderirken kullanılan kullanıcı adı. |
notify_page_operator |
sysname |
Bilgisayar veya bir sayfagönderirken kullanılan kullanıcı adı. |
delete_level |
int |
Bit maskesi gösteren bir iş tamamlandığında hangi koşullarda iş silinmelidir.Olası değerler şunlardır: aynı notify_level_eventlog. |
date_created |
datetime |
iş oluşturulma tarihi. |
date_modified |
datetime |
iş son değiştirildiği tarih. |
version_number |
int |
iş sürümü ( iş değiştirilmiş her saat otomatik olarak güncelleştirilir). |
last_run_date |
int |
Son başlatılan iş yürütme tarih. |
last_run_time |
int |
iş son başlatılan yürütme zaman. |
last_run_outcome |
int |
iş bu projeyi son saat sonucunu: 0 = Başarısız oldu 1 = Başarılı oldu 3 = İptal 5 = Bilinmeyen |
next_run_date |
int |
iş sonraki çalışmak üzere zamanlandığı tarih. |
next_run_time |
int |
iş sonraki çalışmak üzere zamanlandığı saat. |
next_run_schedule_id |
int |
Sonraki çalıma zamanlamasını tanımlama numarası. |
current_execution_status |
int |
Geçerli yürütme durumu. |
current_execution_step |
sysname |
Geçerli yürütme işadım. |
current_retry_attempt |
int |
Çalışan iş ve adım denenen, geçerli yeniden deneme girişimi budur. |
has_step |
int |
iş olan iş adımları sayısı. |
has_schedule |
int |
iş olan iş zamanlamaları sayısı. |
has_target |
int |
iş olan hedef sunucu sayısı. |
type |
int |
iştürü. 1 = Yerel iş. 2 = Çoklu sunucu iş. 0 = İşin hedef sunucular yok. |
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.
Sütun adı |
Veri türü |
Açıklama |
---|---|---|
step_id |
int |
Adım (Bu işiçin) benzersiz tanımlayıcısı. |
step_name |
sysname |
Adım adı. |
alt sistemi |
nvarchar(40) |
Alt sistemi adım komutunu yürütmek . |
Command |
nvarchar(3200) |
yürütmekkomutu. |
Bayraklar |
nvarchar(4000) |
Bit maskesi adım davranışını denetlemek değerler. |
cmdexec_success_code |
int |
İçin bir CmdExec adım, başarılı komut işlem çıkış kodu budur. |
on_success_action |
nvarchar(4000) |
Ne adım başarılı olursa: 1 Çık = başarı ile. 2 = Quit hatası ile. 3 = Sonraki adıma gidin. 4 Git adım =. |
on_success_step_id |
int |
On_success_action olan 4, bu bir sonraki adıma yürütmekgösterir. |
on_fail_action |
nvarchar(4000) |
Adım başarısız olursa gerçekleştirilecek eylemi.Değerleri aynı olan on_success_action. |
on_fail_step_id |
int |
On_fail_action olan 4, bu bir sonraki adıma yürütmekgösterir. |
Sunucu |
sysname |
Ayrılmış. |
veritabanı_adı |
sysname |
İçin bir Transact-SQL , bu adımdır veritabanı içinde komutu yürütür. |
database_user_name |
sysname |
İçin bir Transact-SQL , bu adımdır veritabanı kullanıcı bağlamı içinde komutu yürütür. |
retry_attempts |
int |
En çok kaç kez adım başarısız kabul önce (Bu başarısız olursa) komutu denenmeli. |
yeniden_deneme_aralığı |
int |
Aralığı (dakika) yeniden deneme girişimleri arasında. |
os_run_priority |
varchar(4000) |
Ayrılmış. |
output_file_name |
varchar(200) |
Dosya hangi komutun çıkışı yazılması (Transact-SQL ve CmdExec sadece adımları). |
last_run_outcome |
int |
Çalıştırdığınız saat son adım sonucunu: 0 = Başarısız oldu 1 = Başarılı oldu 3 = İptal 5 = Bilinmeyen |
last_run_duration |
int |
Çalıştırdığınız saat son adım süresi (saniye cinsinden). |
last_run_retries |
int |
Kaç kez komut denenen adım projeyi son saat . |
last_run_date |
int |
Adım son başlatılan yürütme tarih. |
last_run_time |
int |
Adım son başlatılan yürütme zaman. |
proxy_id |
int |
Proxy iş adımı için. |
sonuç kümesi için iş zamanlamalarını budur.
Sütun adı |
Veri türü |
Açıklama |
---|---|---|
schedule_id |
int |
(Tüm işleri arasında benzersiz) zamanlama tanıtıcısı. |
schedule_name |
sysname |
(Bu iş için yalnızca benzersiz) tablosunun adı. |
Etkin |
int |
Zamanlamayı etkin olup (1) veya (0). |
freq_type |
int |
Yürütülecek iş olduğunda gösteren değer: 1 Kez = 4 Günlük = 8 Haftalık = 16 Aylık = 32 Göre aylık, = freq_interval 64 = Çalıştırılmasına SQLServerAgent hizmet başlatır. |
freq_interval |
int |
Gün, ne zaman iş yürütülür.Değer değerine bağlı freq_type.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL). |
freq_subday_type |
Int |
Birimleri için freq_subday_interval.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL). |
freq_subday_interval |
int |
Sayısı freq_subday_type her işarasında ortaya dönemleri.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL). |
freq_relative_interval |
int |
Zamanlanmış işoluşumunu freq_interval her ay.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL). |
freq_recurrence_factor |
int |
Zamanlanmış yürütme işarasındaki ay sayısı. |
active_start_date |
int |
işyürütme başlamak için tarih. |
active_end_date |
int |
işyürütülmesine son tarih. |
active_start_time |
int |
iş yürütme üzerinde başlama saati active_start_date. |
active_end_time |
int |
iş bitiş yürütülmesi için zaman active_end_date. |
date_created |
datetime |
Zamanlamayı oluşturulma tarihi. |
schedule_description |
nvarchar(4000) |
Zamanlama (istendiyse) İngilizce açıklaması. |
next_run_date |
int |
Tarihi zamanlamayı sonraki iş çalıştırmak neden olur. |
next_run_time |
int |
Saat zamanlamayı sonraki iş çalıştırmak neden olur. |
schedule_uid |
uniqueidentifier |
Zamanlama için tanımlayıcı. |
job_count |
int |
Bu zamanlama başvuru işleri sayısını verir. |
Bu sonuç kümesi iş hedef sunucular için geçerlidir.
Sütun adı |
Veri türü |
Açıklama |
---|---|---|
server_id |
int |
hedef sunucu tanıtıcısı. |
Sunucu_adı |
nvarchar(30) |
hedef sunucu bilgisayarın adı. |
enlist_date |
datetime |
ana sunucukayıtlı hedef sunucu tarih. |
last_poll_date |
datetime |
hedef sunucu ana sunucuson değerlendirmeye tarih. |
last_run_date |
int |
Bu hedef sunucuda son başladı iş yürütme tarih. |
last_run_time |
int |
iş son başlatılan yürütme bu hedef sunucuda zaman. |
last_run_duration |
int |
Süre iş bu hedef sunucuda ni son saat . |
last_run_outcome |
tinyint |
iş bu sunucuda çalıştırdığınız son saat sonucunu: 0 = Başarısız oldu 1 = Başarılı oldu 3 = İptal 5 = Bilinmeyen |
last_outcome_message |
nvarchar(1024) |
Bu hedef sunucuda çalıştırdığınız sonucu iletiden iş son saat . |
İ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
Aşağıdaki örnek yürütür sp_help_job şu anda tanımlanmış işlerin tüm bilgileri döndürmek için parametresiz yordamı msdb veritabanı.
USE msdb ;
GO
EXEC dbo.sp_help_job ;
GO
B.Belirli bir ölçütle eşleşen işleri için bilgi listeleme
Aşağıdaki örnek sahibi çoklu sunucu işler için iş bilgileri listeler françoisa etkin ve yürütülen iş nerede.
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 listelerNightlyBackups.
USE msdb ;
GO
EXEC dbo.sp_help_job
@job_name = N'NightlyBackups',
@job_aspect = N'ALL' ;
GO