smart_admin.set_instance_backup (Transact-SQL)

Définit les paramètres par défaut de la Sauvegarde managée SQL Server sur Windows Azure pour l'instance de SQL Server.

Utilisez cette procédure stockée pour activer la Sauvegarde managée SQL Server sur Windows Azure et configurer les paramètres par défaut d'une instance de SQL Server.

Conventions de la syntaxe Transact-SQL

Syntaxe

EXEC smart_admin.sp_set_instance_backup 
    [@enable_backup = ] { 0 | 1}
    ,[@storage_url = ] 'storageurl'
    ,[@retention_days = ] 'retention_period_in_days'
    ,[@credential_name = ] 'sql_credential_name'
    ,[@encryption_algorithm] 'name of the encryption algorithm'
    ,[@encryptor_type] {'CERTIFICATE' | 'ASYMMETRIC_KEY'}
    ,[@encryptor_name] 'name of the certificate or asymmetric key'

Arguments

• @enable\_backup
  Activez ou désactivez la Sauvegarde managée SQL Server sur Windows Azure pour la base de données spécifiée. Le paramètre @enable\_backup est BIT. Paramètre requis lors de la configuration initiale de la Sauvegarde managée SQL Server sur Windows Azure sur l'instance de SQL Server. Lorsqu'il est utilisé pour modifier la configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

• @storage\_url
  URL du compte du stockage Windows Azure. Par exemple : « https://www.blob.core.windows. net/mystorageaccount ». Le conteneur ne doit pas être inclus ici. Le paramètre @storage\_url est NVARCHAR(1024). En l'absence de spécification, la valeur d'URL de stockage est dérivée des informations enregistrées dans les informations d'identification SQL.

• @retention\_days
  Période de rétention en jours des fichiers de sauvegarde. Le paramètre @storage\_url est INT. Paramètre requis lors de la configuration initiale de la Sauvegarde managée SQL Server sur Windows Azure sur l'instance de SQL Server. Lorsqu'il est utilisé pour modifier la configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

• @credential\_name
  Nom des informations d'identification SQL utilisées pour identifier le compte de stockage Windows Azure. Le paramètre @credentail\_name est SYSNAME. Paramètre requis lors de la configuration initiale de la Sauvegarde managée SQL Server sur Windows Azure sur l'instance de SQL Server. Lorsqu'il est utilisé pour modifier la configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

• @encryption\_algorithm
  Nom de l'algorithme de chiffrement utilisé lors de la sauvegarde pour chiffrer le fichier de sauvegarde. Le paramètre @encryption\_algorithm est SYSNAME. C'est un paramètre requis lorsque vous configurez la Sauvegarde managée SQL Server sur Windows Azure pour la première fois pour la base de données. Spécifiez NO_ENCRYPTION si vous ne souhaitez pas chiffrer le fichier de sauvegarde. Si vous modifiez les paramètres de configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues. Les valeurs autorisées pour ce paramètre sont :

  • AES_128

  • AES_192

  • AES_256

  • TRIPLE_DES_3KEY

  • NO_ENCRYPTION

  Pour plus d'informations sur les algorithmes de chiffrement, consultez Choisir un algorithme de chiffrement.

• @encryptor\_type
  Type de chiffreur pour le chiffrement. Le paramètre @encryptor\_type est nvarchar(32). Vous pouvez utiliser un certificat ou une clé asymétrique comme type de chiffreur. Ce paramètre est facultatif si vous spécifiez NO_ENCRYPTION pour le paramètre @encryption\_algorithm.

• @encryptor\_name
  Nom d'un certificat ou d'une clé asymétrique qui existe, utilisé pour chiffrer la sauvegarde. Le paramètre @encryptor\_name est SYSNAME. Si vous utilisez une clé asymétrique, elle doit être configurée avec la gestion de clés extensible (EKM).

  Pour plus d'informations, consultez Gestion de clés extensible (EKM).

Valeurs des codes de retour

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

Sécurité

Autorisations

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

Exemples

Les exemples suivants activent la Sauvegarde managée SQL Server sur Windows Azure pour l'instance de SQL Server sur laquelle elle est exécutée, définit la stratégie de rétention à 30 jours, définit la destination sur « mystorageaccount », et les informations d'identification SQL « MyCredential ».

Use msdb;
Go
   EXEC smart_admin.sp_set_instance_backup
                @enable_backup=1
                ,@storage_url = 'https://mystorageaccount.blob.core.windows.net/'
                ,@retention_days=30 
                ,@credential_name='MyCredential'
                ,@encryption_algorithm ='AES_128'
                ,@encryptor_type= 'ServerCertificate'
                ,@encryptor_name='MyBackupCert';
GO

L'exemple suivant désactive la Sauvegarde managée SQL Server sur Windows Azure pour l'instance de SQL Server sur laquelle elle est exécutée.

Use msdb;
Go
EXEC smart_admin.sp_set_instance_backup
                @enable_backup=0;
GO 

Voir aussi

Concepts

Sauvegarde managée SQL Server sur Windows Azure

Sauvegarde managée SQL Server sur Windows Azure - Paramètres de rétention et de stockage