Udostępnij za pośrednictwem

  • Artykuł

sp_help_jobstep (języka Transact-SQL)

Zwraca informacje dotyczące czynności w zadanie używana przez SQL Server usługa agenta wykonywanie zautomatyzowanych czynności.

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

Składnia

sp_help_jobstep { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
     [ , [ @step_id = ] step_id ] 
     [ , [ @step_name = ] 'step_name' ] 
     [ , [ @suffix = ] suffix ]

Argumenty

  • [ @ job_id =] 'job_id"
    Numer identyfikacyjny zadanie której informacje o zadanie .job_idjest uniqueidentifier, domyślna wartość NULL.

  • [ @ job_name =] 'job_name"
    Nazwa zadanie.job_namejest sysname, z domyślnej NULL.

    Ostrzeżenie

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

  • [ @ step_id =] step_id
    Numer identyfikacyjny krok w zadanie.Jeśli nie, wszystkie kroki zadanie są uwzględniane.step_idjest int, domyślna wartość NULL.

  • [ @ step_name =] 'step_name"
    Nazwa kroku w zadanie.step_namejest sysname, domyślna wartość NULL.

  • [ @ sufiks =] suffix
    Flaga wskazująca, czy tekst opisu jest dołączana do flagi kolumna w danych wyjściowych.suffixjest bit, z domyślnymi z 0.Jeśli suffix jest 1, opis jest dołączany.

Wartości kodów powrotnych

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

Zestawy wyników

Nazwa kolumny

Typ danych

Opis

step_id

int

Unikatowy identyfikator dla etapu.

step_name

sysname

Nazwa kroku w zadanie.

Podsystem

nvarchar(40)

Podsystem, w którym wykonać polecenia krok.

polecenia

nvarchar(max)

Polecenie wykonane w kroku.

flagi

int

Maska bitów 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

tinyint

AKCJA Aby wykonać krok powiedzie się:

1 = Zakończ zadanie raportowania sukces.

2 = Zakończ zadanie raportowanie awarii.

3 = Przejdź do następnego kroku.

4 = Przejdź do kroku.

on_success_step_id

int

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

on_fail_action

tinyint

Co zrobić, jeśli krok nie powiedzie się.Wartości są takie same jak on_success_action.

on_fail_step_id

int

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

Serwer

sysname

Zarezerwowane.

nazwa_bazy_danych

sysname

Dla Transact-SQL kroku jest baza danych, w którym wykonywane jest.

database_user_name

sysname

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

retry_attempts

int

Maksymalna liczba powinna być ponowiona polecenia (Jeśli nie powiedzie się).

retry_interval

int

Interwał (w minutach) dla wszelkich ponownych prób.

os_run_priority

int

Zarezerwowane.

output_file_name

nvarchar(200)

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

last_run_outcome

int

Wynik czas ostatniego kroku go uruchomiono:

0 = Nie powiodło się

1 = Powiodło się.

2 = Ponów próbę

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 .

Uwagi

sp_help_jobstep w msdb bazy danych.

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 przeglądać tylko kroki zadanie zadań, których jest właścicielem.

Przykłady

A.Zwraca informacje dla wszystkich etapów w określonych zadanie

W przykładzie poniżej są zwracane wszystkie kroki zadanie zadanie o nazwie Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_help_jobstep
    @job_name = N'Weekly Sales Data Backup' ;
GO

B.Zwraca informacje o kroku określonego zadanie

Poniższy przykład zwraca informacje o pierwszy etap zadanie zadanie o nazwie Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_help_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO