managed_backup.sp_set_parameter (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Define o valor do parâmetro do sistema Smart Admin especificado.

Os parâmetros disponíveis estão relacionados ao backup gerenciado do SQL Server para o Microsoft Azure. Esses parâmetros são usados para definir as notificações de email, habilitar eventos estendidos específicos e habilitar políticas de gerenciamento com base em políticas definidas pelo usuário. Você deve especificar o nome do parâmetro e os pares de valor do parâmetro.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@parameter_name [ = ] N'parameter_name'

O nome do parâmetro para o qual você quer definir o valor. @parameter_name é nvarchar(128). Os nomes de parâmetros disponíveis são:

  • SSMBackup2WANotificationEmailIds
  • SSMBackup2WADebugXevent
  • SSMBackup2WAEnableUserDefinedPolicy
  • FileRetentionDebugXevent
  • StorageOperationDebugXevent.

@parameter_value [ = ] N'parameter_value'

O valor para o parâmetro que você quer definir. @parameter_value é nvarchar(128). A tabela a seguir mostra os pares de valor e nome de parâmetro permitidos:

@parameter_name @parameter_value
'SSMBackup2WANotificationEmailIds' “email”
'SSMBackup2WAEnableUserDefinedPolicy' { 'verdadeiro' | 'falso' }
'SSMBackup2WADebugXevent' { 'verdadeiro' | 'falso' }
'FileRetentionDebugXevent' { 'verdadeiro' | 'falso' }
'StorageOperationDebugXevent' = { 'verdadeiro' | 'falso' } N/D

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer permissões EXECUTE no managed_backup.sp_set_parameter procedimento armazenado.

Exemplos

Os exemplos a seguir permitem eventos operacionais e estendidos de depuração.

-- 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';

O exemplo a seguir habilita notificações por email de erros e avisos e define o endereço de email para enviar notificações:

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