sp_help_alert (Transact-SQL)

Выдает сведения о предупреждениях, определенных для данного сервера.

Значок ссылки на разделСоглашения о синтаксическом обозначении в Transact-SQL

Синтаксис

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