sp_help_alert (Transact-SQL)
Presenta información acerca de las alertas definidas en el servidor.
.gif "Icono de vínculo a temas")
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