NSDiagnosticDeliveryChannel (Transact-SQL)

Article
12/15/2008

Génère le rapport du canal de remise pour une application Microsoft SQL Server Notification Services. Ce rapport peut vous aider à analyser l'activité du canal de remise et les échecs de notification.

Syntaxe

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

Arguments

[ @ApplicationName = ] 'app_name'

Nom d'une application Notification Services, tel qu'il est défini dans le fichier de configuration. L'argument app_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @DeliveryChannelName = ] 'delivery_channel_name'

Nom d'un canal de remise, tel qu'il est défini dans le fichier de configuration. L'argument delivery_channel_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @ReportingInterval = ] interval

Nombre de quanta de générateur dans chaque intervalle de rapport. Le rapport contient une ligne par intervalle. L'argument interval est de type int, avec 1 comme valeur par défaut pour indiquer un quantum de générateur par intervalle.

La durée du quantum est définie dans le fichier de définition de l'application.

[ @StartDateTime = ] 'start_date_time'

Date et heure de début du rapport au format UTC (Coordinated Universal Time) ou GMT (Greenwich Mean Time). L'argument start_date_time est de type datetime. La valeur par défaut est @EndDateTime - (5 * QuantumDuration * @ReportingInterval). Avec la valeur par défaut, l'ensemble de résultats contient cinq lignes au plus, chacune d'elles représentant un intervalle de rapport.

[ @EndDateTime = ] 'end_date_time'

Date et heure de fin de rapport, en heure UTC. L'argument end_date_time est de type datetime. La valeur par défaut est l'heure à laquelle vous appelez la procédure stockée (au format UTC).

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Notification Services crée la procédure stockée NSDiagnosticDeliveryChannel dans la base de données de l'instance lorsque vous créez l'instance. Lorsque vous mettez à jour l'instance, Notification Services recompile la procédure stockée.

Cette procédure stockée se trouve dans le schéma de l'instance, spécifié par l'élément SchemaName du fichier de définition de l'instance. Si aucun nom de schéma n'est spécifié, le schéma par défaut est dbo.

Pour déterminer la date et l'heure UTC actuelles, exécutez SELECT GETUTCDATE() dans SQL Server Management Studio. L'heure UTC actuelle est dérivée de l'heure actuelle locale et du paramètre de fuseau horaire du système d'exploitation de l'ordinateur exécutant SQL Server.

Autorisations

Les autorisations d'exécution sont octroyées par défaut aux membres du rôle de base de données NSAnalysis, du rôle de base de données fixe db_owner et du rôle de serveur fixe sysadmin.

Ensembles de résultats

Nom de la colonne	Type de données	Description
IntervalStartDateTime	datetime	Date et heure du début de l'intervalle de rapport au format UTC.
IntervalEndDateTime	datetime	Date et heure de fin de l'intervalle de rapport au format UTC.
NotificationBatchesDelivered	int	Nombre de lots de notifications remis pendant l'intervalle de rapport.
NotificationDeliveryAttempts	int	Nombre de tentatives de remise de notification via le canal de remise pendant l'intervalle de rapport.
NotificationSuccessfulDeliveries	int	Nombre de notifications qui ont pu être envoyées via le canal de remise pendant l'intervalle de rapport.
NotificationAttemptsFailed	int	Nombre de tentatives de remise de notifications ayant échoué via le canal de remise pendant l'intervalle de rapport.
NotificationToMessageRatio	float	Pendant l'intervalle de rapport, ratio des notifications générées/messages envoyés. Pour une remise de type digest ou par multidiffusion, un seul message peut inclure plusieurs notifications. Cette colonne indique le nombre de notifications incluses en moyenne dans des messages de type digest ou par multidiffusion.

Exemples

A. Spécification de l'intervalle de rapport ainsi que des heures de début et de fin

L'exemple suivant génère le rapport du canal de remise pour l'application Flight et le canal de remise FileChannel. L'instance utilise les paramètres de base de données par défaut, qui placent tous les objets de l'instance dans le schéma dbo.

Le rapport inclut 50 quanta de générateur dans chaque ligne. Il commence à 17 heures le 23 mai 2004 et se termine à 18 heures le même jour :

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

B. Utilisation de valeurs par défaut et d'un schéma nommé

L'exemple suivant génère le rapport du canal de remise pour l'application Flight et le canal de remise FileChannel. Dans cet exemple, la procédure stockée (comme tous les objets de l'instance) se trouve dans le schéma FlightInstance, comme spécifié dans l'élément SchemaName du fichier de configuration de l'instance.

Le rapport utilise des valeurs par défaut, qui indiquent qu'il faut présenter un quantum de générateur dans chaque ligne et cinq quanta de générateur au total.

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

Voir aussi