Sdílet prostřednictvím

sp_delete_jobstep (Transact-SQL)

platí pro:SQL Serverazure SQL Managed Instance

Odstraní krok práce z úlohy ve službě SQL Server Agent.

Transact-SQL konvence syntaxe

Syntaxe

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @step_id = ] step_id
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Identifikační číslo práce, ze které bude krok odstraněn. @job_id je uniqueidentifier, s výchozím nastavením NULL.

Musí být uveden buď @job_id , nebo @job_name ; Obojí nelze specifikovat.

[ @job_name = ] N'job_name'

Název pozice, ze které bude tento krok odstraněn. @job_name je sysname s výchozím nastavením NULL.

Musí být uveden buď @job_id , nebo @job_name ; Obojí nelze specifikovat.

[ @step_id = ] step_id

Identifikační číslo schodu, který byl odstraněn. @step_id je inteligence, bez výchozího nastavení.

Hodnoty návratového kódu

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

Sada výsledků

Žádné.

Poznámky

Odstranění kroku práce automaticky aktualizuje ostatní kroky úkolu, které odkazují na odstraněný krok.

Pro více informací o krocích souvisejících s konkrétní úlohou použijte sp_help_jobstep.

Poznámka:

Volání sp_delete_jobstep s hodnotou @step_id nula smaže všechny kroky práce pro danou práci.

SQL Server Management Studio poskytuje snadný, grafický způsob správy úloh a je doporučený způsob, jak vytvořit a spravovat infrastrukturu úloh.

Tato uložená procedura sdílí název s sp_delete_jobstep podobným objektem pro službu Azure Elastic Jobs pro Azure SQL Database. Informace o verzi elastic jobs najdete v jobs.sp_delete_jobstep (Azure Elastic Jobs).

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.

Pouze členové sysadminu mohou smazat krok práce, který vlastní jiný uživatel.

Examples

Následující příklad odstraní krok 1 práce z úkolu Weekly Sales Data Backup.

USE msdb;
GO

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

Související obsah

  • Last updated on