managed_backup.sp_backup_on_demand (Transact-SQL)

Gilt für: SQL Server 2016 (13.x) und höhere Versionen

Fordert die verwaltete SQL Server-Sicherung an Microsoft Azure an, um eine Sicherung der angegebenen Datenbank durchzuführen.

Verwenden Sie dieses gespeicherte Verfahren, um Ad-hoc-Sicherungen für eine Datenbank auszuführen, die mit sql Server verwalteter Sicherung für Microsoft Azure konfiguriert ist. Dadurch werden Unterbrechungen in der Sicherungskette und von SQL Server verwaltete Sicherungen an Microsoft Azure-Prozesse verhindert, und die Sicherung wird im selben Azure Blob Storage-Container gespeichert.

Nach erfolgreichem Abschluss der Sicherung wird der vollständige Sicherungsdateipfad zurückgegeben. Dieser schließt den Namen und den Speicherort der neuen Sicherungsdatei ein, die durch den Sichervorgang erzeugt wird.

Es wird ein Fehler zurückgegeben, wenn sql Server managed backup to Microsoft Azure in the process of executing a backup of given type for the specified database. In diesem Fall enthält die zurückgegebene Fehlermeldung den vollständigen Sicherungsdateipfad, unter dem die aktuelle Sicherung hochgeladen wird.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @database_name = ] 'Datenbankname'

Der Name der Datenbank, für die die Sicherung ausgeführt werden soll. Dies @database_name ist "sysname".

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

Der Typ der auszuführenden Sicherung: Datenbank- oder Protokollsicherung. Der @type Parameter ist nvarchar(32).

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Berechtigungen

Erfordert die Mitgliedschaft in db_backupoperator Datenbankrolle mit ALTER ANY CREDENTIAL-Berechtigungen und EXECUTE-Berechtigungen für sp_delete_backuphistory gespeicherte Prozeduren.

Beispiele

Im folgenden Beispiel wird eine Datenbanksicherungsanforderung für die Datenbank TestDBerstellt. Diese Datenbank verfügt über sql Server managed backup to Microsoft Azure enabled.

USE msdb;
GO

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