NSNotificationBatchDetails (Transact-SQL)

Articolo
12/15/2008

Data aggiornamento: 14 aprile 2006

Crea un report con informazioni su un batch di notifiche per un'applicazione di Microsoft SQL Server Notification Services. In questo report sono disponibili informazioni sul batch di notifiche specificato, ad esempio sull'esecuzione di regole che ha generato il batch e sulle notifiche incluse nel batch. Utilizzare questa stored procedure per risolvere i problemi di generazione delle notifiche e analizzare lo stato delle notifiche nell'applicazione.

Sintassi

[ application_schema_name . ] NSNotificationBatchDetails 
    [ @NotificationClassName = ] 'notification_class_name',
    [ @NotificationBatchId = ] notification_batch_id

Argomenti

[ @NotificationClassName = ] 'notification_class_name'
Nome di una classe di notifica. notification_class_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @NotificationBatchId = ] notification_batch_id
Identificatore univoco utilizzato per identificare un batch di notifiche. notification_batch_id è di tipo bigint e non prevede alcun valore predefinito.

Set di risultati

NSNotificationBatchDetails genera tre set di risultati. Il primo set di risultati offre informazioni di carattere generale sul batch di notifiche.

Nome colonna	Tipo di dati	Descrizione
RuleFiringId	int	ID univoco dell'esecuzione di regole che ha generato il batch di notifiche.
StartGenerationTime	datetime	Data e ora UTC di inizio della generazione del batch di notifiche.
EndGenerationTime	datetime	Data e ora UTC di fine della generazione del batch di notifiche.
GenerationTimeInMS	int	Tempo, espresso in millisecondi, necessario per completare la generazione del batch di notifiche.
NotificationBatchExpirationTime	datetime	Data e ora UTC di scadenza del batch di notifiche. Dopo la scadenza, le notifiche che non sono ancora state consegnate vengono abbandonate. Non vengono effettuati altri tentativi di recapito, indipendentemente dalla pianificazione dei tentativi. Se il valore è NULL, per il batch non è prevista alcuna scadenza.
NotificationCount	int	Numero di notifiche nel batch di notifiche.
StatusDescription	nvarchar(255)	Stato corrente del batch di notifiche.

Il secondo set di risultati offre informazioni sulla distribuzione delle notifiche del batch tramite i canali di recapito nell'istanza.

Nome colonna	Tipo di dati	Descrizione
DeliveryChannelName	nvarchar(255)	Nome del canale di recapito.
LastDistributionStartTime	datetime	Data e ora in cui per l'ultima volta il server di distribuzione ha avviato il recapito delle notifiche da questo batch di notifiche tramite questo canale di recapito.
NotificationsWithNoDeliveryAttempt	int	Numero di notifiche che il server di distribuzione deve ancora recapitare da questo batch di notifiche tramite questo canale di recapito.
NotificationsSuccessfullyDelivered	int	Numero di recapiti di notifiche riusciti da questo batch di notifiche tramite questo canale di recapito.
NotificationsFailedToDeliver	int	Numero di recapiti di notifiche non riusciti da questo batch di notifiche per questo canale di recapito.
RetryCount	int	Numero di prelevamenti del batch di notifiche da parte del server di distribuzione per il recapito tramite questo canale di recapito.
NextRetryTime	datetime	Successiva data e ora in cui il server di distribuzione tenterà di recapitare le notifiche da questo batch di notifiche tramite questo canale di recapito.

Il terzo set di risultati offre informazioni dettagliate sulle notifiche nel batch di notifiche.

Nome colonna	Tipo di dati	Descrizione
NotificationId	bigint	ID della notifica nel batch di notifiche.
SubscriberId	nvarchar(255)	ID del sottoscrittore per la notifica.
DeviceName	nvarchar(255)	Nome del dispositivo del sottoscrittore per la notifica.
SubscriberLocale	nvarchar(10)	Nome delle impostazioni internazionali per la notifica.
DeliveryStatus	nvarchar(255)	Descrizione dello stato corrente del recapito della notifica.
SentTime	datetime	Data e ora UTC in cui è stato completato l'ultimo tentativo di recapito della notifica. Se il valore è NULL, il tentativo di recapito della notifica non è stato effettuato oppure non è stato completato.
LinkedParentNotification	bigint	Se la notifica è stata inviata in un messaggio digest o multicast, D della notifica head nel gruppo digest o multicast.
DeliveryChannel	nvarchar(255)	Nome del canale di recapito che ha inviato la notifica.
DeliveryAttempts	int	Numero di tentativi di recapito effettuati per la notifica.
Notification_class_field_name	definito dall'applicazione	Nome del campo della classe di notifica, definito nel file di definizione dell'applicazione (ADF). Ogni campo della classe di notifica è rappresentato da una colonna nel set di risultati.

Osservazioni

Notification Services crea la stored procedure NSNotificationBatchDetails nel database dell'applicazione quando viene creata l'istanza. Quando si aggiorna l'applicazione, Notification Services ricompila la stored procedure.

Questa stored procedure è disponibile nello schema dell'applicazione, specificato dall'elemento SchemaName del file di definizione dell'applicazione (ADF). Se non si specifica un nome di schema, viene utilizzato lo schema predefinito dbo.

Autorizzazioni

Le autorizzazioni di esecuzione vengono assegnate per impostazione predefinita ai membri del ruolo di database NSAnalysis, del ruolo predefinito del database db_owner e del ruolo predefinito del server sysadmin.

Valori restituiti

Nessuno

Esempi

In questo esempio vengono generati i tre set di risultati descritti più indietro in questa sezione per il batch di notifiche 1 della classe di notifiche StockNotifications.

L'applicazione utilizza le impostazioni predefinite di SchemaName, che prevedono l'inserimento di tutti gli oggetti dell'applicazione nello schema dbo.

EXEC dbo.NSNotificationBatchDetails 
    @NotificationClassName = N'StockNotifications', 
    @NotificationBatchId = 1;

Vedere anche

Cronologia modifiche

Versione	Cronologia
14 aprile 2006	Contenuto modificato: Correzione delle descrizioni delle colonne nel secondo set di risultati.

Share via