Aracılığıyla paylaş

  • Makale

sp_help_job (Transact-SQL)

İşlemler tarafından kullanılan hakkında bilgi verirSQL ServerOtomatik faaliyetleri öğesineSQL Server.

Topic link iconTransact-SQL sözdizimi kuralları

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
    The job identification number.job_id is uniqueidentifier, with a default of NULL.

  • [ @job_name =] 'job_name'
    The name of the job.job_name is sysname, with a default of NULL.

    Not

    Her iki job_id veya job_name belirtilmiş olması gerekir, ancak her ikisi de belirtilemiyor.

  • [ @job_aspect =] 'job_aspect'
    The job attribute to display.job_aspect is varchar(9), with a default of NULL, and can be one of these values.

    Değer

    Açıklama

    ALL

    iş boyut bilgileri

    İŞ

    iş bilgileri

    ZAMANLAMA

    Zamanlama bilgileri

    ADIMLARI

    İş adım bilgi

    HEDEFLERİ

    Hedef bilgileri

  • [ @job_type =] 'job_type'
    The type of jobs to include in the report.job_type is varchar(12), with a default of NULL.job_type can be LOCAL or MULTI-SERVER.

  • [ @owner_login_name =] 'login_name'
    The login name of the owner of the job.login_name is sysname, with a default of NULL.

  • [ @subsystem =] 'subsystem'
    The name of the subsystem.subsystem is nvarchar(40), with a default of NULL.

  • [ @category_name =] 'category'
    The name of the category.category is sysname, with a default of NULL.

  • [ @enabled =] enabled
    A number indicating whether information is shown for enabled jobs or disabled jobs.enabled is tinyint, with a default of NULL.1 etkin işleri gösterir ve devre dışı işleri. 0 gösterir

  • [ @execution_status =] status
    The execution status for the jobs.status is int, with a default of NULL, and can be one of these values.

    Değer

    Açıklama

    0

    Boş veya askıya alınan iş verir.

    1

    Çalıştırılıyor.

    2

    İş parçacığı için bekliyor.

    3

    Yeniden denemeler arasında.

    4

    Boş.

    5

    Askıya alınmış.

    7

    Tamamlanma eylemleri gerçekleştirme.

  • [ @date_comparator =] 'date_comparison'
    The comparison operator to use in comparisons of date_created and date_modified.date_comparison is char(1),and can be =, <, or >.

  • [ @date_created =] date_created
    The date the job was created.date_createdis datetime, with a default of NULL.

  • [ @date_last_modified =] date_modified
    The date the job was last modified.date_modified is datetime, with a default of NULL.

  • [ @description =] 'description_pattern'
    The description of the job.description_pattern is nvarchar(512), with a default of NULL.description_pattern can include the SQL Server wildcard characters for pattern matching.

Dönüş Kodu Değerleri

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

Sonuç Kümeleri

Hiçbir bağımsız değişken belirtilirsp_help_job şu sonucu verir küme.

sütun Name

Veri türü

Açıklama

job_id

uniqueidentifier

Benzersiz kimlik iş.

originating_server

nvarchar(30)

Almak istediğiniz sunucunun adını iş tümleştirmeden.

Ad

sysname

Adı iş.

Etkin

tinyint

Gösterir mi iş yürütülmek üzere etkinleştirilir.

Açıklama

nvarchar(512)

Açıklama iş.

start_step_id

int

Adımın yürütme nerede başlaması gerektiğini iş kimliği.

Kategori

sysname

iş kategorisi.

Sahip

sysname

iş sahip.

notify_level_eventlog

int

Bit maskesi belirten bir bildirim olay circumstances altında ne günlüğe kaydedileceğini için Microsoft Windows Uygulama günlüğünüBu değerlerden biri olabilir:

0 = Never

1 Bir iş başarılı olduğunda =

2 Zaman = iş başarısız

3 Zaman = iş tamamlar (bağımsız olarak iş sonucu)

notify_level_email

int

Bit maskesi belirten bir bildirim e-posta ne circumstances altında gönderilmesini, bir iş tamamlar.Olası değerler aynınotify_level_eventlog.

notify_level_netsend

int

Bit maskesi gösteren bir ağ iletisi circumstances altında ne gönderilmesini, bir iş tamamlar.Olası değerler aynınotify_level_eventlog.

notify_level_page

int

Bit maskesi gösteren bir sayfa circumstances altında ne gönderilmesini, bir iş tamamlar.Olası değerler aynınotify_level_eventlog.

notify_email_operator

sysname

E-posta adı işleç bildirir.

notify_netsend_operator

sysname

Bilgisayar veya ağ iletileri gönderirken kullanılan kullanıcı adı.

notify_page_operator

sysname

Bilgisayar ya da bir sayfa gönderirken kullanılan kullanıcı adı.

delete_level

int

Bit maskesi bir işi tamamlandıktan sonra hangi koşullarda iş silineceğini belirten. Olası değerler aynınotify_level_eventlog.

date_created

datetime

Tarih iş oluşturuldu.

date_modified

datetime

Tarih iş son değiştirildiği.

version_number

int

sürüm iş (her saat otomatik olarak güncelleştirilen iş değiştirilir).

last_run_date

int

Tarih iş son yürütme başladı.

last_run_time

int

saat iş son yürütme başladı.

last_run_outcome

int

Sonucunu iş bitti, son kez:

0 = Failed

1 = $ Başarılı oldu

3 = $ Iptal edildi

5 = Unknown

next_run_date

int

Tarih iş sonraki çalışacak şekilde zamanlanır.

next_run_time

int

saat iş sonraki çalışacak şekilde zamanlanır.

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 adım iş.

current_retry_attempt

int

iş Çalışıyor ve adım yeniden, yeniden deneme girişimi geçerli olmasıdır.

has_step

int

İşlem adımları olan iş sayısı.

has_schedule

int

İş çizelgeleri olan iş sayısı.

has_target

int

Hedef sunucuları olan iş sayısı.

TYPE

int

Türü iş.

1 = Yerel iş.

2 = Çoklu sunucu iş.

0 = İş olan hiçbir hedef sunucu.

Ifjob_idorjob_namebelirtilmişse,sp_help_job Bu ek sonuç kümeleri işlem adımları, iş planları ve iş hedef sunuculara. verir

Bu iş adımları için sonucudur.

sütun Name

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 sistem

nvarchar(40)

Alt sisteminde olduğu yürütmek adım komutu.

Command

nvarchar(3200)

Yürütülecek komut.

Bayraklar

nvarchar(4000)

Bit maskesi değer denetimi adım davranışı.

cmdexec_success_code

int

Için bir CmdExec adım, başarılı bir komutun işlem çıkış kodu budur.

on_success_action

nvarchar(4000)

Adım başarılı olursa yapmanız gerekenler:

1 = Başarı. ile çıkış

2 Hatası. ile = Çık

3 = Git sonraki adım.

4 Adım Git =.

on_success_step_id

int

Ifon_success_action4 ise, bu bir sonraki adıma gösterir yürütmek.

on_fail_action

nvarchar(4000)

Adımı başarısız olduğunda yapılacak eylem.Değerler aynıon_success_action.

on_fail_step_id

int

Ifon_fail_action4 ise, bu bir sonraki adıma gösterir yürütmek.

Sunucu

sysname

Ayrılmış.

veritabanı_adı

sysname

İçin birTransact-SQLadım, bu, veritabanı içinde komutu yürütür.

database_user_name

sysname

Için bir Transact-SQL Bu veritabanı kullanıcı bağlamı içinde komutu yürütür adımıdır.

retry_attempts

int

En çok kaç kez başarısız olduğu için adım kabul önce (başarısız olması durumunda) komutu denenmeli.

yeniden_deneme_aralığı

int

Yeniden deneme girişimleri arasındaki zaman aralığı (dakika içinde).

os_run_priority

varchar(4000)

Ayrılmış.

output_file_name

varchar(200)

Dosya için hangi komutun çıkış yazılmış ( Transact-SQLve CmdExec adımları yalnızca).

last_run_outcome

int

Son adımı sonucunu saat, bitti:

0 = Failed

1 = $ Başarılı oldu

3 = $ Iptal edildi

5 = Unknown

last_run_duration

int

saat (saniye) adımının, son çalıştırdığında.

last_run_retries

int

saat Komutu yeniden denenmesi s sayısını son saat adım bitti.

last_run_date

int

Son başlangıç adımı yürütme tarih.

last_run_time

int

Adım son başlatılan yürütme zamanı.

proxy_id

int

iş adımı için proxy.

Bu, sonuç kümesi proje zamanlamaları için.

sütun Name

Veri türü

Açıklama

schedule_id

int

(Tüm işleri arasında benzersiz) zamanlama tanıtıcısı.

schedule_name

sysname

Zamanlama adı (Bu benzersiz iş yalnızca).

Etkin

int

Zamanlama etkin olup ( 1 ) veya ( 0 ).

freq_type

int

Değer ne zaman gösteren iş yürütülmesi için:

1 = Once

4 = Daily

8 = Weekly

16 = Monthly

32 Aylık, göreceli olarak freq_interval =

64 Başlar. SQLServerAgent hizmet, çalışma =

freq_interval

int

Gün, iş yürütülür.Değer değeri bağlıdırfreq_type.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL)

freq_subday_type

Int

Birimlerifreq_subday_interval.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL)

freq_subday_interval

int

Sayısı freq_subday_type dönem her arasında ortaya iş.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL)

freq_relative_interval

int

Zamanlanmış iş's geçtiğifreq_interval içinde her ay.Daha fazla bilgi için, bkz. sp_add_schedule (Transact-SQL)

freq_recurrence_factor

int

Zamanlanmış yürütülmesini arasındaki ay sayısını iş.

active_start_date

int

Yürütülmesini başlatmak için tarih iş.

active_end_date

int

Yürütmeyi sona erdirmek için tarih iş.

active_start_time

int

Yürütülmesini başlatmak için saat iş üzerindeactive_start_date.

active_end_time

int

Son çalışmasını saat iş üzerindeactive_end_date.

date_created

datetime

Zamanlamayı oluşturulma tarih.

schedule_description

nvarchar(4000)

İngilizce açıklama (istenirse) tablosu.

next_run_date

int

Zamanlamayı sonraki neden tarih iş çalıştırılacak.

next_run_time

int

Zamanlamayı sonraki neden saat iş çalıştırılacak.

schedule_uid

uniqueidentifier

Zamanlama için tanımlayıcı.

job_count

int

Bu zamanlama başvuran işlerin sayısını verir.

Bu iş hedef sunucular için küme sonucudur.

sütun Name

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

Hedef sunucu ana sunucu kayıtlı tarih.

last_poll_date

datetime

Hedef sunucu, son ana sunucu yoklamalı tarih.

last_run_date

int

Iş son yürütme bu başlangıç tarih hedef sunucu.

last_run_time

int

saat iş son yürütme bu hedef sunucu üzerinde başladı.

last_run_duration

int

Bu hedef sunucu üzerinde çalışan, son kez saat iş.

last_run_outcome

tinyint

Bu sunucuda'ni en son çalıştırdığınızda iş sonucu:

0 = Failed

1 = $ Başarılı oldu

3 = $ Iptal edildi

5 = Unknown

last_outcome_message

nvarchar(1024)

Sonuç iletisinde iş son kez bu hedef sunucu üzerinde çalıştı.

İzinler

Varsayılan olarak, üye sysadmin sabit sunucu rolü Bu saklı yordamı çalıştırabilirsiniz.Aşağıdakilerden birini diğer kullanıcılara verilmelidir SQL Server Veritabanı rollerini sabit Aracısı msdb veritabanı:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

ÜyeleriSQLAgentUserRole yalnızca sahip oldukları işleri görüntüleyin.ÜyeleriSistem YöneticisiSQLAgentReaderRole , SQLAgentOperatorRole görüntülemek tüm yerel ve çoklu sunucu iş.

Örnekler

C.Tüm projelerin listesi bilgisi

Aşağıdaki örnekte yürütensp_help_jobyordamı şu anda tanımlanan işlerin tüm bilgi almak için parametresizmsdbveritabanı.

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

b.Belirli bir ölçüte uyan işler için bilgi listesi

Aşağıdaki örnek, çoklu sunucu iş sahibi için proje bilgilerini listelerfranç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

c.Bilgi için tüm açılardan listeleyen bir iş

Aşağıdaki örnek, tüm yönleriyle iş ile ilgili bilgileri listelerNightlyBackups.

USE msdb ;
GO

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