NSEventBatchDetails (Transact-SQL)

Articolo
12/15/2008

Restituisce informazioni dettagliate su un batch di eventi in un'applicazione di Microsoft SQL Server Notification Services. Un set di risultati include informazioni generali sul batch di eventi, ad esempio il nome del provider di eventi e l'ora di raccolta del batch di eventi. Un secondo set di risultati visualizza gli eventi inoltrati nel batch.

Sintassi

[ application_schema_name . ] NSEventBatchDetails     [ @EventClassName = ] 'event_class_name' ,    [ @EventBatchId = ] event_batch_id

Argomenti

[ @EventClassName = ] 'event_class_name'
Nome di una classe di eventi. event_class_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @EventBatchId =] event_batch_id
Identificatore univoco di un batch di eventi. event_batch_id è di tipo bigint e non prevede alcun valore predefinito.

Set di risultati

NSEventBatchDetails restituisce due set di risultati, il primo dei quali include le informazioni generali sul batch di eventi.

Nome colonna	Tipo di dati	Descrizione
ProviderName	nvarchar(255)	Nome del provider di eventi che ha inviato il batch di eventi. Questo valore è NULL se gli eventi sono stati inseriti direttamente nella vista <EventClassName>.
EventCount	bigint	Numero di eventi nel batch di eventi.
StartCollectionTime	datetime	Data e ora di inizio della raccolta del batch di eventi in base all'ora UTC (Universal Time Coordinated o ora di Greenwich).
EndCollectionTime	datetime	Data e ora di fine della raccolta del batch di eventi in base all'ora UTC.
CollectionTimeInMS	int	Tempo totale, espresso in millisecondi, impiegato per raccogliere il batch di eventi.

Il secondo set di risultati include informazioni dettagliate sugli eventi inviati nel batch di eventi, ordinati in base alla colonna EventId.

Nome colonna	Tipo di dati	Descrizione
EventId	bigint	Numero di identificazione di un evento.
Event_class_field_name	Definito a livello di applicazione.	Nome del campo della classe di eventi, come definito nel file di definizione dell'applicazione (ADF). Ogni campo nella classe di eventi è rappresentato da una colonna nel set di risultati.

Osservazioni

Notification Services crea la stored procedure NSEventBatchDetails nel database dell'applicazione durante la creazione dell'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

A. Utilizzo dello schema dell'applicazione predefinito

Nell'esempio seguente viene illustrato come generare il report relativo ai dettagli del batch di eventi. L'applicazione utilizza le impostazioni predefinite di SchemaName, che prevedono l'inserimento di tutti gli oggetti dell'applicazione nello schema dbo.

Questo report contiene due set di risultati. Nel primo sono disponibili le informazioni sul provider di eventi e sulla raccolta degli eventi per il batch di eventi, mentre nel secondo sono inclusi gli eventi inviati nel batch.

EXEC dbo.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

B. Utilizzo di uno schema dell'applicazione denominato

Nell'esempio seguente viene illustrato come generare il report sul batch di eventi quando la stored procedure (come tutti gli altri oggetti dell'applicazione) è inclusa nello schema Stock, come specificato nell'elemento SchemaName del file di configurazione dell'applicazione (ADF).

EXEC Stock.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

Vedere anche

Share via