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_nameNULL に設定されている場合、設定はインスタンス レベルで適用されます (インスタンスに作成されたすべての新しいデータベースに適用されます)。

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

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

  • AES_128
  • AES_192
  • AES_256
  • TRIPLE_DES_3KEY
  • NO_ENCRYPTION

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

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

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

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

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

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

[ @local_cache_path = ] 'NOT AVAILABLE'

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

リターン コードの値

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

アクセス許可

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

次の例では、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