Partilhar via


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 no 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 nome e valor de parâmetro permitidos:

@parameter_name @parameter_value
'SSMBackup2WANotificationEmailIds' “email”
'SSMBackup2WAEnableUserDefinedPolicy' { 'verdadeiro' | 'falso' }
'SSMBackup2WADebugXevent' { 'verdadeiro' | 'falso' }
'FileRetentionDebugXevent' { 'verdadeiro' | 'falso' }
'StorageOperationDebugXevent' = { 'true' | '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>';