managed_backup.sp_backup_on_demand (Transact-SQL)

  • Artigo

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

Solicita o backup gerenciado do SQL Server no Microsoft Azure para executar um backup do banco de dados especificado.

Use este procedimento armazenado para executar backups ad hoc para um banco de dados configurado com o backup gerenciado do SQL Server no Microsoft Azure. Isso evita qualquer quebra na cadeia de backup e os processos de backup gerenciado do SQL Server para o Microsoft Azure são reconhecidos e o backup é armazenado no mesmo contêiner de armazenamento de Blob do Azure.

Após a conclusão bem-sucedida do backup, o caminho completo do arquivo de backup é retornado. Isso inclui o nome e o local do novo arquivo de backup decorrente da operação de backup.

Um erro será retornado se o backup gerenciado do SQL Server no Microsoft Azure estiver no processo de execução de um backup de determinado tipo para o banco de dados especificado. Nesse caso, a mensagem de erro retornada inclui o caminho de arquivo do backup completo em que o backup atual está sendo carregado.

Convenções de sintaxe de Transact-SQL

Sintaxe

EXEC managed_backup.sp_backup_on_demand
    [ @database_name = ] 'database name'
    , [ @type = ] { 'Database' | 'Log' }
[ ; ]

Argumentos

@database_name [ = ] 'nome do banco de dados'

O nome do banco de dados em que o backup será executado. O @database_name é sysname.

@type [ = ] { 'Banco de dados' | 'Log' }

O tipo de backup a ser executado: Banco de Dados ou Log. O @type parâmetro é nvarchar(32).

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer associação a db_backupoperator função de banco de dados, com permissões ALTER ANY CREDENTIAL e permissões EXECUTE no sp_delete_backuphistory procedimento armazenado.

Exemplos

O exemplo a seguir faz uma solicitação de backup de banco de dados para o banco de dados TestDB. Esse banco de dados tem o backup gerenciado do SQL Server no Microsoft Azure habilitado.

USE msdb;
GO

EXEC managed_backup.sp_backup_on_demand
    @database_name = 'TestDB',
    @type = 'Database';
GO