sp_delete_jobstep (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Entfernt einen Auftragsschritt aus einem Auftrag im SQL Server-Agent-Dienst.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @job_id = ] 'job_id'

Der ID des Auftrags, aus dem der Schritt entfernt wird. @job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

Entweder @job_id oder @job_name müssen angegeben werden. Beide können nicht angegeben werden.

[ @job_name = ] N'job_name'

Der Name des Auftrags, aus dem der Schritt entfernt wird. @job_name ist "sysname" mit der Standardeinstellung "NULL.

Entweder @job_id oder @job_name müssen angegeben werden. Beide können nicht angegeben werden.

[ @step_id = ] step_id

Die ID des Schritts, der entfernt wird. @step_id ist "int" ohne Standard.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

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

Weitere Informationen zu den Schritten, die einem bestimmten Auftrag zugeordnet sind, führen Sie aus sp_help_jobstep.

Hinweis

Beim Aufrufen sp_delete_jobstep mit einem @step_id Wert von Null werden alle Auftragsschritte für den Auftrag gelöscht.

SQL Server Management Studio bietet eine einfache grafische Möglichkeit zum Verwalten von Aufträgen. Es handelt sich hierbei um die empfohlene Art und Weise zum Erstellen und Verwalten der Auftragsinfrastruktur.

Diese gespeicherte Prozedur teilt den Namen sp_delete_jobstep mit einem ähnlichen Objekt für den Azure Elastic Jobs-Dienst für Azure SQL-Datenbank. Informationen zur Version der elastischen Aufträge finden Sie unter jobs.sp_delete_jobstep (Azure Elastic Jobs) (Transact-SQL).

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Anderen Benutzern muss eine der folgenden SQL Server-Agent festen Datenbankrollen in der msdb Datenbank gewährt 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, der einem anderen Benutzer gehört.

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

Zugehöriger Inhalt