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

managed_backup.sp_backup_config_schedule
    [ [ @database_name = ] N'database_name' ]
    , [ @scheduling_option = ] { 'Custom' | 'System' }
    [ , [ @full_backup_freq_type = ] { 'Daily' | 'Weekly' } ]
    [ , [ @days_of_week = ] N'days_of_week' ]
    [ , [ @backup_begin_time = ] N'backup_begin_time' ]
    [ , [ @backup_duration = ] N'backup_duration' ]
    [ , [ @log_backup_freq = ] N'log_backup_freq' ]
[ ; ]

Argumentos

@database_name [ = ] N'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 = ] N'days_of_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 = ] N'backup_begin_time'

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 = ] N'backup_duration'

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 = ] N'log_backup_freq'

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 a pertença ao papel de banco de dados db_backupoperator , com ALTERAR QUAISQUER CREDENTIAL permissões 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

EXECUTE 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