sp_help_alert (Transact-SQL)

Presenta información acerca de las alertas definidas en el servidor.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_alert [ [ @alert_name = ] 'alert_name' ] 
     [ , [ @order_by = ] 'order_by' ] 
     [ , [ @alert_id = ] alert_id ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @legacy_format = ] legacy_format ]

Argumentos

• [ @alert_name =] 'alert_name'
  Es el nombre de la alerta. alert_name es de tipo nvarchar(128). Si no se especifica alert_name, se devuelve información sobre todas las alertas.

• [ @order_by =] 'order_by'
  Es la forma de ordenación de los resultados. order_byes de tipo sysname y su valor predeterminado es de N 'name'.

• [ @alert_id =] alert_id
  Es el número de identificación de la alerta acerca de la que se va a presentar información. alert_ides de tipo int y su valor predeterminado es NULL.

• [ @category_name =] 'category'
  Es la categoría de la alerta. category es de tipo sysname y su valor predeterminado es NULL.

• [ @legacy_format=] legacy_format
  Especifica si se va a generar un conjunto de resultados heredado. legacy_format es de tipo bit y su valor predeterminado es 0. Si legacy_format es 1, sp_help_alert devuelve el conjunto de resultados generado por sp_help_alert en Microsoft SQL Server 2000.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Si @legacy_format es 0, sp_help_alert genera el siguiente conjunto de resultados.

Nombre de columna	Tipo de datos	Descripción
id	int	Identificador entero único asignado por el sistema.
name	sysname	Nombre de la alerta (por ejemplo, Demo: registro de msdb lleno).
event_source	nvarchar(100)	Origen del evento. Siempre es MSSQLServer para Microsoft SQL Server versión 7.0.
event_category_id	int	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
event_id	int	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
message_id	int	Número del mensaje de error que define la alerta. (Normalmente se corresponde con un número de error de la tabla sysmessages). Si se utiliza la gravedad para definir la alerta, message_id es 0 o NULL.
severity	int	Nivel de gravedad (de 9 a 25, 110, 120, 130 o 140) que define la alerta.
enabled	tinyint	Estado que indica si la alerta está actualmente habilitada (1) o no (0). Las alertas no habilitadas no se envían.
delay_between_responses	int	Intervalo de espera, en segundos, entre las respuestas a la alerta.
last_occurrence_date	int	Fecha de la última vez que se produjo la alerta.
last_occurrence_time	int	Hora de la última vez que se produjo la alerta.
last_response_date	int	Fecha de la última respuesta a la alerta por parte del servicio SQLServerAgent.
last_response_time	int	Hora de la última respuesta a la alerta por parte del servicio SQLServerAgent.
notification_message	nvarchar(512)	Mensaje adicional opcional enviado al operador como parte de la notificación por correo electrónico o localizador.
include_event_description	tinyint	Indica si la descripción del error de SQL Server del registro de aplicación de Microsoft Windows se tiene que incluir en el mensaje de notificación.
database_name	sysname	Base de datos en la que debe ocurrir el error para que se desencadene la alerta. Si el nombre de la base de datos es NULL, la alerta se desencadena independientemente de dónde haya ocurrido el error.
event_description_keyword	nvarchar(100)	Descripción del error de SQL Server en el registro de aplicación de Windows que debe ser similar a la secuencia de caracteres suministrada.
occurrence_count	int	Número de veces que ha ocurrido la alerta.
count_reset_date	int	Fecha del último restablecimiento de occurrence_count.
count_reset_time	int	Hora del último restablecimiento de occurrence_count.
job_id	uniqueidentifier	Número de identificación del trabajo que se ejecutará en respuesta a una alerta.
job_name	sysname	Nombre del trabajo que se ejecutará en respuesta a una alerta.
has_notification	int	Distinto de cero si la alerta se notifica a uno o varios operadores. El valor es uno de los siguientes (con OR): 1=con notificación por correo electrónico 2=con notificación por localizador 4=con notificación net send
flags	int	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
performance_condition	nvarchar(512)	Si type es 2, esta columna muestra la definición de la condición de rendimiento; de lo contrario, la columna es NULL.
category_name	sysname	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. Siempre será '[Sin clasificar]' en SQL Server 7.0.
wmi_namespace	sysname	Si type es 3, esta columna muestra el espacio de nombres para el evento WMI.
wmi_query	nvarchar(512)	Si type es 3, esta columna muestra la consulta para el evento WMI.
type	int	Tipo de evento: 1 = Alerta de evento de SQL Server 2 = Alerta de rendimiento de SQL Server 3 = Alerta de evento WMI

Si @legacy_format es 1, sp_help_alert genera el siguiente conjunto de resultados.

Nombre de columna	Tipo de datos	Descripción
id	int	Identificador entero único asignado por el sistema.
name	sysname	Nombre de la alerta (por ejemplo, Demo: registro de msdb lleno).
event_source	nvarchar(100)	Origen del evento. Siempre es MSSQLServer para SQL Server versión 7.0.
event_category_id	int	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
event_id	int	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
message_id	int	Número del mensaje de error que define la alerta. (Normalmente se corresponde con un número de error de la tabla sysmessages). Si se utiliza la gravedad para definir la alerta, message_id es 0 o NULL.
severity	int	Nivel de gravedad (de 9 a 25, 110, 120, 130 o 140) que define la alerta.
enabled	tinyint	Estado que indica si la alerta está actualmente habilitada (1) o no (0). Las alertas no habilitadas no se envían.
delay_between_responses	int	Intervalo de espera, en segundos, entre las respuestas a la alerta.
last_occurrence_date	int	Fecha de la última vez que se produjo la alerta.
last_occurrence_time	int	Hora de la última vez que se produjo la alerta.
last_response_date	int	Fecha de la última respuesta a la alerta por parte del servicio SQLServerAgent.
last_response_time	int	Hora de la última respuesta a la alerta por parte del servicio SQLServerAgent.
notification_message	nvarchar(512)	Mensaje adicional opcional enviado al operador como parte de la notificación por correo electrónico o localizador.
include_event_description	tinyint	Indica si la descripción del error de SQL Server del registro de aplicación de Windows se tiene que incluir en el mensaje de notificación.
database_name	sysname	Base de datos en la que debe ocurrir el error para que se desencadene la alerta. Si el nombre de la base de datos es NULL, la alerta se desencadena independientemente de dónde haya ocurrido el error.
event_description_keyword	nvarchar(100)	Descripción del error de SQL Server en el registro de aplicación de Windows que debe ser similar a la secuencia de caracteres suministrada.
occurrence_count	int	Número de veces que ha ocurrido la alerta.
count_reset_date	int	Fecha del último restablecimiento de occurrence_count.
count_reset_time	int	Hora del último restablecimiento de occurrence_count.
job_id	uniqueidentifier	Número de identificación del trabajo.
job_name	sysname	Un trabajo que se ejecuta como respuesta a una alerta.
has_notification	int	Distinto de cero si la alerta se notifica a uno o varios operadores. El valor es uno de los siguientes (unidos con OR): 1=con notificación por correo electrónico 2=con notificación por localizador 4=con notificación net send
flags	int	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada..
performance_condition	nvarchar(512)	Si type es 2, esta columna muestra la definición de la condición de rendimiento. Si type es 3, esta columna muestra la consulta para el evento WMI. De lo contrario, la columna es NULL.
category_name	sysname	Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. Siempre será '[Sin clasificar]' en SQL Server 7.0.
type	int	Tipo de alerta: 1 = Alerta de evento de SQL Server 2 = Alerta de rendimiento de SQL Server 3 = Alerta de evento WMI

Comentarios

sp_help_alert se debe ejecutar desde la base de datos msdb.

Permisos

De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse la función fija de base de datos SQLAgentOperatorRole en la base de datos msdb.

Para obtener información detallada acerca de SQLAgentOperatorRole, vea Funciones fijas de base de datos del Agente SQL Server.

Ejemplos

En el siguiente ejemplo se proporciona información sobre la alerta Demo: Sev. 25 Errors.

USE msdb ;
GO

EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors'
GO

Vea también

Referencia

sp_add_alert (Transact-SQL)

sp_update_alert (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)