managed_backup.sp_set_parameter(Transact-SQL)

적용 대상: SQL Server 2016(13.x) 이상 버전

지정한 Smart 관리 시스템 매개 변수의 값을 설정합니다.

사용 가능한 매개 변수는 Microsoft Azure에 대한 SQL Server 관리되는 백업과 관련이 있습니다. 이러한 매개 변수는 전자 메일 알림을 설정하고 특정 확장 이벤트를 사용하도록 설정하며 사용자를 통해 정책 기반 관리 정책을 설정하는 데 사용됩니다. 매개 변수 이름과 매개 변수 값 쌍을 지정해야 합니다.

Transact-SQL 구문 표기 규칙

구문

EXEC managed_backup.sp_set_parameter
    [ @parameter_name = ] {
        N'SSMBackup2WANotificationEmailIds'
        | N'SSMBackup2WAEnableUserDefinedPolicy'
        | N'SSMBackup2WADebugXevent'
        | N'FileRetentionDebugXevent'
        | N'StorageOperationDebugXevent'
    }
    , [ @parameter_value = ] N'parameter_value'
[ ; ]

인수

[ @parameter_name = ] N'parameter_name'

값을 설정하려는 매개 변수의 이름입니다. @parameter_name nvarchar(128)입니다. 사용 가능한 매개 변수 이름은 다음과 같습니다.

• SSMBackup2WANotificationEmailIds
• SSMBackup2WADebugXevent
• SSMBackup2WAEnableUserDefinedPolicy
• FileRetentionDebugXevent
• StorageOperationDebugXevent.

[ @parameter_value = ] N'parameter_value'

설정하려는 매개 변수의 값입니다. @parameter_value nvarchar(128)입니다. 다음 표에서는 허용되는 매개 변수 이름 및 값 쌍을 보여 줍니다.

@parameter_name	@parameter_value
'SSMBackup2WANotificationEmailIds'	'email'
'SSMBackup2WAEnableUserDefinedPolicy'	{ 'true' | 'false' }
'SSMBackup2WADebugXevent'	{ 'true' | 'false' }
'FileRetentionDebugXevent'	{ 'true' | 'false' }
'StorageOperationDebugXevent' = { 'true' | 'false' }	해당 없음

반환 코드 값

0 (성공) 또는 1 (실패).

사용 권한

저장 프로시저에 대한 managed_backup.sp_set_parameter EXECUTE 권한이 필요합니다.

예제

다음 예에서는 operational 및 debug 확장 이벤트를 사용하도록 설정합니다.

-- Enable operational events
USE msdb;
GO
EXEC managed_backup.sp_set_parameter N'FileRetentionOperationalXevent', N'True';

-- Enable debug events
USE msdb;
GO
EXEC managed_backup.sp_set_parameter N'FileRetentionDebugXevent', N'True';

다음 예제에서는 오류 및 경고의 메일 알림 사용하도록 설정하고 알림을 보내기 위한 이메일 주소를 설정합니다.

USE msdb;
GO
EXEC managed_backup.sp_set_parameter @parameter_name = 'SSMBackup2WANotificationEmailIds', @parameter_value = '<email address>';