smart_admin.sp_backup_on_demand (Transact-SQL)

Van toepassing op: SQL Server 2016 (13.x) en latere versies

Vraagt om door SQL Server beheerde back-up naar Microsoft Azure om een back-up van de gespecificeerde database uit te voeren.

Gebruik deze opgeslagen procedure om ad-hoc back-ups uit te voeren voor een database die is geconfigureerd met SQL Server managed back-up naar Microsoft Azure. Dit voorkomt een breuk in de back-upketen en SQL Server managed back-up naar Microsoft Azure-processen zijn hiervan op de hoogte en de back-up wordt opgeslagen in dezelfde Azure Blob-opslagcontainer.

Na succesvolle voltooiing van de back-up wordt het volledige back-upbestandpad teruggegeven. Dit omvat de naam en locatie van het nieuwe back-upbestand dat voortkomt uit de back-upoperatie.

Er wordt een foutmelding gegeven als de door SQL Server beheerde back-up naar Microsoft Azure bezig is met het uitvoeren van een back-up van het bepaalde type voor de gespecificeerde database. In dit geval bevat het teruggegeven foutbericht het volledige back-upbestandpad waar de huidige back-up naartoe wordt geüpload.

Transact-SQL syntaxis-conventies

Syntax

smart_admin.sp_backup_on_demand
    [ @database_name = ] N'database_name'
    , [ @type = ] { 'Database' | 'Log' }
[ ; ]

Arguments

[ @database_name = ] N'database_name'

De naam van de database waarop de back-up moet worden uitgevoerd. De @database_name is sysname.

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

Het type back-up dat gemaakt moet worden: Database of Log. De @type parameter is nvarchar(32).

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Permissions

Vereist lidmaatschap van db_backupoperator databaserol, met ALTER ANY CREDENTIAL permissies en EXECUTE-rechten op sp_delete_backuphistory stored procedure.

Examples

Het volgende voorbeeld doet een databaseback-upverzoek voor de database TestDB. Deze database heeft SQL Server managed back-up naar Microsoft Azure ingeschakeld.

USE msdb;
GO

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