Share via

sp_delete_jobstep (Transact-SQL)

  • Artikel

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
    Der ID des Auftrags, aus dem der Schritt entfernt wird. job_idist vom Datentyp uniqueidentifier. Der Standardwert ist NULL.

  • [ @job_name= ] 'job_name'
    Der Name des Auftrags, aus dem der Schritt entfernt wird. job_nameist 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 Schritts, der entfernt wird. step_idist 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. Anderen Benutzern muss eine der folgenden festen Datenbankrollen des SQL Server-Agents in der msdb-Datenbank zugewiesen werden:

  • 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

Siehe auch

Verweis

sp_add_jobstep (Transact-SQL)

sp_update_jobstep (Transact-SQL)

sp_help_jobstep (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)

Konzepte

Anzeigen oder Ändern von Aufträgen