managed_backup.sp_backup_on_demand (Transact-SQL)

S’applique à : SQL Server 2016 (13.x) et versions ultérieures

Demande à SQL Server une sauvegarde managée vers Microsoft Azure d’effectuer une sauvegarde de la base de données spécifiée.

Utilisez cette procédure stockée pour effectuer des sauvegardes ad hoc pour une base de données configurée avec une sauvegarde managée SQL Server sur Microsoft Azure. Cela empêche toute rupture dans la chaîne de sauvegarde et la sauvegarde managée SQL Server sur les processus Microsoft Azure sont conscients et la sauvegarde est stockée dans le même conteneur de stockage Blob Azure.

Une fois la sauvegarde terminée, le chemin complet du fichier de sauvegarde est retourné. Il comprend le nom et l'emplacement du nouveau fichier de sauvegarde résultant de l'opération de sauvegarde.

Une erreur est retournée si la sauvegarde managée SQL Server sur Microsoft Azure est en cours d’exécution d’une sauvegarde de type donné pour la base de données spécifiée. Dans ce cas, le message d'erreur retourné comprend le chemin de fichier de sauvegarde complet où la sauvegarde est actuellement téléchargée.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @database_name = ] 'nom de la base de données'

Nom de la base de données sur laquelle la sauvegarde doit être effectuée. Est @database_namesysname.

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

Type de sauvegarde à effectuer : base de données ou journal. Le @type paramètre est nvarchar(32).

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Autorisations

Nécessite l’appartenance à db_backupoperator rôle de base de données, avec des autorisations ALTER ANY CREDENTIAL et des autorisations EXECUTE sur la sp_delete_backuphistory procédure stockée.

Exemples

L’exemple suivant effectue une demande de sauvegarde de base de données pour la base de données TestDB. Cette base de données dispose d’une sauvegarde managée SQL Server sur Microsoft Azure activée.

USE msdb;
GO

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