sp_delete_backuphistory (Transact-SQL)
适用范围:SQL Server
通过删除早于指定日期的备份集条目,减小备份和还原历史记录表的大小。 执行每个备份或还原操作后,会向备份和还原历史记录表添加更多行;因此,建议定期执行 sp_delete_backuphistory
。
注意
备份和还原历史记录表驻留在 msdb
数据库中。
语法
sp_delete_backuphistory [ @oldest_date = ] oldest_date
[ ; ]
参数
[ @oldest_date = ] oldest_date
备份和还原历史记录表中保留的最早日期。 @oldest_date 为 日期/时间,没有默认值。
返回代码值
0
(成功)或 1
(失败)。
结果集
无。
注解
sp_delete_backuphistory
必须从 msdb
数据库运行并影响下表:
- backupfile
- backupfilegroup
- backupmediafamily
- backupmediaset
- backupset
- restorefile
- restorefilegroup
- restorehistory
即使所有历史记录都已被删除,物理备份文件也会保留下来。
权限
可以授予 EXECUTE
此过程的权限,但在 SQL Server 升级期间可能会重写这些权限。
示例
以下示例删除备份和还原历史记录表中早于 2023 年 1 月 14 日、12:00 的所有条目。
USE msdb;
GO
EXEC sp_delete_backuphistory @oldest_date = '2023-01-14';
GO