managed_backup.sp_backup_on_demand (Transact-SQL)

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 interrupção na cadeia de backup e o backup gerenciado do SQL Server para os processos do Microsoft Azure estão cientes e o backup é armazenado no mesmo contêiner de armazenamento de Blobs 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 em 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