sp_syspolicy_delete_policy_execution_history (Transact-SQL)

  • Статья

Применимо к:SQL Server

Удаляет журнал выполнения для политик в управлении на основе политик. Эта хранимая процедура используется для удаления журнала выполнения для заданной политики или для всех политик, а также для удаления журнала выполнения до определенной даты.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_syspolicy_delete_policy_execution_history
    [ @policy_id = ] policy_id
    , [ @oldest_date = ] 'oldest_date'
[ ; ]

Аргументы

[ @policy_id = ] policy_id

Идентификатор политики, для которой требуется удалить журнал выполнения. @policy_id является int и является обязательным. Может иметь значение NULL.

[ @oldest_date = ] 'oldest_date'

Самая старая дата, для которой требуется сохранить журнал выполнения политики. Все данные журнала выполнения до этой даты удаляются. @oldest_date — дата и требуется. Может иметь значение NULL.

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

0 (успешно) или 1 (сбой).

Замечания

Необходимо выполнить sp_syspolicy_delete_policy_execution_history в контексте msdb системной базы данных.

Чтобы получить значения для @policy_id и просмотреть даты журнала выполнения, можно использовать следующий запрос:

SELECT a.name AS N'policy_name',
    b.policy_id,
    b.start_date,
    b.end_date
FROM msdb.dbo.syspolicy_policies AS a
INNER JOIN msdb.dbo.syspolicy_policy_execution_history AS b
    ON a.policy_id = b.policy_id;

Если для одного или обоих параметров указано значение NULL, применяются следующие правила.

  • Чтобы удалить весь журнал выполнения политики, укажите ЗНАЧЕНИЕ NULL для @policy_id и для @oldest_date.

  • Чтобы удалить весь журнал выполнения политики для определенной политики, укажите идентификатор политики для @policy_id и укажите значение NULL как @oldest_date.

  • Чтобы удалить журнал выполнения политики для всех политик до определенной даты, укажите значение NULL для @policy_id и укажите дату @oldest_date.

Чтобы архивировать журнал выполнения политики, можно открыть журнал журнала политик в обозреватель объектов и экспортировать журнал выполнения в файл. Чтобы получить доступ к журналу журнала политик, разверните узел "Управление политиками", щелкните правой кнопкой мыши "Управление политиками" и выберите пункт "Просмотр журнала".

Разрешения

Требуется членство в предопределенной роли базы данных Администратор istratorRole.

Важно!

Возможное повышение прав учетных данных: пользователи в роли Policy Администратор istratorRole могут создавать триггеры сервера и планировать выполнение политики, которые могут повлиять на работу экземпляра ядро СУБД. Например, пользователи в роли Policy Администратор istratorRole могут создать политику, которая может препятствовать созданию большинства объектов в ядро СУБД. Из-за этого возможного повышения прав учетных данных роль Policy Администратор istratorRole должна предоставляться только пользователям, которым доверено управление конфигурацией ядро СУБД.

Примеры

В следующем примере удаляется журнал выполнения политики до определенной даты для политики с идентификатором 7.

EXEC msdb.dbo.sp_syspolicy_delete_policy_execution_history
    @policy_id = 7,
    @oldest_date = '2019-02-16 16:00:00.000';
GO

Связанный контент