sp_syspolicy_delete_policy_execution_history (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（失败）

注释

您必须在 msdb 系统数据库的上下文中运行 sp_syspolicy_delete_policy_execution_history。

若要获取 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，则下面的行为适用：

• 若要删除所有策略执行历史记录，请为两个 policy_id 和 oldest_date 均指定 NULL。

• 若要删除特定策略的所有策略执行历史记录，请为 policy_id 指定一个策略标识符，并且将 oldest_date 指定为 NULL。

• 若要删除特定日期前的所有策略的策略执行历史记录，请为 policy_id 指定 NULL，并且为 oldest_date 指定一个日期。

若要将策略执行历史记录存档，您可以在对象资源管理器中打开策略历史记录日志，然后将执行历史记录导出到某一文件中。若要访问策略历史记录日志，请展开**“管理”，右键单击“策略管理”，然后单击“查看历史记录”**。

权限

要求具有 PolicyAdministratorRole 固定数据库角色的成员身份。

安全说明
可能的凭据提升：具有 PolicyAdministratorRole 角色的用户可以创建服务器触发器并计划策略执行，这可能会影响数据库引擎实例的正常运行。例如，PolicyAdministratorRole 角色中的用户可以创建一个策略，它可能会禁止在数据库引擎中创建大多数对象。由于这种可能的凭据提升，只应将 PolicyAdministratorRole 角色授予可信任其控制数据库引擎配置的用户。

示例

下面的示例为 ID 为 7 的策略删除特定日期前的策略执行历史记录。

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

GO

请参阅

参考