managed_backup.fn_available_backups (Transact-SQL)

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

Retourne une table de 0, une ou plusieurs lignes de fichiers de sauvegarde disponibles pour la base de données spécifiée. Les fichiers de sauvegarde retournés sont des sauvegardes créées par la sauvegarde managée SQL Server sur Microsoft Azure.

Conventions de la syntaxe Transact-SQL

Syntaxe

managed_backup.fn_available_backups ([@database_name = ] 'database name')  

Arguments

@database_name
Nom de la base de données. Il @database_name s’agit de NVARCHAR(512).

Table retournée

La table a une contrainte cluster unique sur (database_guid, backup_start_date et first_lsn, backup_type).
Si une base de données est supprimée, puis recréée, les jeux de sauvegarde de toutes les bases de données sont retournés. La sortie est classée par database_guid, qui identifie de façon unique chaque base de données.
S'il existe des ruptures dans la séquence des LSN, indiquant qu'il existe une rupture dans la séquence de journaux de transactions consécutifs, la table contiendra une ligne spéciale pour chaque segment LSN manquant.

Nom de la colonne Type de données Description
Backup_path NVARCHAR(260) COLLATE Latin1_General_CI_AS_KS_WS URL du fichier de sauvegarde.
backup_type NVARCHAR(6) 'DB' pour la sauvegarde de base de données 'LOG' pour la sauvegarde de journal
expiration_date DATETIME Date à laquelle ce fichier doit être supprimé. Elle est déterminée en fonction de la capacité à récupérer la base de données à un point précis dans le temps au sein de la période de rétention spécifiée.
database_guid UNIQUEIDENTIFIER Valeur GUID pour la base de données spécifiée. Le GUID identifie de manière unique une base de données.
first_lsn NUMERIC(25, 0) Numéro séquentiel dans le journal correspondant au premier enregistrement ou à l'enregistrement le plus ancien du journal dans le jeu de sauvegardes Sa valeur peut être NULL.
last_lsn NUMERIC(25, 0) Numéro séquentiel dans le journal correspondant à l'enregistrement du journal suivant après le jeu de sauvegarde. Sa valeur peut être NULL.
backup_start_date DATETIME Date et heure de début de la sauvegarde
backup_finish_date NVARCHAR(128) Date et heure de fin de la sauvegarde
machine_name NVARCHAR(128) Nom de l’ordinateur sur lequel l’instance SQL Server est installée et exécutant la sauvegarde managée SQL Server sur Microsoft Azure.
last_recovery_fork_id UNIQUEIDENTIFIER Numéro d'identification du branchement de récupération de fin.
first_recovery_fork_id UNIQUEIDENTIFIER ID du branchement de récupération de début. Pour les sauvegardes de données, first_recovery_fork_guid équivaut à last_recovery_fork_guid.
fork_point_lsn NUMERIC(25, 0) Si first_recovery_fork_id n'équivaut pas à last_recovery_fork_id, il s'agit du numéro séquentiel dans le journal du point du branchement. Dans les autres cas, cette valeur est NULL.
availability_group_guid UNIQUEIDENTIFIER Si une base de données est une base de données Always On, il s’agit du GUID du groupe de disponibilité. Sinon, cette valeur est NULL.

Valeur du code de retour

0 (succès) ou 1 (échec).

Sécurité

autorisations

Nécessite des autorisations SELECT sur cette fonction.

Exemples

L’exemple suivant répertorie toutes les sauvegardes disponibles sauvegardées via la sauvegarde managée SQL Server sur Microsoft Azure pour la base de données « MyDB »

SELECT *   
FROM msdb.managed_backup.fn_available_backups ('MyDB')  
  

Voir aussi

Sauvegarde managée de SQL Server vers Microsoft Azure
Restauration à partir de sauvegardes stockées dans Windows Azure