sp_delete_backuphistory (Transact-SQL)

適用於:SQL Server

藉由刪除早於指定日期的備份集專案,以減少備份和還原記錄數據表的大小。 執行每個備份或還原作業之後,會將更多數據列新增至備份和還原記錄數據表;因此,建議您定期執行 sp_delete_backuphistory

注意

備份和還原記錄數據表位於 msdb 資料庫中。

Transact-SQL 語法慣例

語法

sp_delete_backuphistory [ @oldest_date = ] oldest_date
[ ; ]

引數

[ @oldest_date = ] oldest_date

備份和還原記錄數據表中保留的最舊日期。 @oldest_date為 datetime,沒有預設值。

傳回碼值

0 (成功)或 1 (失敗)。

結果集

無。

備註

sp_delete_backuphistory 必須從 msdb 資料庫執行,並影響下列數據表:

即使刪除所有歷程記錄,仍會保留實體備份檔。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

下列範例會刪除備份和還原記錄數據表中早於 2023 年 1 月 14 日 12:00 的所有專案。

USE msdb;
GO
EXEC sp_delete_backuphistory @oldest_date = '2023-01-14';
GO