sysmail_delete_log_sp (Transact-SQL)

Supprime des événements du journal de la messagerie de base de données. Supprime tous les événements du journal ou uniquement les événements correspondant à des critères de date ou de type spécifiés.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sysmail_delete_log_sp  [ [ @logged_before = ] 'logged_before' ]
    [, [ @event_type = ] 'event_type' ]

Arguments

  • [ @logged_before = ] 'logged_before'
    Supprime les entrées antérieures à la date et l'heure spécifiées par l'argument logged_before. logged_before est de type datetime avec NULL comme valeur par défaut. La valeur NULL correspond à toutes les dates.

  • [ @event_type = ] 'event_type'
    Supprime les entrées de journal du type spécifié par le paramètre event_type. event_type est de type varchar(15) sans valeur par défaut. Les entrées valides sont success, warning, error et informational. La valeur NULL correspond à tous les types d'événements.

Valeurs du code de retour

0 (succès) ou 1 (échec)

Notes

Utilisez la procédure stockée sysmail_delete_log_sp pour supprimer définitivement des entrées du journal de la messagerie de base de données. Un argument facultatif vous permet de supprimer uniquement les enregistrements les plus anciens en fournissant une date et une heure. Les événements antérieurs à cet argument sont alors supprimés. Un argument facultatif vous permet de supprimer uniquement un certain type d'événement, spécifié par l'argument event_type.

La suppression d'entrées dans le journal de la messagerie de base de données n'entraîne pas la suppression d'entrées de messages électroniques dans les tables de la messagerie de base de données. Utilisez la procédure sysmail_delete_mailitems_sp pour supprimer les messages électroniques des tables de la messagerie de base de données.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent accéder à cette procédure.

Exemples

A. Suppression de tous les événements

L'exemple suivant supprime tous les événements du journal de la messagerie de base de données.

EXECUTE msdb.dbo.sysmail_delete_log_sp ;
GO

B. Suppression des événements les plus anciens

L'exemple suivant supprime les événements du journal de la messagerie de base de données qui sont antérieurs au 9 octobre 2005.

EXECUTE msdb.dbo.sysmail_delete_log_sp
    @logged_before = 'October 9, 2005' ;
GO

C. Suppression d'un certain type d'événement

L'exemple suivant supprime tous les messages de succès du journal de la messagerie de base de données.

EXECUTE msdb.dbo.sysmail_delete_log_sp
    @event_type = 'success' ;
GO