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 (Transact-SQL).
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
Nom du travail dont il faut supprimer les enregistrements d'historique. job_name est nvarchar(128), avec la valeur par défaut NULL
. Job_id ou job_name doivent être spécifiés, mais les deux ne peuvent pas être spécifiées.
@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
. Job_id ou job_name doivent être spécifiés, mais les deux ne peuvent pas être spécifiées.
@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.
Codet de retour
0 (réussite) ou 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 des membres de sysadmin peuvent utiliser cette procédure stockée pour modifier les attributs des travaux qui appartiennent à d’autres utilisateurs.
Exemples
Supprimer l’historique d’un ancien travail
L’exemple suivant montre comment supprimer l’historique d’un travail 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
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';
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour