sp_delete_jobstep (Transact-SQL)

Entfernt einen Auftragsschritt aus einem Auftrag.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } , 
     [ @step_id = ] step_id 

Argumente

  • [ @job_id= ] job_id
    Die ID des Auftrags, aus dem der Auftragsschritt entfernt werden soll. job_id ist ein Wert vom Datentyp uniqueidentifier; der Standardwert ist NULL.

  • [ @job_name= ] 'job_name'
    Der Name des Auftrags, aus dem der Auftragsschritt entfernt werden soll. job_nameist ein Wert vom Datentyp sysname; der Standardwert ist NULL.

    HinweisHinweis

    Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich.

  • [ @step_id= ] step_id
    Die ID des Auftragsschritts, der entfernt wird. step_id ist vom Datentyp int und hat keinen Standardwert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Durch das Entfernen eines Auftragsschritts werden die anderen Auftragsschritte, die auf den gelöschten Schritt verweisen, automatisch aktualisiert.

Weitere Informationen zu den einem bestimmten Auftrag zugeordneten Schritten erhalten Sie durch Ausführen von sp_help_jobstep.

HinweisHinweis

Wird sp_delete_jobstep mit dem step_id-Wert 0 aufgerufen, werden alle Auftragsschritte für den Auftrag gelöscht.

Mit Microsoft SQL Server Management Studio lassen sich Aufträge auf einfache Weise über eine grafische Oberfläche verwalten. Dies ist die empfohlene Vorgehensweise, um die Auftragsinfrastruktur zu erstellen und zu verwalten.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen SQL Server-Agent-Datenbankrollen in der msdb-Datenbank sein:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Nur Mitglieder von sysadmin können einen Auftragsschritt löschen, dessen Besitzer ein anderer Benutzer ist.

Beispiele

Im folgenden Beispiel wird Auftragsschritt 1 aus dem Auftrag Weekly Sales Data Backup entfernt.

USE msdb ;
GO

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