NSDiagnosticDeliveryChannel (Transact-SQL)

Artículo
12/15/2008

Genera el informe de canal de entrega para una aplicación de Microsoft SQL Server Notification Services. Este informe puede ayudarle a analizar la actividad del canal de entrega y las notificaciones con errores.

Sintaxis

[ schema_name . ] NSDiagnosticDeliveryChannel 
    [ @ApplicationName = ] 'app_name' ,
    [ @DeliveryChannelName = ] 'delivery_channel_name' 
    [, [@ReportingInterval = ] interval ] 
    [, [@StartDateTime = ] 'start_date_time' ] 
    [, [@EndDateTime = ] 'end_date_time' ]

Argumentos

[ @ApplicationName = ] 'app_name'

Nombre de una aplicación de Notification Services, tal como se define en el archivo de configuración. app_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado.

[ @DeliveryChannelName = ] 'delivery_channel_name'

Nombre de un canal de entrega, tal como se define en el archivo de configuración. delivery_channel_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado.

[ @ReportingInterval = ] interval

Número de cuantos de generador de cada intervalo de informe. El informe contiene una fila por intervalo. interval es de tipo int y su valor predeterminado es 1, lo que indica un cuanto de generador por intervalo.

La duración del cuanto se especifica en el archivo de definición de aplicación (ADF).

[ @StartDateTime = ] 'start_date_time'

Fecha y hora de inicio del informe en UTC (hora universal coordinada u hora del meridiano de Greenwich). start_date_time es de tipo datetime. El valor predeterminado es @EndDateTime - (5 * QuantumDuration * @ReportingInterval). Si se utiliza el valor predeterminado, el conjunto de resultados contiene como mucho cinco filas, y cada una de ellas representa un intervalo de informe.

[ @EndDateTime = ] 'end_date_time'

Fecha y hora de finalización del informe en UTC. end_date_time es de tipo datetime. El valor predeterminado es la hora en la que el usuario invoca el procedimiento almacenado (en UTC).

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
IntervalStartDateTime	datetime	Fecha y hora de inicio del intervalo de informe con formato UTC.
IntervalEndDateTime	datetime	Fecha y hora de finalización del intervalo de informe con formato UTC.
NotificationBatchesDelivered	int	Número de lotes de notificaciones entregados durante el intervalo de informe.
NotificationDeliveryAttempts	int	Número de intentos de entrega de notificaciones en el canal de entrega durante el intervalo de informe.
NotificationSuccessfulDeliveries	int	Número de notificaciones enviadas correctamente en el canal de entrega durante el intervalo de informe.
NotificationAttemptsFailed	int	Número de intentos de entrega de notificaciones con errores en el canal de entrega durante el intervalo de informe.
NotificationToMessageRatio	float	Durante el intervalo de informe, relación entre las notificaciones generadas y los mensajes enviados. Para la entrega de resumen o de multidifusión, un mensaje puede incluir varias notificaciones. Esta columna indica la media de notificaciones que se incluyen en los mensajes de resumen o de multidifusión.

Notas

Notification Services crea el procedimiento almacenado NSDiagnosticDeliveryChannel en la base de datos de instancias al crear la instancia. Al actualizar la instancia, Notification Services vuelve a compilar el procedimiento almacenado.

Este procedimiento almacenado se encuentra en el esquema de la instancia, que se especifica mediante el elemento SchemaName del archivo de configuración de la instancia (ICF). Si no se proporciona ningún nombre de esquema, el esquema predeterminado es dbo.

Para determinar la fecha y hora UTC actuales, ejecute SELECT GETUTCDATE() en SQL Server Management Studio. La hora UTC actual se deriva de la hora local actual y la configuración de zona horaria del sistema operativo del equipo en el que se ejecuta SQL Server.

Permisos

De forma predeterminada, los permisos de ejecución corresponden a los miembros de la función de base de datos NSAnalysis, la función fija de base de datos db_owner y la función fija de servidor sysadmin.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Especificar intervalo de informe, hora de inicio y hora de finalización

En el ejemplo siguiente se genera el informe de canal de entrega para la aplicación Flight y el canal de entrega FileChannel. La instancia utiliza la configuración predeterminada de la base de datos, que coloca todos los objetos de la instancia en el esquema dbo.

El informe incluye 50 cuantos de generador en cada fila. El informe se inicia a las 5:00 p.m. el 23 de mayo de 2004 y finaliza a las 6:00 p.m. de ese mismo día:

EXEC dbo.NSDiagnosticDeliveryChannel 
    @ApplicationName = N'Flight', 
    @DeliveryChannelName = N'FileChannel', 
    @ReportingInterval = 50, 
    @StartDateTime = '2004-05-23 17:00',
    @EndDateTime = '2004-05-23 18:00';

B. Utilizar valores predeterminados, esquema con nombre

En el ejemplo siguiente se genera el informe de canal de entrega para la aplicación Flight y el canal de entrega FileChannel. En este ejemplo, el procedimiento almacenado (al igual que el resto de los objetos de instancia) se encuentra en el esquema FlightInstance, según se especifica en el elemento SchemaName del ICF.

El informe utiliza los valores predeterminados para mostrar un cuanto de generador en cada fila y cinco cuantos de generador en total.

EXEC FlightInstance.NSDiagnosticDeliveryChannel 
    @ApplicationName = N'Flight', 
    @DeliveryChannelName = N'FileChannel';

Vea también

Compartir a través de