jobs.sp_update_job (Azure Elastic Jobs) (Transact-SQL)

  • Artikel

Gilt für: Azure SQL-Datenbank

Aktualisiert einen Auftrag, der im Azure Elastic Jobs-Dienst für Azure SQL-Datenbank erstellt wurde.

Diese gespeicherte Prozedur teilt den Namen mit sp_update_job einem ähnlichen Objekt in SQL Server für den SQL Server-Agent-Dienst. Informationen zur SQL Server-Agent-Version finden Sie unter sp_update_job.

Transact-SQL-Syntaxkonventionen

Syntax

[jobs].sp_update_job [ @job_name = ] 'job_name'
  [ , [ @new_name = ] 'new_name' ]
  [ , [ @description = ] 'description' ]
  [ , [ @enabled = ] enabled ]
  [ , [ @schedule_interval_type = ] schedule_interval_type ]
  [ , [ @schedule_interval_count = ] schedule_interval_count ]
  [ , [ @schedule_start_time = ] schedule_start_time ]
  [ , [ @schedule_end_time = ] schedule_end_time ]

Argumente

@job_name

Der Name des Auftrags, der aktualisiert werden soll. job_name ist nvarchar(128).

@new_name

Der neue Name des Auftrags. new_name ist nvarchar(128).

@description

Die Beschreibung des Auftrags. Das Beschreibungsargument ist nvarchar(512).

@enabled

Gibt an, ob der Auftragszeitplan aktiviert (1) oder nicht aktiviert (0) ist. @enabled ist bit.

@schedule_interval_type

Der Wert gibt an, wie oft der Auftrag ausgeführt werden soll. schedule_interval_type ist nvarchar(50) und kann eine der folgenden Werte sein:

  • „Once“
  • „Minutes“
  • „Hours“
  • „Days“
  • „Weeks“
  • „Months“

@schedule_interval_count

Die Anzahl der schedule_interval_count Perioden, die zwischen jeder Ausführung des Auftrags auftreten sollen. schedule_interval_count ist int mit einem Standardwert von 1. Der Wert muss größer oder gleich 1 sein.

@schedule_start_time

Das Datum, an dem Ausführung des Auftrags beginnen kann. schedule_start_time ist DATETIME2 mit der Standardeinstellung von 0001-01-01 00:00:00.0000000.

Alle Zeitangaben in elastischen Aufträgen folgen der UTC-Zeitzone.

@schedule_end_time

Das Datum, an dem die Ausführung des Auftrags beendet werden kann. schedule_end_time ist DATETIME2 mit dem Standardwert von 9999-12-31 11:59:59.0000000.

Alle Zeitangaben in elastischen Aufträgen folgen der UTC-Zeitzone.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

Nachdem jobs.sp_add_job sie ausgeführt wurde, um einen Auftrag hinzuzufügen, verwenden Sie jobs.sp_add_jobstep , um Schritte hinzuzufügen, die die Aktivitäten für den Auftrag ausführen.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Nur Mitglieder der Rolle „sysadmin“ können mithilfe dieser gespeicherten Prozedur Attribute von Aufträgen bearbeiten, die anderen Benutzern gehören.

Zugehöriger Inhalt