Partilhar via

sp_add_operator (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

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

Transact-SQL convenções de sintaxe

Sintaxe

dbo.sp_add_operator
    [ @name = ] N'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 = ] N'category_name' ]
[ ; ]

Arguments

[ @name = ] N'nome'

O nome de um operador (destinatário da notificação). Este nome deve ser único e não pode conter o carácter percentagem (%). @name é sysname, sem padrão.

[ @enabled = ] ativado

Indica o estado atual do operador. @enabled é tinyint, com o padrão de 1 (ativado). Se 0, o operador não está ativado e não recebe notificações.

[ @email_address = ] N'email_address'

O endereço de e-mail do operador. Esta cadeia é passada diretamente para o sistema de e-mail. @email_address é nvarchar(100), com um padrão de NULL.

Pode especificar um endereço de e-mail físico ou um alias para @email_address. Por exemplo:

fatmir.bregu ou fatmir.bregu@contoso.com

Observação

Deve usar o endereço de e-mail para o Correio da Base de Dados.

[ @pager_address = ] N'pager_address'

O endereço do pager do operador. Esta cadeia é passada diretamente para o sistema de e-mail. @pager_address é nvarchar(100), com um padrão de NULL.

[ @weekday_pager_start_time = ] weekday_pager_start_time

A hora de início em que o serviço SQL Server Agent envia notificações de pager ao operador, de segunda a sexta-feira. @weekday_pager_start_time é int, com um padrão de 090000, que indica 9:00 da manhã num relógio de 24 horas, e deve ser introduzido usando o formulário HHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

A hora final em que o serviço SQL Server Agent deixa de enviar notificações de pager ao operador, de segunda a sexta-feira. @weekday_pager_end_time é int, com um padrão de 180000, que indica as 18:00 num relógio de 24 horas, e deve ser introduzido usando o formulário HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

A hora de início aos sábados, quando o serviço SQL Server Agent envia notificações de pager ao operador. @saturday_pager_start_time é int, com um padrão de 090000, que indica as 9:00 da manhã num relógio de 24 horas, e deve ser introduzido usando o formulário HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

A hora de fim aos sábados, quando o serviço SQL Server Agent já não envia notificações de pager para o operador. @saturday_pager_end_time é int, com um padrão de 180000, que indica 18:00 num relógio de 24 horas, e deve ser introduzido usando o formulário HHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

A hora de início é aos domingos, quando o serviço SQL Server Agent envia notificações de pager ao operador. @sunday_pager_start_time é int, com um padrão de 090000, que indica as 9:00 da manhã num relógio de 24 horas, e deve ser introduzido usando o formulário HHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

A hora de fim aos domingos, quando o serviço SQL Server Agent deixa de enviar notificações de pager ao operador. @sunday_pager_end_time é int, com um padrão de 180000, que indica as 18:00 num relógio de 24 horas, e deve ser introduzido usando o formulário HHmmss.

[ @pager_days = ] pager_days

Um número que indica os dias em que o operador está disponível para as páginas (sujeito às horas de início/fim especificadas). @pager_days é tinyint, com um padrão de 0, indicando que o operador nunca está disponível para receber uma página. Os valores válidos são de 0 através 127de . @pager_days é calculado somando os valores individuais para os dias necessários. Por exemplo, de segunda a sexta-feira é 2 + 4 + 8 + 16 + 32 = 62.

A tabela seguinte lista o valor para cada dia da semana.

Valor Description
1 Domingo
2 Monday
4 Terça-feira
8 Wednesday
16 Quinta-feira
32 Sexta-feira
64 Sábado

[ @netsend_address = ] N'netsend_address'

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

[ @category_name = ] N'category_name'

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

Se este valor for NULL, o operador é somado com uma categoria padrão de [Uncategorized]. Também pode escolher entre uma categoria existente, consultando a syscategories tabela na msdb base de dados:

SELECT name
FROM msdb.dbo.syscategories;

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

sp_add_operator deve ser executado a partir da msdb base de dados.

O seu sistema de e-mail deve ter capacidade de e-mail para pager se quiser usar paginação.

O SQL Server Management Studio fornece uma maneira gráfica fácil de gerenciar trabalhos e é a maneira recomendada de criar e gerenciar a infraestrutura de trabalho.

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Examples

O exemplo seguinte estabelece a informação do operador para danwi. O operador está ativado. O SQL Server Agent envia notificações por pager de segunda a sexta-feira, das 8h às 17h.

USE msdb;
GO

EXECUTE 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

  • Last updated on