smart_admin.set_instance_backup (Transact-SQL)

项目
11/25/2014

为SQL Server 托管备份到 Windows Azure设置 SQL Server 实例的默认设置。

使用此存储过程启用SQL Server 托管备份到 Windows Azure并配置 SQL Server 实例的默认设置。

适用范围：SQL Server（SQL Server 2014 至当前版本）。

语法

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'

参数

@enable\_backup
启用或禁用指定数据库的 SQL Server 托管备份到 Windows Azure。 @enable\_backup 是 BIT。在首次为 SQL Server 的实例配置SQL Server 托管备份到 Windows Azure时是必需的参数。当用于更改SQL Server 托管备份到 Windows Azure配置时，此参数是可选参数。如果不指定，则会保留现有的配置值。
@storage\_url
Windows Azure 存储帐户的 URL。例如：“https://www.blob.core.windows. net/mystorageaccount”。其中不应包含容器。 @storage\_url 是 NVARCHAR(1024)。如果未指定，则将从存储在 SQL 凭据中的信息派生存储 URL 值。
@retention\_days
备份文件的保持期（以天为单位）。 @storage\_url 是 INT。在首次为 SQL Server 的实例配置SQL Server 托管备份到 Windows Azure时是必需的参数。当用于更改SQL Server 托管备份到 Windows Azure配置时，此参数是可选参数。如果不指定，则会保留现有的配置值。
@credential\_name
用于验证 Windows Azure 存储帐户身份的 SQL 凭据的名称。 @credentail\_name 是 SYSNAME。在首次为 SQL Server 的实例配置SQL Server 托管备份到 Windows Azure时是必需的参数。当用于更改SQL Server 托管备份到 Windows Azure配置时，此参数是可选参数。如果不指定，则会保留现有的配置值。
@encryption\_algorithm
备份过程中用于加密备份文件的加密算法的名称。 @encryption\_algorithm 是 SYSNAME。在首次为数据库配置 SQL Server 托管备份到 Windows Azure 时，它是必需的参数。如果不想加密备份文件，则指定 NO_ENCRYPTION。在更改 SQL Server 托管备份到 Windows Azure 配置设置时，此参数是可选参数；如果不指定，则会保留现有的配置值。此参数的允许值包括：
- AES_128
- AES_192
- AES_256
- TRIPLE_DES_3KEY
- NO_ENCRYPTION
有关加密算法的详细信息，请参阅选择加密算法
@encryptor\_type
用于加密的加密程序的类型。 @encryptor\_type 是 nvarchar(32)。您可以将非对称密钥或证书用作加密程序类型。如果为 @encryption\_algorithm 参数指定 NO_ENCRYPTION，则此参数是可选参数。
@encryptor\_name
要用于加密备份的现有证书或非对称密钥的名称。 @encryptor\_name 是 SYSNAME。如果使用非对称密钥，则必须使用扩展密钥管理 (EKM) 进行配置。

有关详细信息，请参阅可扩展的密钥管理 (EKM)。

返回代码值

0（成功）或 1（失败）

安全性

权限

要求具有 ALTER ANY CREDENTIAL 权限的 db_backupoperator 数据库角色的成员身份，以及对 sp_delete_backuphistory 存储过程的 EXECUTE 权限。

示例

以下示例启用在所在 SQL Server 实例上执行的SQL Server 托管备份到 Windows Azure，将保持策略设置为 30 天，将目标设置为“mystorageaccount”并且将 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

以下示例禁用在所在 SQL Server 实例上执行的SQL Server 托管备份到 Windows Azure。

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

Share via

smart_admin.set_instance_backup (Transact-SQL)

语法

参数

返回代码值

安全性

权限

示例

请参阅

概念

其他资源