Хранимая процедура sp_help_operator (Transact-SQL)

Статья
08/21/2023

Применимо к:SQL Server

Предоставляет сведения об определенных для сервера операторах.

Синтаксис

  
sp_help_operator  
     { [ @operator_name = ] 'operator_name'   
     | [ @operator_id = ] operator_id }

Аргументы

[ @operator_name = ] 'operator_name' Имя оператора. operator_name — sysname. Если operator_name не задано, возвращается информация обо всех операторах.

[ @operator_id = ] operator_id Идентификационный номер оператора, для которого запрашивается информация. operator_id имеет значение int с значением NULL по умолчанию.

Заметка

Необходимо указать operator_id или operator_name, но их нельзя указать.

Значения кода возврата

0 (успешно) или 1 (сбой)

Результирующие наборы

Имя столбца	Тип данных	Описание:
id	int	Идентификационный номер оператора.
name	sysname	Имя оператора.
enabled	tinyint	Доступность оператора для получения уведомлений: 1 = Да 0 = Нет
email_address	nvarchar(100)	Адрес электронной почты оператора.
last_email_date	int	Дата, когда оператор получил последнее уведомление по электронной почте.
last_email_time	int	Время, когда оператор получил последнее уведомление по электронной почте.
pager_address	nvarchar(100)	Адрес пейджера оператора.
last_pager_date	int	Дата, когда оператор получил последнее уведомление по пейджеру.
last_pager_time	int	Время, когда оператор получил последнее уведомление по пейджеру.
weekday_pager_start_time	int	Время начала периода, в течение которого оператор доступен для уведомлений по пейджеру в рабочие дни.
weekday_pager_end_time	int	Время окончания периода, в течение которого оператор доступен для уведомлений по пейджеру в рабочие дни.
saturday_pager_start_time	int	Время начала периода, в течение которого оператор доступен для уведомлений по пейджеру по субботам.
saturday_pager_end_time	int	Время окончания периода, в течение которого оператор доступен для уведомлений по пейджеру по субботам.
sunday_pager_start_time	int	Время начала периода, в течение которого оператор доступен для уведомлений по пейджеру по воскресеньям.
sunday_pager_end_time	int	Время окончания периода, в течение которого оператор доступен для уведомлений по пейджеру по воскресеньям.
pager_days	tinyint	Битовая маска (1 = воскресенье, 64 = суббота) дня недели, указывающая, когда оператор доступен для получения уведомлений пейджера.
netsend_address	nvarchar(100)	Адрес оператора для всплывающих сетевых уведомлений.
last_netsend_date	int	Дата, когда оператор получил последнее всплывающее сетевое уведомление.
last_netsend_time	int	Время, когда оператор получил последнее всплывающее сетевое уведомление.
category_name	sysname	Имя категории операторов, к которой принадлежит этот оператор.

Замечания

sp_help_operator необходимо запустить из базы данных msdb.

Разрешения

По умолчанию эту хранимую процедуру могут выполнять только члены предопределенной роли сервера sysadmin . Другим пользователям необходимо предоставить одну из следующих предопределенных ролей агента SQL Server в базе данных msdb :

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Дополнительные сведения о разрешениях этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.

Примеры

Следующий пример предоставляет сведения об операторе François Ajenstat.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_operator  
    @operator_name = N'François Ajenstat' ;  
GO

См. также

sp_add_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
sp_update_operator (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)