Udostępnij za pośrednictwem

  • Artykuł

sp_help_job (języka Transact-SQL)

Zwraca informacje o zadaniach, które są używane przez SQL Server Agent wykonywanie zautomatyzowanych czynności w SQL Server.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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' ]

Argumenty

  • [ @ job_id =] job_id
    Numer identyfikacyjny zadanie .job_idjest uniqueidentifier, domyślna wartość NULL.

  • [ @ job_name =] 'job_name"
    Nazwa zadanie.job_namejest sysname, domyślna wartość NULL.

    Ostrzeżenie

    Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.

  • [ @ job_aspect =] 'job_aspect"
    zadanieatrybut do wyświetlenia. job_aspectjest varchar(9), domyślna wartość NULL, i może być jedną z tych wartości.

    Wartość

    Opis

    ALL

    Informacje o zadaniu proporcji

    ZADANIA

    Informacje o zadaniu

    HARMONOGRAMY

    Informacje o harmonogramie

    KROKI

    Informacje o zadaniu kroku

    CELE

    Informacje docelowej

  • [ @ job_type =] 'job_type"
    Typ zadania do uwzględnienia w raporcie.job_typejest varchar(12), domyślna wartość NULL.job_typemoże być lokalnego lub rozwiązaniem.

  • [ @ owner_login_name = ] 'login_name"
    Nazwa logowania właściciela zadanie.login_namejest sysname, domyślna wartość NULL.

  • [ @ podsystemu =] 'subsystem"
    Nazwę podsystemu.subsystemjest nvarchar(40), domyślna wartość NULL.

  • [ @ category_name =] 'category"
    Nazwa kategorii.categoryjest sysname, domyślna wartość NULL.

  • [ @ włączone =] enabled
    Liczba wskazująca, czy informacje są wyświetlane dla włączone zadania zadania lub wyłączone.enabledjest tinyint, domyślna wartość NULL.1 wskazuje włączone zadań i 0 wskazuje wyłączonych zleceń.

  • [ @ execution_status =] status
    Stan wykonania zadania.statusjest int, domyślna wartość NULL, i może być jedną z tych wartości.

    Wartość

    Opis

    0

    Zwraca tylko te zadania, które nie są bezczynne lub zawieszone.

    1

    Wykonywanie.

    2

    Oczekiwania wątek.

    3

    Między ponownymi próbami.

    4

    Bezczynności.

    5

    Zawieszone.

    7

    Wykonywanie akcji zakończenia.

  • [ @ date_comparator =] 'date_comparison"
    operator porównania w porównania date_created i date_modified.date_comparisonis char(1),and can be =, <, or >.

  • [ @ date_created =] date_created
    data utworzenia zadanie .date_createdjest datetime, domyślna wartość NULL.

  • [ @ date_last_modified =] date_modified
    data zadanie ostatniej modyfikacji.date_modifiedjest datetime, domyślna wartość NULL.

  • [ @ Opis = ] 'description_pattern"
    Opis zadanie.description_patternjest nvarchar(512), domyślna wartość NULL.description_patternmoże zawierać symbole wieloznaczne SQL Server do dopasowania wzorca.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

Jeśli nie podano argumentów, sp_help_job zwraca ten zestaw wyników.

Nazwa kolumny

Typ danych

Opis

job_id

uniqueidentifier

Unikatowy identyfikator zadanie.

originating_server

nvarchar(30)

Nazwa serwera, z którego pochodzą zadanie .

name

sysname

Nazwa zadanie.

włączone

tinyint

Wskazuje, czy zadanie jest włączone do wykonania.

Opis

nvarchar(512)

Opis zadanie.

start_step_id

int

Identyfikator kroku zadanie , gdzie powinno rozpocząć się wykonanie.

Kategoria

sysname

Kategoria zadania.

właściciel

sysname

Właściciela zadania.

notify_level_eventlog

int

Maska bitowa wskazujące, w jakich okolicznościach powiadomienie zdarzenie powinny być rejestrowane w dzienniku aplikacji systemu Microsoft Windows.Może być jedną z następujących wartości:

0 = Nigdy

1 = Gdy zadanie zakończy się pomyślnie.

2 =, Jeśli zadanie nie powiedzie się.

3 = Po ukończeniu zadanie (niezależnie od wyników zadanie )

notify_level_email

int

Maska bitowa wskazujące, w jakich okolicznościach powinny być wysyłane powiadomienie pocztą e-mail po zakończeniu zadanie .Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

notify_level_netsend

int

Maska bitowa wskazujące, w jakich okolicznościach powinna być wysłana wiadomość sieci po zakończeniu zadanie .Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

notify_level_page

int

Maska bitowa wskazujące, w jakich okolicznościach strona powinny być wysyłane po ukończeniu zadanie .Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

notify_email_operator

sysname

Nazwa poczty e-mail powiadamianie operator .

notify_netsend_operator

sysname

Nazwa komputera lub użytkownika, używany przy wysyłaniu komunikatów sieciowych.

notify_page_operator

sysname

Nazwa komputera lub użytkownika używane przy wysyłaniu strona.

delete_level

int

Maska bitowa wskazujące, w jakich okolicznościach zadanie powinny być usuwane po zakończeniu zadanie .Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

date_created

datetime

Data utworzenia zadanie .

date_modified

datetime

Data ostatniej modyfikacji zadanie .

numer_wersji

int

Wersja zadanie (automatycznie aktualizowane za każdym czas modyfikować zadanie ).

last_run_date

int

Data wykonania ostatniego uruchomienia zadanie .

last_run_time

int

Czas ostatniego Rozpoczęto wykonywanie zadanie .

last_run_outcome

int

Wyniku zadanie czas ostatniego jej uruchomienia:

0 = Nie powiodło się

1 = Powiodło się.

3 = Anulowane

5 = Nieznany

next_run_date

int

Data, zaplanowane zadanie do uruchomienia następnej.

next_run_time

int

Czas, zaplanowane zadanie do uruchomienia następnej.

next_run_schedule_id

int

Numer identyfikacyjny następnego uruchomienia harmonogramu.

current_execution_status

int

Bieżący stan wykonania.

current_execution_step

sysname

Bieżący krok wykonanie zadanie.

current_retry_attempt

int

Jeśli zadanie jest uruchomione i ponawiane krok, to bieżącej ponawiania próby.

has_step

int

Numer czynności zadanie , które ma zadanie .

has_schedule

int

Liczba harmonogramy zadanie , które ma zadanie .

has_target

int

Liczba serwerów miejsce docelowe , które zadanie ma.

type

int

Typ zadanie.

1 = Lokalny zadanie.

2 = Propagując zadanie.

0 = Zadanie nie ma żadnych serwerów miejsce docelowe .

Jeśli job_id lub job_name jest określony, sp_help_job zwraca serwerówmiejsce docelowe tych zestawów wyników dodatkowe czynności zadanie , harmonogramy zadanie i zadanie.

Jest to zestaw wyników dla czynności zadanie .

Nazwa kolumny

Typ danych

Opis

step_id

int

(Dla tego zadanie) unikatowy identyfikator dla kroku.

step_name

sysname

Nazwa kroku.

Podsystem

nvarchar(40)

Podsystem, w którym wykonać polecenia krok.

polecenia

nvarchar(3200)

Polecenie do wykonać.

flagi

nvarchar(4000)

Maska bitowa wartości, które kontrolują zachowanie kroku.

cmdexec_success_code

int

Dla CmdExec krok, to jest kod zakończenia procesu pomyślne polecenia.

on_success_action

nvarchar(4000)

Co zrobić, jeśli krok:

1 = Zakończ z powodzeniem.

2 = Zakończ z błędem.

3 = Przejdź do następnego kroku.

4 = Przejdź do kroku.

on_success_step_id

int

Jeśli on_success_action jest 4, wskazuje to na wykonaćnastępnego kroku.

on_fail_action

nvarchar(4000)

AKCJA Aby wykonać krok nie powiedzie się.Wartości są takie same, jak w przypadku on_success_action.

on_fail_step_id

int

Jeśli on_fail_action jest 4, wskazuje to na wykonaćnastępnego kroku.

Serwer

sysname

Zarezerwowane.

nazwa_bazy_danych

sysname

Dla Transact-SQL kroku jest baza danych, w którym będą wykonywane.

database_user_name

sysname

Dla Transact-SQL kroku jest kontekst użytkownika bazy danych, w którym wykonywane jest.

retry_attempts

int

Maksymalna liczba polecenie powinno być ponowione (Jeśli nie powiedzie się) przed krok uważa się za nie powiodło się.

retry_interval

int

Interwał (w minutach) między dowolnym ponownych prób.

os_run_priority

varchar(4000)

Zarezerwowane.

output_file_name

varchar(200)

Plik, do którego polecenia powinny być zapisywane dane wyjściowe (Transact-SQL i CmdExec kroki tylko).

last_run_outcome

int

Wynik czas ostatniego kroku go uruchomiono:

0 = Nie powiodło się

1 = Powiodło się.

3 = Anulowane

5 = Nieznany

last_run_duration

int

Czas trwania (w sekundach) kroku ostatniego czas go uruchomiono.

last_run_retries

int

Ile razy polecenie zostało ponowione ostatniego czas uruchomienia krok.

last_run_date

int

Data wykonania kroku ostatniego uruchomienia.

last_run_time

int

Czas ostatniego Rozpoczęto wykonywanie kroku.

proxy_id

int

Serwer proxy dla etapu zadanie .

Jest to zestaw wyników harmonogramów zadanie .

Nazwa kolumny

Typ danych

Opis

schedule_id

int

Identyfikator harmonogramu (unikatowy przez wszystkie zadania).

schedule_name

sysname

Nazwa harmonogramu (unikatowe dla tego zadanie tylko).

włączone

int

Czy harmonogram jest aktywny (1) lub nie (0).

freq_type

int

Wartość wskazująca, kiedy zadanie jest wykonywana:

1 = Raz

4 = Codziennie

8 = Co tydzień

16 = Co miesiąc

32 = Co miesiąc, w stosunku do freq_interval

64 = Uruchomione po SQLServerAgenturuchomieniuusługa .

freq_interval

int

Dni po wykonaniu zadanie .Wartość zależy od wartości freq_type.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_subday_type

Int

Jednostki dla freq_subday_interval.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_subday_interval

int

Liczba freq_subday_type okresów między każdym wykonanie zadanie.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_relative_interval

int

Zaplanowane zadaniewystępowania freq_interval w każdym miesiącu.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL).

freq_recurrence_factor

int

Liczba miesięcy między planowane wykonanie zadanie.

active_start_date

int

Data rozpoczęcia wykonania zadanie.

active_end_date

int

Data zakończenia realizacji zadanie.

active_start_time

int

Czas rozpoczęcia realizacji zadanie na active_start_date.

active_end_time

int

Czas zakończenia realizacji zadanie na active_end_date.

date_created

datetime

Data utworzenia harmonogramu.

schedule_description

nvarchar(4000)

Angielski opis harmonogramu (Jeśli wymagane).

next_run_date

int

Data harmonogramu dalej spowoduje uruchomienie zadanie .

next_run_time

int

Czas harmonogramu dalej spowoduje uruchomienie zadanie .

schedule_uid

uniqueidentifier

Identyfikator harmonogramu.

job_count

int

Zwraca liczbę zadań, które odwołują się do tego harmonogramu.

Jest to zestaw wyników dla serwerówmiejsce docelowe zadanie.

Nazwa kolumny

Typ danych

Opis

server_id

int

Identyfikator serwera miejsce docelowe .

nazwa_serwera

nvarchar(30)

Nazwa komputera serwera miejsce docelowe .

enlist_date

datetime

Data zarejestrowany na serwer głównyserwera miejsce docelowe .

last_poll_date

datetime

Data serwera miejsce docelowe ostatniego sondowania serwer główny.

last_run_date

int

Data wykonania zadanie ostatniego uruchomienia na tym serwerze miejsce docelowe .

last_run_time

int

Czas ostatniego uruchomienia wykonywania zadanie na tym serwerze miejsce docelowe .

last_run_duration

int

Czas trwania zadanie ostatniego czas , który uruchomiono na serwerze miejsce docelowe .

last_run_outcome

tinyint

Wynik zadanie czas ostatniego uruchomiony na tym serwerze:

0 = Nie powiodło się

1 = Powiodło się.

3 = Anulowane

5 = Nieznany

last_outcome_message

nvarchar(1024)

Wynik message z zadanie ostatni czas uruchomiono na serwerze miejsce docelowe .

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera można wykonać tę procedura składowana.Inni użytkownicy muszą być przyznawane jedną z następujących SQL Server Agent ról stałej bazy danych w msdb bazy danych:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Szczegółowe informacje na temat uprawnień tych ról, zobacz Ról stałej bazy danych programu SQL Server Agent.

Członkowie SQLAgentUserRole można wyświetlić tylko zadania, których jest właścicielem.Członkowie sysadmin, SQLAgentReaderRole, i SQLAgentOperatorRole można wyświetlić wszystkie zadania lokalne i propagując.

Przykłady

A.Informacje dotyczące listy dla wszystkich zadań

Poniższy przykład wykonuje sp_help_job procedury bez parametrów do zwracania informacji dla wszystkich zadań zdefiniowanych w msdb bazy danych.

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B.Wyświetlanie informacji dla zadań spełniające określone kryteria

Poniższy przykład wyświetla informacje o zadanie propagując zadań należących do françoisa w przypadku gdy zadanie jest włączona i wykonującego.

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.Wyświetlanie listy wszystkich aspektów informacji dla zadanie

Poniższy przykład zawiera listę wszystkich aspektów informacji dla zadanie NightlyBackups.

USE msdb ;
GO

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