managed_backup.fn_backup_db_config (Transact-SQL)

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

Retourne 0, 1 ou plusieurs lignes avec sauvegarde managée SQL Server dans les paramètres de configuration de Microsoft Azure. Retourne 1 ligne pour la base de données spécifiée ou retourne les informations de toutes les bases de données configurées avec la sauvegarde managée SQL Server sur Microsoft Azure sur l’instance.

Utilisez cette procédure stockée pour passer en revue ou déterminer la sauvegarde managée SQL Server actuelle vers les paramètres de configuration Microsoft Azure pour une base de données ou toutes les bases de données sur une instance de SQL Server.

Conventions de la syntaxe Transact-SQL

Syntaxe

managed_backup.fn_backup_db_config ('database_name' | '' | NULL)  

Arguments

@db_name
Nom de la base de données. Le @db_name paramètre est SYSNAME. Si une chaîne vide ou une valeur NULL est passée à ce paramètre, les informations de toutes les bases de données sur l'instance de SQL Server sont retournées.

Table retournée

Nom de la colonne	Type de données	Description
db_name	SYSNAME	Nom de la base de données.
db_guid	UNIQUEIDENTIFIER	Identificateur qui identifie la base de données de façon unique.
is_availability_database	BIT	Indique si la base de données participe à un groupe de disponibilité. La valeur 1 indique que la base de données est une base de données de disponibilité, et la valeur 0 indique le contraire.
is_dropped	BIT	La valeur 1 indique que c'est une base de données supprimée.
credential_name	SYSNAME	Nom des informations d'identification SQL utilisées pour authentifier le compte de stockage. Une valeur NULL indique qu'aucune information d'identification SQL n'a été définie.
retention_days	INT	Période de rétention actuelle, en jours. La valeur NULL indique que la sauvegarde managée SQL Server sur Microsoft Azure n’a jamais été configurée pour cette base de données.
is_managed_backup_enabled	INT	Indique si la sauvegarde managée SQL Server sur Microsoft Azure est actuellement activée pour cette base de données. La valeur 1 indique que la sauvegarde managée SQL Server sur Microsoft Azure est actuellement activée et que la valeur 0 indique que la sauvegarde managée SQL Server sur Microsoft Azure est désactivée pour cette base de données.
storage_url	NVARCHAR(1024)	URL du compte de stockage.
Encryption_algorithm	NCHAR(20)	Retourne l'algorithme de chiffrement actuel à utiliser lors du chiffrement de la sauvegarde.
Encryptor_type	NCHAR(15)	Retourne le paramètre de chiffreur : certificat ou clé asymétrique.
Encryptor_name	NCHAR(max_length_of_cert/asymm_key_name)	Nom du certificat ou de la clé asymétrique.

Sécurité

Autorisations

Nécessite l’appartenance au rôle de base de données db_backupoperator avec les autorisations ALTER ANY CREDENTIAL . L’utilisateur ne doit pas être refusé aux autorisations VIEW ANY DEFINITION .

Exemples

L’exemple suivant retourne la sauvegarde managée SQL Server dans la configuration de Microsoft Azure pour « TestDB »

Pour chaque extrait de code, sélectionnez « tsql » dans le champ d'attribut de langage.

Use msdb  
GO  
SELECT * FROM managed_backup.fn_backup_db_config('TestDB')  

L’exemple suivant retourne la sauvegarde managée SQL Server vers la configuration Microsoft Azure pour toutes les bases de données sur l’instance de SQL Server sur laquelle elle est exécutée.

Use msdb  
GO  
SELECT * FROM managed_backup.fn_backup_db_config (NULL)