NSAdministrationHistory (Transact-SQL)

Articolo
12/15/2008

Genera il report della cronologia amministrativa per un'istanza di Microsoft SQL Server Notification Services. Il report contiene informazioni su tutte le applicazioni ospitate dall'istanza, inclusi eventi, notifiche e sottoscrizioni elaborati durante l'intervallo di tempo specificato.

Sintassi

[ schema_name . ] NSAdministrationHistory 
    [  [ @ApplicationName = ] 'app_name' ],
    [, [ @ReportingIntervalInMinutes = ] interval ] 
    [, [ @StartDateTime = ] 'start_date_time' ] 
    [, [ @EndDateTime = ] 'end_date_time' ]

Argomenti

[ @ApplicationName = ] 'app_name'

Nome dell'applicazione di Notification Services definito nel file di configurazione dell'istanza. app_name è di tipo nvarchar(255) e il valore predefinito è NULL, che indica che il report deve riguardare tutte le applicazioni ospitate dall'istanza.

[ @ReportingIntervalInMinutes = ] interval

Numero di minuti di ogni intervallo di report. Il report contiene una riga per intervallo. interval è di tipo int e il valore predefinito è 60, che indica 60 minuti per intervallo di report.

[ @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 e il valore predefinito è il valore di @EndDateTime meno un mese.

[ @EndDateTime = ] 'end_date_time'

Data e ora UTC di fine del report. Il valore di end_date_time è di tipo datetime. Il valore predefinito è il risultato della funzione GETUTCDATE, che restituisce la data e l'ora in cui la stored procedure è stata richiamata.

Set di risultati

Nome colonna	Tipo di dati	Descrizione
ApplicationName	nvarchar(255)	Nome dell'applicazione di cui la riga fornisce il riepilogo. Questo valore è NULL per la riga che fornisce il riepilogo dell'istanza.
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.
EventBatchCollectedCount	int	Numero di batch di eventi raccolti durante l'intervallo di report, in base al valore di EndCollectionTime per i batch di eventi.
EventsCollectedCount	int	Numero di eventi raccolti durante l'intervallo di report, in base al valore di EndCollectionTime per il batch di eventi.
EventsCollectedPerSecond	float	Durante la raccolta di eventi, numero medio di eventi raccolti al secondo durante l'intervallo di report.
EventBatchesAwaitingGeneration	int	Numero di batch di eventi scritti nel database ma non elaborati dal generatore.
EventBatchesInCollection	int	Numero di batch di eventi nella fase di raccolta degli eventi durante l'intervallo di report.
NotificationBatchGeneratedCount	int	Numero di batch di notifiche scritti durante l'intervallo di report, in base al valore di EndGenerationTime per i batch di notifiche.
NotificationsGeneratedCount	int	Numero di notifiche generate durante l'intervallo di report, in base al valore di EndGenerationTime per i batch di notifiche.
NotificationsGeneratedPerSecond	float	Numero medio di notifiche generate al secondo durante l'intervallo di report.
NotificationBatchesInGeneration	int	Numero di batch di notifiche in fase di creazione durante l'intervallo di report.
NotificationBatchesAwaitingDistribution	int	Numero di batch di notifiche in attesa di essere prelevati dal distributore nell'intervallo di report.
NotificationsSuccessfulDeliveredCount	int	Numero di notifiche recapitate senza problemi durante l'intervallo di report.
NotificationsFailedDeliveryCount	int	Numero di notifiche che non sono state recapitate e che sono state contrassegnate come scadute durante l'intervallo di report.
WorkItemsInProgress	int	Numero di elementi di lavoro distribuiti durante l'intervallo di report.
SubscriptionsAddedCount	int	Numero di sottoscrizioni aggiunte all'applicazione durante l'intervallo di report.
ScheduledSubscriptionsAdded	int	Numero di sottoscrizioni pianificate aggiunte all'applicazione durante l'intervallo di report.
SubscriptionsModified	int	Numero di sottoscrizioni modificate nell'applicazione durante l'intervallo di report.
SubscribersAddedCount	int	Numero di sottoscrizioni aggiunte all'istanza durante l'intervallo di report.
SubscriberDevicesAddedCount	int	Numero di dispositivi del sottoscrittore aggiunti durante l'intervallo di report. Si presuppone che il dispositivo venga aggiunto nello stesso momento in cui viene aggiunto il sottoscrittore.
SubscriberDevicesModifiedCount	int	Numero di dispositivi del sottoscrittore aggiornati durante l'intervallo di report. Si presuppone che il dispositivo venga aggiornato nello stesso momento in cui viene aggiornato il sottoscrittore.

Osservazioni

Notification Services crea la stored procedure NSAdministrationHistory 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.

La quantità di dati raccolti da questo report dipende dal periodo di memorizzazione del processo Vacuumer specificato nell'elemento VacuumDuration del file di definizione dell'applicazione (ADF). È possibile analizzare solo i dati che non sono stati rimossi.

Per stabilire la data e l'ora UTC correnti, eseguire la query Transact-SQL SELECT GETUTCDATE(). L'ora UTC corrente viene calcolata in base all'ora locale corrente e all'impostazione del fuso orario nel sistema operativo del computer.

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

A. Cronologia amministrativa per l'applicazione Flight

Nell'esempio seguente viene generato il report della cronologia amministrativa per l'applicazione Flight. L'istanza utilizza le impostazioni predefinite del database, che prevedono l'inserimento di tutti gli oggetti dell'istanza nello schema dbo.

L'intervallo di report è di 120 minuti. Il report inizia alle 11.30 del 22 settembre 2004 e finisce alle 14.30 dello stesso giorno.

EXEC dbo.NSAdministrationHistory 
    @ApplicationName = N'Flight', 
    @ReportingIntervalInMinutes = 120, 
    @StartDateTime = '2004-09-22 11:30:00', 
    @EndDateTime = '2004-09-22 14:30:00';

B. Cronologia amministrativa per tutte le applicazioni

Nell'esempio seguente viene generato il report della cronologia amministrativa per tutte le applicazioni ospitate dall'istanza. In questo esempio, la stored procedure è 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 tutti i dati dell'ultimo mese utilizzando un intervallo di report di 60 minuti.

EXEC FlightInstance.NSAdministrationHistory;

Vedere anche

Share via