Udostępnij za pośrednictwem

  • Artykuł

sp_help_jobhistory (Transact-SQL)

Przy użyciu klauzula LIKE CAST

Topic link iconKonwencje składni języka Transact-SQL

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
    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.

  • [ @step_id= ] step_id
    The step identification number.step_id is int, with a default of NULL.

  • [ @sql_message_id= ] sql_message_id
    The identification number of the error message returned by Microsoft SQL Server when executing the job.sql_message_id is int, with a default of NULL.

  • [ @sql_severity= ] sql_severity
    The severity level of the error message returned by SQL Server when executing the job.sql_severity is int, with a default of NULL.

  • [ @start_run_date= ] start_run_date
    The date the job was started.start_run_dateis int, with a default of NULL.start_run_date must be entered in the form YYYYMMDD, where YYYY is a four-character year, MM is a two-character month name, and DD is a two-character day name.

  • [ @end_run_date= ] end_run_date
    The date the job was completed.end_run_date is int, with a default of NULL.end_run_datemust be entered in the form YYYYMMDD, where YYYY is a four-digit year, MM is a two-character month name, and DD is a two-character day name.

  • [ @start_run_time= ] start_run_time
    The time the job was started.start_run_time is int, with a default of NULL.start_run_timemust be entered in the form HHMMSS, where HH is a two-character hour of the day, MM is a two-character minute of the day, and SS is a two-character second of the day.

  • [ @end_run_time= ] end_run_time
    The time the job completed its execution.end_run_time is int, with a default of NULL.end_run_timemust be entered in the form HHMMSS, where HH is a two-character hour of the day, MM is a two-character minute of the day, and SS is a two-character second of the day.

  • [ @minimum_run_duration= ] minimum_run_duration
    The minimum length of time for the completion of the job.minimum_run_duration is int, with a default of NULL.minimum_run_durationmust be entered in the form HHMMSS, where HH is a two-character hour of the day, MM is a two-character minute of the day, and SS is a two-character second of the day.

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

    Wartość

    Description

    0

    Styl 0 binarne znak

    1

    0x4E616D

    2

    4E616D65

    3

    Anulowane

    4

    Styl 0, znak na dwójkową

    5

    Nieznany

  • [ @minimum_retries= ] minimum_retries
    The minimum number of times a job should retry running.minimum_retries is int, with a default of NULL.

  • [ @oldest_first= ] oldest_first
    Określa, czy przedstawiać wyniki w kolejności od najstarszego zadania.Parametr oldest_first jest typu int i domyślnie ma wartość 0, co odpowiada kolejności od najnowszego zadania.1 odpowiada kolejności od najstarszego zadania.

  • [ @server= ] 'server'
    The name of the server on which the job was performed.server is nvarchar(30), with a default of NULL.

  • [ @mode= ] 'mode'
    Is whether SQL Server prints all columns in the result set (FULL) or a summary of the columns.mode is varchar(7), with a default of SUMMARY.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

Lista kolumn rzeczywiste zależy od wartości mode. Najbardziej obszerny zestaw kolumn jest pokazany poniżej i po zwróceniu mode jest FULL.

Nazwa kolumna

Typ danych

Description

instance_id

int

Zapis historyczny numeru identyfikacyjnego.

job_id

uniqueidentifier

Numer identyfikacyjny zadania.

job_name

sysname

Nazwa zadania.

W dublowany zestaw nośników, co dublowania musi zawierać kopię każdej rodzina nośników.

int

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

Kiedy kilka urządzeń są wymienione poszczególne kopie lustrzane, określa kolejność urządzeń, który rodzina nośników są zapisywane do określonego urządzenia.

sysname

Nazwa kroku (NULL dla historii zadania).

sql_message_id

int

Aby Transact-SQL krok, najbardziej aktualne Transact-SQL Liczba błędów napotkanych podczas korzystania z polecenia.

sql_severity

int

Aby Transact-SQL krok najwyższa Transact-SQL Waga błędu napotkanych podczas wykonywania polecenia.

komunikat

nvarchar(1024)

Ciąg musi być Unicode stała lub zmienna Unicode.

run_status

int

Wynik zadania lub kroku.

run_date

int

Data rozpoczęcia wykonania zadania lub kroku.

run_time

int

Godzina rozpoczęcia wykonania zadania lub kroku.

run_duration

int

Wartością domyślną tego parametru jest NULL.

operator_emailed

nvarchar(20)

Wartość może być stała Unicode lub zmiennej Unicode.

operator_netsent

nvarchar(20)

Operator, który wysłał komunikat sieciowy dotyczący tego zadania (NULL dla historii kroku).

operator_paged

nvarchar(20)

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

retries_attempted

int

Liczba określająca, ile razy została ponowiona w kroku (zawsze 0 dla Historia zatrudnienia).

Serwer

nvarchar(30)

Serwer etap lub zadanie jest wykonywany.Czy zawsze)lokalne).

Remarks

sp_help_jobhistory zwraca raportu o historia określona zaplanowanych zadań.Jeśli zostaną określone nie parametry, raport zawiera historia dla wszystkich zaplanowanych zadań.

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera możliwość wykonać tej procedura przechowywana.Inni użytkownicy klastrowa musi mieć jedną z następujących czynności SQL Server Agent stałe role bazy danych w msdb bazy danych:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Aby uzyskać szczegółowe informacje o uprawnieniach z tych ról zobacz SQL Server Agent Fixed Database Roles.

Członkowie SQLAgentUserRole rola bazy danych może tylko przeglądać historię zadania, na których jest właścicielem.

Przykłady

A.Wyświetlanie listy wszystkich informacji zadanie dla zadanie

W następującym przykładzie polecenie wyświetla listę wszystkich informacji zadanie NightlyBackups zadanie.

USE msdb ;
GO

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

B.Wyświetlanie informacji o zadaniach, które spełniają określone warunki

W poniższym przykładzie drukuje wszystkie kolumny, a wszystkie informacje o zadaniu nie powiodło się zadanie i kroki zadanie nie powiodło się komunikat o błędzie z 50100 (komunikat o błędzie przez użytkownika) i 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