sysmail_delete_log_sp (Transact-SQL)

Удаляет события из журнала компонента Database Mail. Удаляются либо все события, либо только события, удовлетворяющие критериям даты или типа.

Синтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

• [ @logged_before = ] 'logged_before'
  Удаляет записи до даты и времени, указанных в аргументе logged_before. logged_before имеет тип datetime и значение по умолчанию NULL. Значение NULL соответствует всем датам.

• [ @event_type = ] 'event_type'
  Удаляет журнальные записи типа, заданного аргументом event_type. Аргумент event_type имеет тип varchar(15) и не имеет значения по умолчанию. Допустимые записи: success, warning, error и informational. NULL соответствует всем типам событий.

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Записи из журнала компонента Database Mail удаляются навсегда с помощью хранимой процедуры sysmail_delete_log_sp. Необязательный аргумент позволяет удалять записи определенной давности. Из этого следует, что удаляются события, созданные ранее даты, заданной в аргументе. Необязательный аргумент позволяет удалять только события определенного типа, заданного с помощью аргумента event_type.

При удалении записей из журнала компонента Database Mail записи электронной почты не удаляются из таблиц Database Mail. Для удаления электронной почты из таблиц компонента Database Mail используется хранимая процедура sysmail_delete_mailitems_sp.

Разрешения

Эта процедура доступна только для членов предопределенной роли сервера sysadmin.

Примеры

А.Удаление всех событий

В следующем примере из журнала компонента Database Mail удаляются все события.

EXECUTE msdb.dbo.sysmail_delete_log_sp ;
GO

Б.Удаление самых старых событий

В следующем примере из журнала компонента Database Mail удаляются события, созданные до 9 октября 2005 года.

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

В.Удаление всех событий определенного типа

В следующем примере из журнала компонента Database Mail удаляются все сообщения «success».

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

См. также

Справочник

sysmail_event_log (Transact-SQL)

sysmail_delete_mailitems_sp (Transact-SQL)

Основные понятия

Создание задания агента SQL Server по архивации сообщений компонента Database Mail и журналов событий базы данных