sp_help_jobhistory (języka Transact-SQL)

Zawiera informacje o zadaniach dla serwerów w administrowanie wieloma serwerami domena.

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

Składnia

sp_help_jobhistory [ [ @job_id = ] job_id ] 
     [ , [ @job_name = ] 'job_name' ] 
     [ , [ @step_id = ] step_id ] 
     [ , [ @sql_message_id = ] sql_message_id ] 
     [ , [ @sql_severity = ] sql_severity ] 
     [ , [ @start_run_date = ] start_run_date ] 
     [ , [ @end_run_date = ] end_run_date ] 
     [ , [ @start_run_time = ] start_run_time ] 
     [ , [ @end_run_time = ] end_run_time ] 
     [ , [ @minimum_run_duration = ] minimum_run_duration ] 
     [ , [ @run_status = ] run_status ] 
     [ , [ @minimum_retries = ] minimum_retries ] 
     [ , [ @oldest_first = ] oldest_first ] 
     [ , [ @server = ] 'server' ] 
     [ , [ @mode = ] 'mode' ]

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.

  • [ @step_id= ] step_id
    Numer identyfikacyjny kroku.step_idjest int, domyślna wartość NULL.

  • [ @ sql_message_id= ] sql_message_id
    Numer identyfikacyjny komunikat o błędzie, zwrócony przez Microsoft SQL Server podczas wykonywania zadanie.sql_message_idjest int, domyślna wartość NULL.

  • [ @sql_severity= ] sql_severity
    Wskaźnik poziom komunikat o błędzie, zwracane przez SQL Server podczas wykonywania zadanie.sql_severityjest int, domyślna wartość NULL.

  • [ @ start_run_date= ] start_run_date
    data zadanie została uruchomiona.start_run_datejest int, domyślna wartość NULL.start_run_datemusi wprowadzone w formularzu RRRRMMDD, gdzie RRRR to rok czterech znaków, MM to nazwa miesiąca dwóch znaków, a DD jest nazwą dnia dwóch znaków.

  • [ @end_run_date= ] end_run_date
    data zadanie została ukończona.end_run_datejest int, domyślna wartość NULL.end_run_datemuszą być wprowadzone w formularzu RRRRMMDD, gdzie RRRR to czterocyfrowy rok, MM to nazwa miesiąca dwóch znaków, a DD jest nazwą dzień dwóch znaków.

  • [ @ start_run_time= ] start_run_time
    czas zadanie zostało rozpoczęte.start_run_timejest int, domyślna wartość NULL.start_run_timemuszą być wprowadzone w formularzu HHMMSS, gdzie GG oznacza znak dwie godziny dnia, MM minuty dwóch znaków dnia, a SS dwuznakowych drugi dzień.

  • [ @end_run_time= ] end_run_time
    czas zadanie ukończone jego realizacji.end_run_timejest int, domyślna wartość NULL.end_run_timemuszą być wprowadzone w formularzu HHMMSS, gdzie GG oznacza znak dwie godziny dnia, MM minuty dwóch znaków dnia, a SS dwuznakowych drugi dzień.

  • [ @ minimum_run_duration= ] minimum_run_duration
    Minimalna długość czas zakończenia zadanie.minimum_run_durationjest int, domyślna wartość NULL.minimum_run_durationmuszą być wprowadzone w formularzu HHMMSS, gdzie GG oznacza znak dwie godziny dnia, MM minuty dwóch znaków dnia, a SS dwuznakowych drugi dzień.

  • [ @run_status= ] run_status
    Stan realizacji zadanie.run_statusjest int, domyślna wartość NULL, i może być jedną z tych wartości.

    Wartość

    Opis

    0

    Nie powiodło się

    1

    Powiodło się.

    2

    Ponów próbę (tylko krok)

    3

    Anulowane

    4

    Wiadomość w toku

    5

    Nieznany

  • [ @ minimum_retries= ] minimum_retries
    Minimalną liczbę razy zadanie należy ponownie uruchomiony.minimum_retriesjest int, domyślna wartość NULL.

  • [ @oldest_first= ] oldest_first
    To, czy należy przedstawić dane wyjściowe z zadaniami najstarsze najpierw.oldest_firstjest int, domyślnie 0, którego najpierw prezentuje najnowsza zadania.1 najpierw prezentuje najstarsze zadania.

  • [ @server= ] 'server'
    Nazwa serwera, na którym wykonano zadanie .serverjest nvarchar(30), domyślna wartość NULL.

  • [ @mode= ] 'mode'
    To, czy SQL Server umożliwia drukowanie wszystkich kolumn w zestaw wyników (pełne) lub Podsumowanie kolumn.modejest varchar(7), domyślnie Podsumowanie.

Wartości kodów powrotnych

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

Zestawy wyników

Rzeczywiste kolumna listy zależy od wartości mode.Najwszechstronniejszy zestaw kolumn jest pokazany poniżej i jest zwracana, gdy mode jest pełny.

Nazwa kolumny

Typ danych

Opis

instance_id

int

Numer identyfikacyjny zapis historii.

job_id

uniqueidentifier

Numer identyfikacyjny zadania.

job_name

sysname

Nazwa zadania.

step_id

int

Numer identyfikacyjny kroku (będzie 0 dla zadanie historia).

step_name

sysname

Nazwa kroku (będzie mieć wartość NULL dla zadanie historia).

sql_message_id

int

Dla Transact-SQL krok, ostatnio Transact-SQL Liczba błędów napotkanych podczas wykonywania polecenia.

sql_severity

int

Dla Transact-SQL krok, najwyższą Transact-SQL ważności błąd wystąpił podczas wykonywania polecenia.

komunikat

nvarchar(1024)

Komunikat historia zadania lub kroku.

run_status

int

Wynik zadanie lub kroku.

run_date

int

Data zadanie lub kroku rozpoczął wykonywanie.

run_time

int

Czas zadanie lub kroku rozpoczął wykonywanie.

run_duration

int

Dotychczasowy czas w realizacji zadanie lub kroku w formacie HHMMSS.

operator_emailed

nvarchar(20)

Operator, który został pocztą e-mail dotyczące tego zadanie (ma wartość NULL dla kroku historia).

operator_netsent

nvarchar(20)

Operator, który został wysłany komunikat sieciowy dotyczące tego zadanie (ma wartość NULL dla kroku historia).

operator_paged

nvarchar(20)

Operator, który został stronicowanej dotyczące tego zadanie (ma wartość NULL dla kroku historia).

retries_attempted

int

Liczba kroku została ponowiona (zawsze 0 dla zadanie historia).

Serwer

nvarchar(30)

Serwer krok lub zadanie wykonuje się na.Zawsze (lokalnego).

Uwagi

sp_help_jobhistory zwraca raportu o historia określona zaplanowanych zadań.Jeśli nie określono żadnych parametrów, raport zawiera historia wszystkich zaplanowanych zadań.

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 rola bazy danych może tylko przeglądać historia zadania, których jest właścicielem.

Przykłady

A.Wyświetlanie listy wszystkich informacji zadanie zadanie

Poniższy przykład wyświetla wszystkie informacje o zadanie do NightlyBackups zadanie.

USE msdb ;
GO

EXEC dbo.sp_help_jobhistory 
    @job_name = N'NightlyBackups' ;
GO

B.Wyświetlanie informacji dotyczących zadań, które spełniają określone warunki

Poniższy przykład drukuje wszystkie kolumny, a wszystkie informacje o zadanie dla każdego nie powiodło się zadania, a nie zadanie kroki komunikat o błędzie o 50100 (komunikat Błąd zdefiniowany przez użytkownika) i wskaźnik ważności z 20.

USE msdb
GO

EXEC dbo.sp_help_jobhistory
    @sql_message_id = 50100,
    @sql_severity = 20,
    @run_status = 0,
    @mode = N'FULL' ;
GO