managed_backup.sp_backup_on_demand (Transact-SQL)

Articolo
08/22/2024

Si applica a: SQL Server 2016 (13.x) e versioni successive

Richiede il backup gestito di SQL Server in Microsoft Azure per eseguire un backup del database specificato.

Usare questa stored procedure per eseguire backup ad hoc per un database configurato con il backup gestito di SQL Server in Microsoft Azure. Ciò impedisce interruzioni nella catena di backup e nel backup gestito di SQL Server nei processi di Microsoft Azure e il backup viene archiviato nello stesso contenitore di archiviazione BLOB di Azure.

Al termine del backup, viene restituito il percorso completo del file di backup. che include il nome e la posizione del nuovo file di backup risultante dall'operazione di backup.

Viene restituito un errore se il backup gestito di SQL Server in Microsoft Azure è in corso durante l'esecuzione di un backup del tipo specificato per il database specificato. In questo caso, il messaggio di errore restituito include il percorso del file di backup completo in cui il backup corrente viene caricato.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @database_name = ] 'nome database'

Nome del database in cui deve essere eseguito il backup. @database_name è sysname.

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

Tipo di backup da eseguire: database o log. Il @type parametro è nvarchar(32).

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Autorizzazioni

Richiede l'appartenenza a db_backupoperator ruolo del database, con autorizzazioni ALTER ANY CREDENTIAL e autorizzazioni EXECUTE per sp_delete_backuphistory la stored procedure.

Esempi

Nell'esempio seguente viene eseguita una richiesta di backup del database per il database TestDB. Questo database ha abilitato il backup gestito di SQL Server in Microsoft Azure.

USE msdb;
GO

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

Condividi tramite