Freigeben über


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

Gilt für: Azure SQL-Datenbank

Weist den elastischen Auftragsagenten an, eine Auftragsausführung im Azure Elastic Jobs-Dienst für Azure SQL-Datenbank zu beenden.

Diese gespeicherte Prozedur teilt den Namen mit sp_stop_job einem ähnlichen Objekt in SQL Server für den SQL Server-Agent-Dienst. Informationen zur SQL Server-Agent-Version finden Sie unter sp_stop_job (Transact-SQL).For information about the SQL Server-Agent version, see sp_stop_job (Transact-SQL).

Transact-SQL-Syntaxkonventionen

Syntax

[jobs].sp_stop_job [ @job_execution_id = ] ' job_execution_id '

Argumente

@job_execution_id

Die ID der Auftragsausführung, die angehalten werden soll. job_execution_id ist eindeutiger Bezeichner mit der Standardeinstellung von NULL.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

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.

Hinweise

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

Verwenden Sie jobs.job_executions, um die job_execution_id Ausführung eines aktuellen Auftrags zu identifizieren.

Beispiele

Identifizieren und Beenden einer Auftragsausführung

Das folgende Beispiel zeigt, wie Sie eine Auftragsausführung in jobs.job_executions identifizieren und dann eine Auftragsausführung mithilfe des job_execution_idBeispiels 01234567-89ab-cdef-0123-456789abcdefabbrechen.

Stellen Sie eine Verbindung mit der job_database her, und führen Sie den folgenden Befehl aus:

--Connect to the job database specified when creating the job agent

-- View all active executions to determine job_execution_id
SELECT job_name
, job_execution_id
, job_version
, step_id
, is_active
, lifecycle
, start_time
, current_attempts
, current_attempt_start_time
, last_message
, target_group_name
, target_server_name
, target_database_name
FROM jobs.job_executions
WHERE is_active = 1 AND job_name = 'ResultPoolsJob'
ORDER BY start_time DESC;
GO

-- Cancel job execution with the specified job_execution_id
EXEC jobs.sp_stop_job '01234567-89ab-cdef-0123-456789abcdef';