managed_backup.sp_backup_config_advanced (Transact-SQL)

適用対象: SQL Server 2016 (13.x) 以降のバージョン

Microsoft Azure への SQL Server マネージド バックアップの詳細設定を構成します。

Transact-SQL 構文表記規則

構文

EXEC managed_backup.sp_backup_config_advanced
    [ @database_name = ] 'database_name'
    , [ @encryption_algorithm = ] 'name of the encryption algorithm'
    , [ @encryptor_type = ] { 'CERTIFICATE' | 'ASYMMETRIC_KEY' }
    , [ @encryptor_name = ] 'name of the certificate or asymmetric key'
    , [ @local_cache_path = ] 'NOT AVAILABLE'
[ ; ]

引数

[ @database_name = ] 'database_name'

特定のデータベースでマネージド バックアップを有効にするためのデータベース名。

@database_nameが NULL に設定されている場合、設定はインスタンス レベルで適用されます (インスタンスで作成されたすべての新しいデータベースに適用されます)。

[ @encryption_algorithm ] = '暗号化アルゴリズムの名前'

バックアップ ファイルを暗号化するためにバックアップ中に使用される暗号化アルゴリズムの名前。 @encryption_algorithmは sysname です。 これは、データベースに対して初めて Microsoft Azure への SQL Server マネージド バックアップを構成するときに必要なパラメーターです。 バックアップ ファイルを暗号化しないかどうかを指定 NO_ENCRYPTION します。 SQL Server マネージド バックアップを Microsoft Azure 構成設定に変更する場合、このパラメーターは省略可能です。 パラメーターが指定されていない場合は、既存の構成値が保持されます。 このパラメーターに使用できる値は次のとおりです。

  • AES_128
  • AES_192
  • AES_256
  • TRIPLE_DES_3KEY
  • NO_ENCRYPTION

暗号化アルゴリズムの詳細については、「 Choose an Encryption Algorithm」をご覧ください。

[ @encryptor_type = ] { 'CERTIFICATE' |'ASYMMETRIC_KEY' }

暗号化器の種類。いずれかCERTIFICATEASYMMETRIC_KEYまたは指定できます。 @encryptor_typeは nvarchar(32) です。 @encryption_algorithm パラメーターに指定NO_ENCRYPTIONする場合、このパラメーターは省略可能です。

[ @encryptor_name = ] '証明書または非対称キーの名前'

バックアップの暗号化に使用する既存の証明書または非対称キーの名前。 @encryptor_nameは sysname です。 非対称キーを使用する場合は、拡張キー管理 (EKM) を使用して構成する必要があります。 @encryption_algorithm パラメーターに指定NO_ENCRYPTIONする場合、このパラメーターは省略可能です。

詳しくは、「拡張キー管理 (EKM)」をご覧ください。

[ @local_cache_path = ] 'NOT AVAILABLE'

このパラメーターはまだサポートされていません。

リターン コードの値

0 (成功) または 1 (失敗)。

アクセス許可

ALTER ANY CREDENTIAL 権限とストアド プロシージャに対する EXECUTE 権限を持つ、db_backupoperator データベース ロールのメンバーシップが sp_delete_backuphistory 必要です。

次の例では、SQL Server のインスタンスに対して、SQL Server マネージド バックアップの高度な構成オプションを Microsoft Azure に設定します。

USE msdb;
GO

EXEC managed_backup.sp_backup_config_advanced @encryption_algorithm = 'AES_128',
    @encryptor_type = 'CERTIFICATE',
    @encryptor_name = 'MyTestDBBackupEncryptCert'
GO