Compartir a través de


sp_help_alert (Transact-SQL)

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

Icono de vínculo a temasConvenciones 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