sp_help_alert (Transact-SQL)
Выдает сведения о предупреждениях, определенных для данного сервера.
.gif "Значок ссылки на раздел")
Синтаксис
sp_help_alert [ [ @alert_name = ] 'alert_name' ]
[ , [ @order_by = ] 'order_by' ]
[ , [ @alert_id = ] alert_id ]
[ , [ @category_name = ] 'category' ]
[ , [ @legacy_format = ] legacy_format ]
Аргументы
[ @alert_name =] 'alert_name'
Имя предупреждения. Аргумент alert_name имеет тип nvarchar(128). Если аргумент alert_name не указан, возвращаются сведения обо всех предупреждениях.[ @order_by =] 'order_by'
Порядок сортировки, в котором выдаются результаты. Аргумент order_by имеет тип sysname и значение, по умолчанию, N 'name'.[ @alert_id =] alert_id
Идентификационный номер предупреждения, о котором запрашиваются сведения. Аргумент alert_id имеет тип int и значение по умолчанию NULL.[ @category_name =] 'category'
Категория предупреждения. Аргумент category имеет тип sysname и значение по умолчанию NULL.[ @legacy_format=] legacy_format
Указывает, следует ли выдавать результирующий набор в старом формате. Аргумент legacy_format имеет тип bit и значение по умолчанию 0. Если аргумент legacy_format равен 1, то процедура sp_help_alert возвращает результирующий набор в том же формате, что и хранимая процедура sp_help_alert в Microsoft SQL Server 2000.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
Если значение аргумента @legacy_format равно 0, хранимая процедура sp_help_alert выдает следующий результирующий набор:
Имя столбца |
Тип данных |
Описание |
|---|---|---|
id |
int |
Присвоенный системой уникальный целочисленный идентификатор. |
name |
sysname |
Имя предупреждения (например, «Demo: переполнен журнал msdb»). |
event_source |
nvarchar(100) |
Источник события. Для Microsoft SQL Server версии 7.0 всегда будет иметь значение MSSQLServer |
event_category_id |
int |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. |
event_id |
int |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. |
message_id |
int |
Код ошибки сообщения, который определен для предупреждения (обычно соответствует номеру ошибки в таблице sysmessages). Если при определении предупреждения указана серьезность, то аргумент message_id равен 0 или NULL. |
severity |
int |
Уровень серьезности, определяемый предупреждением (от 9 до 25, 110, 120, 130 или 140). |
enabled |
tinyint |
В данный момент предупреждение включено (значение 1) или отключено (значение 0). Отправка отключенных предупреждений не производится. |
delay_between_responses |
int |
Время ожидания (в секундах) между ответами на предупреждение. |
last_occurrence_date |
int |
Дата последнего возникновения предупреждения. |
last_occurrence_time |
int |
Время последнего возникновения предупреждения. |
last_response_date |
int |
Дата последнего ответа на предупреждение от службы SQLServerAgent. |
last_response_time |
int |
Время последнего ответа на предупреждение от службы SQLServerAgent. |
notification_message |
nvarchar(512) |
Необязательное дополнительное сообщение, отправляемое оператору по электронной почте или на пейджер. |
include_event_description |
tinyint |
Указывает, следует ли включить в текст уведомления описание ошибки SQL Server из журнала приложений Microsoft Windows. |
database_name |
sysname |
База данных, ошибка в которой приводит к появлению предупреждения. Если имя базы данных равно значению NULL, предупреждение появляется независимо от места возникновения ошибки. |
event_description_keyword |
nvarchar(100) |
Описание ошибки SQL Server в журнале приложений Windows, которое должно соответствовать указанной последовательности символов. |
occurrence_count |
int |
Количество раз возникновения предупреждения. |
count_reset_date |
int |
Дата последнего сброса счетчика occurrence_count. |
count_reset_time |
int |
Время последнего сброса счетчика occurrence_count. |
job_id |
uniqueidentifier |
Идентификационный номер задания, выполняющегося при срабатывании данного предупреждения. |
job_name |
sysname |
Имя задания, выполняющегося при срабатывании данного предупреждения. |
has_notification |
int |
Ненулевое значение, если один или более операторов уведомлены данным предупреждением. Результат логической операции OR одного или нескольких следующих значений: 1=уведомлен по электронной почте; 2=уведомлен по пейджеру; 4=уведомлен через net send. |
flags |
int |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. |
performance_condition |
nvarchar(512) |
Если значение type равно 2, в этом столбце содержится определение условий производительности; в противном случае столбец содержит значение NULL. |
category_name |
sysname |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. Для SQL Server версии 7.0 всегда будет иметь значение «[Без категорий]». |
wmi_namespace |
sysname |
Если значение type равно 3, в этом столбце содержится пространство имен для события WMI. |
wmi_query |
nvarchar(512) |
Если значение type равно 3, в этом столбце отображается запрос WMI-события. |
type |
int |
Тип события: 1 — предупреждение о событии SQL Server 2 — предупреждение, касающееся производительности SQL Server 3 = Предупреждение о событии инструментария WMI. |
Если значение аргумента @legacy_format равно 1, хранимая процедура sp_help_alert выдает следующий результирующий набор:
Имя столбца |
Тип данных |
Описание |
|---|---|---|
id |
int |
Присвоенный системой уникальный целочисленный идентификатор. |
name |
sysname |
Имя предупреждения (например, «Demo: переполнен журнал msdb»). |
event_source |
nvarchar(100) |
Источник события. Для SQL Server версии 7.0 всегда будет иметь значение MSSQLServer |
event_category_id |
int |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. |
event_id |
int |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. |
message_id |
int |
Код ошибки сообщения, который определен для предупреждения (обычно соответствует номеру ошибки в таблице sysmessages). Если при определении предупреждения указана серьезность, то аргумент message_id равен 0 или NULL. |
severity |
int |
Уровень серьезности, определяемый предупреждением (от 9 до 25, 110, 120, 130 или 140). |
enabled |
tinyint |
В данный момент предупреждение включено (значение 1) или отключено (значение 0). Отправка отключенных предупреждений не производится. |
delay_between_responses |
int |
Время ожидания (в секундах) между ответами на предупреждение. |
last_occurrence_date |
int |
Дата последнего возникновения предупреждения. |
last_occurrence_time |
int |
Время последнего возникновения предупреждения. |
last_response_date |
int |
Дата последнего ответа на предупреждение от службы SQLServerAgent. |
last_response_time |
int |
Время последнего ответа на предупреждение от службы SQLServerAgent. |
notification_message |
nvarchar(512) |
Необязательное дополнительное сообщение, отправляемое оператору по электронной почте или на пейджер. |
include_event_description |
tinyint |
Указывает, следует ли включить в текст сообщения уведомления описание ошибки SQL Server из журнала приложений Windows. |
database_name |
sysname |
База данных, ошибка в которой приводит к появлению предупреждения. Если имя базы данных равно значению NULL, предупреждение появляется независимо от места возникновения ошибки. |
event_description_keyword |
nvarchar(100) |
Описание ошибки SQL Server в журнале приложений Windows, которое должно соответствовать указанной последовательности символов. |
occurrence_count |
int |
Количество раз возникновения предупреждения. |
count_reset_date |
int |
Дата последнего сброса счетчика occurrence_count. |
count_reset_time |
int |
Время последнего сброса счетчика occurrence_count. |
job_id |
uniqueidentifier |
Идентификатор задания. |
job_name |
sysname |
Задание по требованию, выполняющееся в ответ на данное предупреждение. |
has_notification |
int |
Ненулевое значение, если один или более операторов уведомлены данным предупреждением. Значение является результатом логической операции OR над одним или несколькими следующими значениями: 1=уведомлен по электронной почте; 2=уведомлен по пейджеру; 4=уведомлен через net send. |
flags |
int |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.. |
performance_condition |
nvarchar(512) |
Если значение type равно 2, в этом столбце содержится определение условия производительности. Если значение type равно 3, в этом столбце отображается запрос WMI-события. В противном случае столбец содержит значение NULL. |
category_name |
sysname |
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется. Для SQL Server версии 7.0 всегда будет иметь значение «[Без категорий]». |
type |
int |
Тип предупреждения: 1 — предупреждение о событии SQL Server 2 — предупреждение, касающееся производительности SQL Server 3 = Предупреждение о событии инструментария WMI. |
Замечания
Хранимая процедура sp_help_alert должна запускаться из базы данных msdb.
Разрешения
По умолчанию данную хранимую процедуру могут выполнять члены предопределенной роли сервера sysadmin. Другим пользователям должно быть предоставлено членство в предопределенной роли базы данных SQLAgentOperatorRole в базе данных msdb.
Дополнительные сведения о SQLAgentOperatorRole см. в разделе Предопределенные роли базы данных агента SQL Server.
Примеры
В следующем примере выдаются сведения о предупреждении Demo: Sev. 25 Errors.
USE msdb ;
GO
EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors'
GO