Share via

  • Статья

xp_logevent (Transact-SQL)

Заносит определенное пользователем сообщение в файл журнала SQL Server и в средство просмотра событий Windows Event Viewer. Процедура xp_logevent может использоваться для отправки предупреждения без отправки сообщения клиенту.

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

Синтаксис

xp_logevent { error_number , 'message' } [ , 'severity' ]

Аргументы

  • error_number
    Номер пользовательской ошибки, больший 50 000. Максимальное значение равно 2 147 483 647 (2^31 - 1).

  • 'message'
    Символьная строка, которая может содержать не более 2048 символов.

  • 'severity'
    Одна из трех символьных строк: INFORMATIONAL, WARNING или ERROR. severity является необязательной, и значение по умолчанию — INFORMATIONAL.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Для приведенного примера кода процедура xp_logevent возвращает следующую строку ошибки:

The command(s) completed successfully.

Замечания

Если сообщения отправляются из процедур Transact-SQL, триггеров, пакетов и т. п., следует использовать инструкцию RAISERROR вместо процедуры xp_logevent. Процедура xp_logevent не вызывает обработчик сообщений клиента или устанавливает @@ERROR. Чтобы записывать сообщения в средство просмотра событий Windows и в файл журнала ошибок SQL Server внутри экземпляра SQL Server, следует выполнить инструкцию RAISERROR.

Разрешения

Необходимо членство в предопределенной роли базы данных db_owner в базе данных master или членство в предопределенной роли сервера sysadmin.

Примеры

Следующий пример записывает в журнал сообщение с переменными, переданными в сообщение, в средство просмотра событий Windows.

DECLARE @@TABNAME varchar(30)
DECLARE @@USERNAME varchar(30)
DECLARE @@MESSAGE varchar(255)
SET @@TABNAME = 'customers'
SET @@USERNAME = USER_NAME()
SELECT @@MESSAGE = 'The table ' + @@TABNAME + ' is not owned by the user 
   ' + @@USERNAME + '.'

USE master
EXEC xp_logevent 60000, @@MESSAGE, informational