managed_backup.sp_backup_config_schedule (Transact-SQL)
Aplica-se a: SQL Server 2016 (13.x) e versões posteriores
Configura opções de agendamento automatizadas ou personalizadas para backup gerenciado do SQL Server no Microsoft Azure.
Convenções de sintaxe de Transact-SQL
Sintaxe
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'
[ ; ]
Argumentos
@database_name [ = ] 'database_name'
O nome do banco de dados para habilitar o backup gerenciado em um banco de dados específico.
Se @database_name estiver definido como NULL
, as configurações serão aplicadas no nível da instância (aplica-se a todos os novos bancos de dados criados na instância).
@scheduling_option [ = ] { 'Personalizado' | 'Sistema' }
Especifique System
para agendamento de backup controlado pelo sistema. Especifique Custom
para uma programação personalizada definida pelos outros parâmetros.
@full_backup_freq_type [ = ] { 'Diariamente' | 'Semanal' }
O tipo de frequência para a operação de backup gerenciado, que pode ser definido como Daily
ou Weekly
.
@days_of_week [ = ] 'days_of_the_week'
Os dias da semana para os backups em que @full_backup_freq_type é definido como Weekly
. Especifique nomes de cadeia de caracteres completos como Monday
. Você também pode especificar o nome de mais de um dia, separado pelo símbolo de barra vertical (|
). Por exemplo, N'Monday | Wednesday | Friday'
.
@backup_begin_time [ = ] 'hora de início da janela de backup'
A hora de início da janela de backup. Os backups não são iniciados fora da janela de tempo, que é definida por uma combinação de @backup_begin_time e @backup_duration. Formato: hh:mm
.
@backup_duration [ = ] 'comprimento da janela de backup'
A duração da janela de tempo de backup. Não há garantia de que os backups serão concluídos durante a janela de tempo definida pelo @backup_begin_time e @backup_duration. As operações de backup iniciadas nessa janela de tempo, mas que excedem a duração da janela, não serão canceladas. Formato: hh:mm
.
@log_backup_freq [ = ] 'frequência do backup de log'
Isso determina a frequência dos backups de log de transações. Esses backups ocorrem em intervalos regulares, em vez de no agendamento especificado para os backups de banco de dados. @log_backup_freq pode ser em minutos ou horas e 0:00
é válido, o que indica que não há backups de log. Desabilitar backups de log só seria apropriado para bancos de dados com um modelo de recuperação simples. Formato: hh:mm
.
Observação
Se o modelo de recuperação mudar de simples para completo, você precisará reconfigurar o @log_backup_freq de 0:00
para um valor diferente de zero.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Permissões
Requer associação na função de banco de dados db_backupoperator , com permissões ALTER ANY CREDENTIAL e permissões EXECUTE no sp_delete_backuphistory
procedimento armazenado.
Exemplos
O exemplo a seguir configura backups gerenciados para banco de dados Test
, executando backups completos diários a partir das 4h, com duração máxima de backup de 2 horas e frequência de log de 15 minutos.
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