Dela via

sp_delete_jobstep (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Tar bort ett jobbsteg från ett jobb i SQL Server Agent-tjänsten.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @job_id = ] 'job_id'

Identifieringsnumret för jobbet där steget kommer att tas bort. @job_id är unik identifierare, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras; Båda kan inte specificeras.

[ @job_name = ] N'job_name'

Namnet på jobbet där steget kommer att tas bort. @job_name är sysname, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras; Båda kan inte specificeras.

[ @step_id = ] step_id

Identifieringsnumret för steget tas bort. @step_id är int, utan standard.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

Att ta bort ett jobbsteg uppdaterar automatiskt de andra jobbsteg som refererar till det borttagna steget.

För mer information om stegen kopplade till ett visst jobb, kör sp_help_jobstep.

Anmärkning

Anrop sp_delete_jobstep med ett @step_id värde noll tar bort alla jobbsteg för jobbet.

SQL Server Management Studio är ett enkelt, grafiskt sätt att hantera jobb och är det rekommenderade sättet att skapa och hantera jobbinfrastrukturen.

Denna lagrade propud delar namnet på sp_delete_jobstep med ett liknande objekt för Azure Elastic Jobs-tjänsten för Azure SQL Database. För information om elastic jobs-versionen, se jobs.sp_delete_jobstep (Azure Elastic Jobs).

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Endast medlemmar i sysadmin kan ta bort ett jobbsteg som ägs av en annan användare.

Examples

Följande exempel tar bort jobbsteget 1 från jobbet Weekly Sales Data Backup.

USE msdb;
GO

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

Relaterat innehåll

  • Last updated on