Sdílet prostřednictvím

sp_help_jobstep (Transact-SQL)

platí pro:SQL Server

Vrací informace o krocích v úlohě používané službou SQL Server Agent pro automatizované aktivity.

Transact-SQL konvence syntaxe

Syntaxe

sp_help_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Identifikační číslo práce, pro které je vhodné vrátit informace o zaměstnání. @job_id je uniqueidentifier, s výchozím nastavením NULL.

Buď @job_id , nebo @job_name musí být specifikovány, ale ani jedno nelze specifikovat.

[ @job_name = ] N'job_name'

Název úlohy. @job_name je sysname s výchozím nastavením NULL.

Buď @job_id , nebo @job_name musí být specifikovány, ale ani jedno nelze specifikovat.

[ @step_id = ] step_id

Identifikační číslo kroku v práci. Pokud není zahrnuto, všechny kroky v práci jsou zahrnuty. @step_id je int, s výchozím nastavením NULL.

[ @step_name = ] N'step_name'

Název kroku v práci. @step_name je sysname, s výchozím nastavením NULL.

[ @suffix = ] přípona

Příznak označující, zda je do sloupce příznaků ve výstupu připojen textový popis. @suffix je bit, s výchozím hodnotou 0. Pokud je @suffix , 1je připojen popis.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Název sloupce Datový typ Description
step_id int Unikátní identifikátor pro tento krok.
step_name sysname Název kroku v práci.
subsystem nvarchar(40) Podsystém, ve kterém se provádí příkaz kroku.
command nvarchar(max) Příkaz proveden v kroku.
flags int Bitmaska hodnot, které řídí chování kroků.
cmdexec_success_code int Pro krok CmdExec je tato hodnota výstupní kód procesu úspěšného příkazu.
on_success_action tinyint Krok, který je třeba podniknout, pokud se krok podaří:

1 = Odejít z práce, hlásit úspěch.
2 = Odejít z práce, hlásit neúspěch.
3 = Přejděte na další krok.
4 = Jdi na krok.
on_success_step_id int Pokud je on_success_action 4, tato hodnota označuje další krok k vykonání.
on_fail_action tinyint Co dělat, když krok selže. Hodnoty jsou stejné jako .on_success_action
on_fail_step_id int Pokud on_fail_action je , 4tato hodnota označuje další krok k vykonání.
server sysname Rezervovaný.
database_name sysname Pro Transact-SQL krok je tato hodnota databáze, ve které se příkaz vykoná.
database_user_name sysname Pro Transact-SQL krok je tato hodnota uživatelským kontextem databáze, ve kterém se příkaz vykoná.
retry_attempts int Maximální počet pokusů příkazu je třeba opakovat (pokud neuspěje).
retry_interval int Interval (v minutách) pro případné opakované pokusy.
os_run_priority int Rezervovaný.
output_file_name nvarchar(200) soubor, do kterého by měl být zapsán výstup příkazu (pouze kroky Transact-SQL, CmdExec a PowerShell ).
last_run_outcome int Výsledek kroku při posledním provedení:

0 = Neuspěl
1 = Podařilo se
2 = Opakování
3 = Zrušeno
5 = Neznámé
last_run_duration int Délka (hhmmss) kroku při posledním provedení.
last_run_retries int Počet opakování příkazu při posledním provedení kroku.
last_run_date int Datum posledního zahájení kroku a provedení.
last_run_time int Čas, kdy krok začal naposledy s vykonáním.
proxy_id int Zástupce pro pracovní krok.

Poznámky

sp_help_jobstep je v databázi msdb .

Povolení

Na tomto postupu můžete udělit EXECUTE oprávnění, ale tato oprávnění mohou být během upgradu SQL Serveru přepsána.

Ostatní uživatelé musí mít v databázi msdb přiděleny některé z následujících pevných databázových rolí SQL Server Agent:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Podrobnosti o oprávněních těchto rolí naleznete v SQL Server Agent Fixed Database Roles.

Členové SQLAgentUserRole mohou zobrazit pouze kroky práce pro pozice, které vlastní.

Examples

A. Informace o všech krocích konkrétní práce

Následující příklad vrací všechny kroky práce pro práci s názvem Weekly Sales Data Backup.

USE msdb;
GO

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

B. Vraťte informace o konkrétním kroku práce

Následující příklad vrací informace o prvním kroku práce pro práci s názvem Weekly Sales Data Backup.

USE msdb;
GO

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

Související obsah

  • Last updated on