sp_add_operator (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Cria um operador (destinatário da notificação) para uso com alertas e trabalhos.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_add_operator
    [ @name = ] 'name'
    [ , [ @enabled = ] enabled ]
    [ , [ @email_address = ] N'email_address' ]
    [ , [ @pager_address = ] N'pager_address' ]
    [ , [ @weekday_pager_start_time = ] weekday_pager_start_time ]
    [ , [ @weekday_pager_end_time = ] weekday_pager_end_time ]
    [ , [ @saturday_pager_start_time = ] saturday_pager_start_time ]
    [ , [ @saturday_pager_end_time = ] saturday_pager_end_time ]
    [ , [ @sunday_pager_start_time = ] sunday_pager_start_time ]
    [ , [ @sunday_pager_end_time = ] sunday_pager_end_time ]
    [ , [ @pager_days = ] pager_days ]
    [ , [ @netsend_address = ] N'netsend_address' ]
    [ , [ @category_name = ] 'category' ]
[ ; ]

Argumentos

@name [ = ] 'nome'

O nome de um operador (destinatário da notificação). Esse nome deve ser exclusivo e não pode conter o caractere de porcentagem (%). @name é sysname, sem padrão.

@enabled [ = ] habilitado

Indica o status atual do operador. @enabled é tinyint, com um padrão de 1 (enabled). Se 0, o operador não estiver habilitado e não receber notificações.

@email_address [ = ] N'email_address'

O endereço de email do operador. Essa cadeia de caracteres é passada diretamente para o sistema de email. @email_address é nvarchar(100), com um padrão de NULL.

Você pode especificar um endereço de email físico ou um alias para @email_address. Por exemplo:

fatmir.bregu ou fatmir.bregu@contoso.com

Observação

Você deve usar o endereço de email para Database Mail.

@pager_address [ = ] N'pager_address'

O endereço de pager do operador. Essa cadeia de caracteres é passada diretamente para o sistema de email. @pager_address é nvarchar(100), com um padrão de NULL.

@weekday_pager_start_time [ = ] weekday_pager_start_time

O tempo após o qual o SQL Server Agent envia notificação de pager para o operador especificado nos dias úteis, de segunda a sexta-feira. @weekday_pager_start_time é int, com um padrão de , que indica 9:00 da manhã em um relógio de 09000024 horas, e deve ser inserido usando o formulário HHmmss.

@weekday_pager_end_time [ = ] weekday_pager_end_time

O tempo após o qual o serviço SQL Server Agent não envia mais notificação de pager para o operador especificado nos dias úteis, de segunda a sexta-feira. weekday_pager_end_time é int, com um padrão de , que indica 18:00 em um relógio de 18000024 horas, e deve ser inserido usando o formulário HHmmss.

@saturday_pager_start_time [ = ] saturday_pager_start_time

A hora após a qual o serviço SQL Server Agent envia notificação de pager para o operador especificado aos sábados. saturday_pager_start_time é int, com um padrão de , que indica 9:00 da manhã em um relógio de 09000024 horas, e deve ser inserido usando o formulário HHmmss.

@saturday_pager_end_time [ = ] saturday_pager_end_time

O tempo após o qual o serviço SQL Server Agent não envia mais notificação de pager para o operador especificado aos sábados. @saturday_pager_end_time é int, com um padrão de , que indica 18:00 em um relógio de 18000024 horas, e deve ser inserido usando o formulário HHmmss.

@sunday_pager_start_time [ = ] sunday_pager_start_time

O tempo após o qual o serviço SQL Server Agent envia notificação de pager para o operador especificado aos domingos. @sunday_pager_start_time é int, com um padrão de , que indica 9:00 da manhã em um relógio de 09000024 horas, e deve ser inserido usando o formulário HHmmss.

@sunday_pager_end_time [ = ] sunday_pager_end_time

O tempo após o qual o serviço SQL Server Agent não envia mais notificação de pager para o operador especificado aos domingos. @sunday_pager_end_time é int, com um padrão de , que indica 18:00 em um relógio de 18000024 horas, e deve ser inserido usando o formulário HHmmss.

@pager_days [ = ] pager_days

Um número que indica os dias em que o operador está disponível para páginas (sujeito às horas de início/término especificadas). @pager_days é minúsculo, com um padrão de 0 indicar que o operador nunca está disponível para receber uma página. Os valores válidos são de 0 até 127. @pager_days é calculado somando-se os valores individuais para os dias necessários. Por exemplo, de segunda a sexta-feira é 2 + 4 + 8 + 16 + 32 = 62. A tabela a seguir lista o valor de cada dia da semana.

Valor Descrição
1 Domingo
2 Segunda-feira
4 Terça-feira
8 Quarta-feira
16 Quinta-feira
32 Sexta-feira
64 Sábado

@netsend_address [ = ] N'netsend_address'

O endereço de rede do operador para o qual a mensagem de rede é enviada. @netsend_address é nvarchar(100), com um padrão de NULL.

@category_name [ = ] 'categoria'

O nome da categoria para este operador. @category_name é sysname, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sp_add_operator deve ser executado a partir do msdb banco de dados.

Seu sistema de email deve ter um recurso de email para pager se você quiser usar a paginação.

O SQL Server Management Studio fornece um modo gráfico fácil de gerenciar trabalhos e é o modo recomendado de criar e gerenciar a infra-estrutura de trabalho.

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

O exemplo a seguir configura as informações do operador para danwi. O operador está habilitado. O SQL Server Agent envia notificações por pager de segunda a sexta-feira, das 8h às 17h.

USE msdb;
GO

EXEC dbo.sp_add_operator @name = N'Dan Wilson',
    @enabled = 1,
    @email_address = N'danwi',
    @pager_address = N'5551290AW@pager.adventure-works.com',
    @weekday_pager_start_time = 080000,
    @weekday_pager_end_time = 170000,
    @pager_days = 62;
GO

Conteúdo relacionado