managed_backup.sp_backup_on_demand (Transact-SQL)

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores

Solicita una copia de seguridad administrada de SQL Server a Microsoft Azure para realizar una copia de seguridad de la base de datos especificada.

Use este procedimiento almacenado para realizar copias de seguridad ad hoc para una base de datos configurada con copia de seguridad administrada de SQL Server en Microsoft Azure. Esto evita cualquier interrupción en la cadena de copia de seguridad y la copia de seguridad administrada de SQL Server en los procesos de Microsoft Azure son conscientes y la copia de seguridad se almacena en el mismo contenedor de Azure Blob Storage.

Tras completar correctamente la copia de seguridad, se devuelve la ruta de acceso completa del archivo de copia de seguridad. Esto incluye el nombre y la ubicación del nuevo archivo de copia de seguridad resultante de la operación de copia de seguridad.

Se devuelve un error si la copia de seguridad administrada de SQL Server en Microsoft Azure está en proceso de ejecutar una copia de seguridad de tipo determinado para la base de datos especificada. En este caso, el mensaje de error devuelto incluye la ruta de acceso al archivo de copia de seguridad completa donde la copia de seguridad actual se carga.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @database_name = ] 'nombre de la base de datos'

El nombre de la base de datos en la que se realiza la copia de seguridad. es @database_name sysname.

[ @type = ] { 'Database' | 'Log' }

Tipo de la copia de seguridad que se va a realizar: base de datos o registro. El @type parámetro es nvarchar(32).

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Permisos

Requiere la pertenencia a db_backupoperator rol de base de datos, con permisos ALTER ANY CREDENTIAL y permisos EXECUTE en sp_delete_backuphistory el procedimiento almacenado.

Ejemplos

En el ejemplo siguiente se realiza una solicitud de copia de seguridad de base de datos para la base de datos TestDB. Esta base de datos tiene habilitada la copia de seguridad administrada de SQL Server en Microsoft Azure.

USE msdb;
GO

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