Configure the media retention (server configuration option)

Applies to: SQL Server

This topic describes how to configure the media retention server configuration option in SQL Server by using SQL Server Management Studio or Transact-SQL. The media retention option specifies the length of time to retain each backup set. The option helps protect backups from being overwritten until the specified number of days has elapsed. After you configure media retention option, you do not have to specify the length of time to retain system backups each time you perform a backup. The default value is 0 days, and the maximum value is 365 days.

In This Topic

Before You Begin

Limitations and Restrictions

  • If you use the backup medium before the set number of days has passed, SQL Server issues a warning message. SQL Server does not issue a warning unless you change the default.

Recommendations

  • This option is an advanced option and should be changed only by an experienced database administrator or certified SQL Server professional.

  • The media retention option can be overridden by using the RETAINDAYS clause of the BACKUP statement.

Security

Permissions

Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, a user must be granted the ALTER SETTINGS server-level permission. The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

Using SQL Server Management Studio

To configure the media retention option

  1. In Object Explorer, right-click a server and select Properties.

  2. Click the Database settings node.

  3. Under Backup/Restore, in the Default backup media retention box, type or select a value from 0 through 365 to set the number of days the backup medium will be retained after a database or transaction log backup.

Using Transact-SQL

To configure the media retention option

  1. Connect to the Database Engine.

  2. From the Standard bar, click New Query.

  3. Copy and paste the following example into the query window and click Execute. This example shows how to use sp_configure to set the value of the media retention option to 60 days.

USE AdventureWorks2022;  
GO  
EXEC sp_configure 'show advanced options', 1;  
GO  
RECONFIGURE ;  
GO  
EXEC sp_configure 'media retention', 60 ;  
GO  
RECONFIGURE;  
GO  
  

For more information, see Server Configuration Options (SQL Server).

Follow Up: After you configure the media retention option

The setting takes effect immediately without restarting the server.

See Also

Back Up and Restore of SQL Server Databases
BACKUP (Transact-SQL)
RECONFIGURE (Transact-SQL)
Server Configuration Options (SQL Server)
sp_configure (Transact-SQL)