Delen via

sp_delete_jobstep (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Verwijdert een taakstap uit een taak in de SQL Server Agent-service.

Transact-SQL syntaxis-conventies

Syntaxis

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

Arguments

[ @job_id = ] 'job_id'

Het identificatienummer van de functie waaruit de stap wordt verwijderd. @job_id is uniqueidentifier, met als standaard .NULL

Ofwel @job_id of @job_name moet worden gespecificeerd; Beide kunnen niet worden gespecificeerd.

[ @job_name = ] N'job_name'

De naam van de functie waarvan de stap wordt verwijderd. @job_name is sysname, met als standaard .NULL

Ofwel @job_id of @job_name moet worden gespecificeerd; Beide kunnen niet worden gespecificeerd.

[ @step_id = ] step_id

Het identificatienummer van de stap wordt verwijderd. @step_id is int, zonder standaard.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Geen.

Opmerkingen

Het verwijderen van een taakstap werkt automatisch de andere taakstappen bij die naar de verwijderde stap verwijzen.

Voor meer informatie over de stappen die bij een bepaalde taak horen, voer sp_help_jobstep.

Opmerking

Aanroepen sp_delete_jobstep met een @step_id waarde van nul verwijdert alle taakstappen voor de taak.

SQL Server Management Studio biedt een eenvoudige, grafische manier om taken te beheren en is de aanbevolen manier om de taakinfrastructuur te maken en te beheren.

Deze opgeslagen procedure deelt de naam van sp_delete_jobstep met een vergelijkbaar object voor de Azure Elastic Jobs-service voor Azure SQL Database. Voor informatie over de elastic jobs-versie, zie jobs.sp_delete_jobstep (Azure Elastic Jobs).

Permissions

Je kunt rechten verlenen EXECUTE op deze procedure, maar deze rechten kunnen worden overschreven tijdens een SQL Server-upgrade.

Andere gebruikers moeten een van de volgende vaste SQL Server Agent-databaserollen in de msdb database krijgen:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Voor details over de rechten van deze rollen, zie SQL Server Agent Fixed Database Roles.

Alleen leden van de sysadmin kunnen een taakstap verwijderen die eigendom is van een andere gebruiker.

Voorbeelden

Het volgende voorbeeld verwijdert de taakstap 1 uit de taak.Weekly Sales Data Backup

USE msdb;
GO

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

Verwante inhoud

  • Last updated on