managed_backup.sp_backup_config_schedule (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Configura opções de agendamento automatizado ou personalizado 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 agenda personalizada definida pelos outros parâmetros.

@full_backup_freq_type [ = ] { 'Diário' | 'Semanal' }

O tipo de frequência para a operação de backup gerenciado, que pode ser definida como Daily ou Weekly.

@days_of_week [ = ] 'days_of_the_week'

Os dias da semana para os backups quando @full_backup_freq_type está definido como Weekly. Especifique nomes de cadeia de caracteres completos, como Monday. Você também pode especificar mais de um nome de dia, separado pelo símbolo de pipe (|). 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 por @backup_begin_time e @backup_duration. As operações de backup iniciadas nessa janela de tempo, mas que excedam a duração da janela, não serão canceladas. Formato: hh:mm.

@log_backup_freq [ = ] 'frequência de 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 um valor diferente de 0:00 zero.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer associação à 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

Conteúdo relacionado