managed_backup.sp_backup_config_schedule (Transact-SQL)

适用于SQL Server 2016 (13.x) 及更高版本

为 SQL Server 托管备份配置自动或自定义计划选项,以Microsoft Azure。

Transact-SQL 语法约定

语法

EXEC managed_backup.sp_backup_config_schedule
    [ @database_name = ] 'database_name'
    , [ @scheduling_option = ] { 'Custom' | 'System' }
    , [ @full_backup_freq_type = ] { 'Daily' | 'Weekly' }
    , [ @days_of_week = ] 'days_of_the_week'
    , [ @backup_begin_time = ] 'begin time of the backup window'
    , [ @backup_duration = ] 'backup window length'
    , [ @log_backup_freq = ] 'frequency of log backup'
[ ; ]

参数

[ @database_name = ] 'database_name'

用于在特定数据库上启用托管备份的数据库名称。

如果 @database_name 设置为 NULL,则会在实例级别应用设置(适用于在实例上创建的所有新数据库)。

[ @scheduling_option = ] { 'Custom' |'System' }

System指定系统控制的备份计划。 指定 Custom 由其他参数定义的自定义计划。

[ @full_backup_freq_type = ] { 'Daily' |“Weekly” }

托管备份操作的频率类型,可以设置为 DailyWeekly

[ @days_of_week = ] 'days_of_the_week'

@full_backup_freq_type设置为Weekly备份的一周中的天数。 指定完整的字符串名称,例如 Monday。 还可以指定多个日期名称,用管道符号 (|) 分隔。 例如 N'Monday | Wednesday | Friday'

[ @backup_begin_time = ] “备份窗口的开始时间”

备份窗口的开始时间。 备份不会在时间范围之外启动,由@backup_begin_time@backup_duration的组合定义。 格式:hh:mm

[ @backup_duration = ] 'backup window length'

备份时间窗口的持续时间。 不能保证在@backup_begin_time@backup_duration定义的时间段内完成备份。 在此时间范围内启动但超过窗口持续时间的备份操作不会取消。 格式:hh:mm

[ @log_backup_freq = ] “日志备份的频率”

这决定了事务日志备份的频率。 这些备份定期进行,而不是按为数据库备份指定的计划进行。 @log_backup_freq可以是分钟或小时,并且0:00有效,表示没有日志备份。 禁用日志备份仅适用于具有简单恢复模式的数据库。 格式:hh:mm

注意

如果恢复模式从简单更改为完整,则需要将@log_backup_freq重新0:00配置为非零值。

返回代码值

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

权限

需要具有 ALTER ANY CREDENTIAL 权限和对sp_delete_backuphistory存储过程的 EXECUTE 权限db_backupoperator数据库角色的成员身份。

示例

以下示例为数据库 Test配置托管备份,从凌晨 4 点开始执行每日完整备份,最大备份持续时间为 2 小时,日志频率为 15 分钟。

USE msdb;
GO

EXEC managed_backup.sp_backup_config_schedule @database_name = 'Test',
    @scheduling_option = 'Custom',
    @full_backup_freq_type = 'Daily',
    @backup_begin_time = '04:00',
    @backup_duration = '02:00',
    @log_backup_freq = '00:15';
GO