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

  • Artikel

Gilt für: Azure SQL-Datenbank

Fügt einen neuen Auftrag im Azure Elastic Jobs-Dienst für Azure SQL-Datenbank hinzu.

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

Transact-SQL-Syntaxkonventionen

Syntax

[jobs].sp_add_job [ @job_name = ] 'job_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 ]
  [ , [ @job_id = ] job_id OUTPUT ]

Argumente

@job_name

Der Name des Auftrags. Der Name muss eindeutig sein und darf das Prozentzeichen (%) nicht enthalten. job_name ist nvarchar(128), ohne Standard.

@description

Die Beschreibung des Auftrags. description is nvarchar(512), with a default of NULL. Wenn die Beschreibung nicht angegeben wird, wird eine leere Zeichenfolge verwendet.

@enabled

Gibt an, ob der Zeitplan des Auftrags aktiviert ist. Aktiviert ist Bit mit dem Standardwert 0 (deaktiviert). Wenn 0der Auftrag nicht aktiviert ist und nicht gemäß seinem Zeitplan ausgeführt wird, kann er jedoch manuell ausgeführt werden. Wenn 1der Auftrag gemäß seinem Zeitplan ausgeführt wird und auch manuell ausgeführt werden kann.

@schedule_interval_type

Der Wert gibt an, wie oft der Auftrag ausgeführt werden soll. schedule_interval_type ist nvarchar(50), mit einem Standardwert von Once, und kann einer 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 als 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 0001-01-01 00:00:00:00.000000.

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 der Standardeinstellung 9999-12-31 11:59:59.0000000.

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

@job_id

Die Auftrags-ID, die dem Auftrag zugewiesen wird, wenn er erfolgreich erstellt wurde. job_id ist eine Ausgabevariable vom Typ uniqueidentifier.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

Die gespeicherte Prozedur jobs.sp_add_job muss aus der Auftrags-Agent-Datenbank ausgeführt werden, die beim Erstellen des Auftrags-Agents angegeben ist.

Nachdem jobs.sp_add_job ein Auftrag hinzugefügt wurde, können jobs.sp_add_jobstep verwendet werden, um Schritte hinzuzufügen, die die Aktivitäten für den Auftrag ausführen. Die ursprüngliche Versionsnummer des Auftrags lautet 0, die beim Hinzufügen des ersten Schritts erhöht 1 wird.

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