NSDiagnosticSubscriptionClass (Transact-SQL)

Articolo
12/15/2008

Crea un report di diagnostica per la classe di sottoscrizione per un'applicazione Microsoft SQL Server Notification Services. Il report contiene informazioni, ad esempio sulla data e ora di esecuzione delle regole e sul recapito delle notifiche in base alla classe di sottoscrizione, utili per risolvere i problemi relativi all'elaborazione della classe di sottoscrizione.

Sintassi

[ schema_name . ] NSDiagnosticSubscriptionClass 
    [ @ApplicationName = ] 'app_name' ,
    [ @SubscriptionClassName = ] 'subscription_class_name' 
    [, [ @ReportingInterval = ] interval ] 
    [, [ @StartDateTime = ] 'start_date_time' ] 
    [, [ @EndDateTime = ] 'end_date_time' ]

Argomenti

[ @ApplicationName = ] 'app_name'

Nome di un'applicazione definito nel file di configurazione. app_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @SubscriptionClassName = ] 'subscription_class_name'

Nome della classe di sottoscrizione definito nel file di definizione dell'applicazione (ADF). subscription_class_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @ReportingInterval = ] interval

Numero di quantum del generatore per ogni intervallo di report. Il report contiene una riga per intervallo. interval è di tipo int e il valore predefinito è 1, che indica un quantum del generatore per intervallo.

La durata del quantum viene definita nel file di definizione dell'applicazione (ADF).

[ @StartDateTime = ] 'start_date_time'

Data e ora UTC (Coordinated Universal Time o ora di Greenwich) di inizio del report. start_date_time è di tipo datetime. Il valore predefinito è @EndDateTime - (5 * QuantumDuration * @ReportingInterval). Utilizzando il valore predefinito, il set dei risultati contiene al massimo cinque righe, ognuna delle quali rappresenta un intervallo di report.

[ @EndDateTime = ] 'end_date_time'

Data e ora UTC di fine del report. end_date_time è di tipo datetime. Il valore predefinito è l'ora UTC in cui viene richiamata la stored procedure.

Set di risultati

Nome colonna	Tipo di dati	Descrizione
IntervalStartDateTime	datetime	Data e ora UTC di inizio per l'intervallo di report.
IntervalEndDateTime	datetime	Data e ora UTC di fine per l'intervallo di report.
SubscriptionsScheduledCount	int	Numero di sottoscrizioni pianificate elaborate durante l'intervallo di report.
AvgScheduledSubscriptionWaitTime	float	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il tempo di attesa medio tra l'ora pianificata per la sottoscrizione e l'ora effettiva di elaborazione della sottoscrizione.
AvgScheduledNotificationGenerationTime	float	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il tempo medio richiesto dal generatore per creare dati di notifica non elaborati in base alle sottoscrizioni pianificate.
AvgScheduledSubscriptionRuleFiringTime	float	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il tempo medio necessario per eseguire la regola di sottoscrizione pianificata.
ScheduledNotificationBatchCount	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di batch di notifiche creati.
ScheduledNotificationCount	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di notifiche create.
AvgScheduledNotificationBatchWaitTillDistribution	float	Tempo medio che un batch di notifiche generato dalle sottoscrizioni pianificate durante l'intervallo di report ha dovuto attendere prima di essere prelevato dal server di distribuzione.
ScheduledNotificationDeliveryAttempts	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di tentativi di recapito delle notifiche.
ScheduledNotificationSuccessfulDeliveries	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di recapiti di notifiche eseguiti senza errori.
ScheduledNotificationFailedAttempts	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di tentativi di recapito delle notifiche non riusciti.
ScheduledNotificationsDeliveryNotAttempted	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di tentativi di recapito delle notifiche non ancora eseguiti.
ScheduledNotificationsNotYetDelivered	int	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il numero di notifiche non ancora recapitate perché non è stato effettuato alcun tentativo di recapito o perché si sono verificati problemi durante il tentativo.
ScheduledNotificationToMessageRatio	float	Per le sottoscrizioni pianificate per l'elaborazione durante l'intervallo, è il rapporto tra le notifiche generate e i messaggi inviati.
AvgScheduledNotificationBatchSucceedDeliveryTime	float	Per il recapito digest o multicast, è possibile includere più notifiche in un unico messaggio. Questa colonna indica il numero medio di notifiche incluse nei messaggi digest o multicast.

Osservazioni

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

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

Le sottoscrizioni pianificate rientrano nell'intervallo di report quando la data e ora di esecuzione della regola pianificate sono maggiori del valore di IntervalStartDateTime e minori o uguali al valore di IntervalEndDateTime.

Per stabilire la data e l'ora UTC correnti, eseguire SELECT GETUTCDATE() in SQL Server Management Studio. L'ora UTC corrente viene calcolata in base all'ora locale corrente e all'impostazione del fuso orario del sistema operativo del computer in cui è in esecuzione SQL Server.

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

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Impostazione dei valori dell'intervallo di report, dell'ora di inizio e dell'ora di fine

Nell'esempio seguente viene illustrato come creare il report di diagnostica della classe di sottoscrizione per l'applicazione Flight e la classe di sottoscrizione FlightNotifications. L'istanza utilizza le impostazioni predefinite del database, che prevedono l'inserimento di tutti gli oggetti dell'istanza nello schema dbo.

Il report include 50 quantum del generatore per ogni intervallo di report. Il report inizia alle 17.00 del 23 maggio 2004 e finisce alle 18.00 dello stesso giorno:

EXEC dbo.NSDiagnosticSubscriptionClass 
    @ApplicationName = N'Flight', 
    @SubscriptionClassName = N'FlightSubscriptions', 
    @ReportingInterval = 50, 
    @StartDateTime = '2004-05-23 17:00', 
    @EndDateTime = '2004-05-23 18:00';

B. Utilizzo dei valori predefiniti, schema denominato

Nell'esempio seguente viene illustrato come creare il report di diagnostica della classe di sottoscrizione per l'applicazione Flight e la classe di sottoscrizione FlightNotifications. In questo esempio, la stored procedure (come tutti gli altri oggetti dell'istanza) è inclusa nello schema FlightInstance, come specificato nell'elemento SchemaName del file di configurazione dell'istanza (ICF).

Per il report vengono utilizzati i valori predefiniti, che specificano di visualizzare i dati della classe di sottoscrizione relativi agli ultimi cinque quantum del generatore.

EXEC FlightInstance.NSDiagnosticSubscriptionClass 
    @ApplicationName = N'Flight', 
    @SubscriptionClassName = N'FlightSubscriptions';

Vedere anche

Share via