sp-delete-database-backuphistory-transact-sql.md

title	sp_delete_database_backuphistory (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/14/2017
ms.prod	sql
ms.prod_service	database-engine
ms.reviewer
ms.technology	system-objects
ms.topic	language-reference
f1_keywords	sp_delete_database_backuphistory sp_delete_database_backuphistory_TSQL
dev_langs	TSQL
helpviewer_keywords	sp_delete_database_backuphistory
ms.assetid	4c237944-453d-49fb-8d0e-4596945ac147
author	stevestein
ms.author	sstein

sp_delete_database_backuphistory (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

Deletes information about the specified database from the backup and restore history tables.

Transact-SQL Syntax Conventions

Syntax

  
sp_delete_database_backuphistory [ @database_name = ] 'database_name'  

Arguments

[ @database_name = ] database_name Specifies the name of the database involved in backup and restore operations. database_name is sysname, with no default.

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Remarks

sp_delete_database_backuphistory must be run from the msdb database.

This stored procedure affects the following tables:

• backupfile

• backupfilegroup

• backupmediafamily

• backupmediaset

• backupset

• restorefile

• restorefilegroup

• restorehistory

Permissions

Requires membership in the sysadmin fixed server role.

Examples

The following example deletes all entries for the [!INCLUDEssSampleDBobject] database in the backup-and-restore history tables.

USE msdb;  
GO  
EXEC sp_delete_database_backuphistory @database_name = 'AdventureWorks2012';  
  

See Also

sp_delete_backuphistory (Transact-SQL)
Backup History and Header Information (SQL Server)