Partager via


jobs.sp_purge_jobhistory (travaux élastiques Azure) (Transact-SQL)

S’applique à : Azure SQL Database

Supprime les enregistrements d’historique d’un travail dans le service Travaux élastiques Azure pour Azure SQL Database.

Cette procédure stockée partage le nom d’un sp_purge_jobhistory objet similaire dans SQL Server pour le service SQL Server Agent. Pour plus d’informations sur la version de SQL Server Agent, consultez sp_purge_jobhistory.

Conventions de la syntaxe Transact-SQL

Syntaxe

[jobs].sp_purge_jobhistory [ @job_name = ] 'job_name'
      [ , [ @job_id = ] job_id ]
      [ , [ @oldest_date = ] oldest_date ]

Arguments

[ @job_name = ] N’job_name'

Nom du travail dont il faut supprimer les enregistrements d'historique. @job_name est nvarchar(128), avec la valeur par défaut NULL.

Vous devez spécifier @job_id ou @job_name , mais les deux ne peuvent pas être spécifiées.

[ @job_id = ] job_id

Numéro d'identification du travail dont les enregistrements doivent être supprimés. @job_id est uniqueidentifier, avec la valeur par défaut NULL.

Vous devez spécifier @job_id ou @job_name , mais les deux ne peuvent pas être spécifiées.

[ @oldest_date = ] oldest_date

Enregistrement le plus ancien à conserver dans l'historique. @oldest_date est datetime2, avec la valeur par défaut NULL. Lorsque @oldest_date est spécifié, sp_purge_jobhistory supprime uniquement les enregistrements antérieurs à la valeur spécifiée.

Toutes les heures indiquées dans les tâches élastiques sont exprimées dans le fuseau horaire UTC.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

L’historique des travaux élastiques est automatiquement supprimé s’il a plus de 45 jours.

autorisations

Par défaut, les membres du rôle serveur fixe sysadmin peuvent exécuter cette procédure stockée. Seuls les membres de sysadmin peuvent utiliser cette procédure stockée pour modifier les attributs des travaux appartenant à d’autres utilisateurs.

Exemples

R. Supprimer l’historique d’un ancien travail

L’exemple suivant montre comment supprimer l’historique des travaux avant une date spécifique.

Connectez-vous au job_database et exécutez la commande suivante :

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

-- Delete history of a specific job's executions older than the specified date
EXEC jobs.sp_purge_jobhistory
    @job_name = 'ResultPoolsJob',
    @oldest_date = '2016-07-01 00:00:00';
GO

B. Supprimer un travail et tous ses historiques

L’exemple suivant montre comment supprimer un travail à l’aide de jobs.sp_delete_job et de l’historique de tous les travaux associés.

Connectez-vous au job_database et exécutez la commande suivante :

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

--Delete a job and all its history
EXEC jobs.sp_delete_job @job_name = 'ResultsPoolsJob';