sp_syspolicy_delete_policy_execution_history (Transact-SQL)

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

Значок ссылки на разделСинтаксические обозначения в 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 имеет тип datetime и является обязательным. Может иметь значение 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.

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

Разрешения

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

Примечание по безопасностиПримечание по безопасности

Возможное повышение прав учетных данных. Пользователи с ролью PolicyAdministratorRole могут создавать триггеры сервера и планировать выполнение политик, влияющих на работу экземпляра компонента Database Engine. Например, пользователи в роли PolicyAdministratorRole могут создать политику, которая может запретить создание большинства объектов в компоненте Database Engine. Вследствие возможного повышения прав учетных данных роль PolicyAdministratorRole должна предоставляться только пользователям, имеющим право изменять конфигурацию компонента Database Engine.

Примеры

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

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

GO