NSQuantumDetails (Transact-SQL)
Restituisce informazioni dettagliate su un quantum. Questa stored procedure risulta utile per risolvere i problemi relativi ai quantum con esecuzioni prolungate o per analizzare l'elaborazione dei quantum.
Sintassi
[ schema_name . ] NSQuantumDetails [ @QuantumId = ] quantum_id
Argomenti
- [ @QuantumId = ] quantum_id
ID di un quantum per il report. quantum_id è di tipo int e non prevede alcun valore predefinito. Utilizzare le stored procedure NSQuantumList, NSQuantumExecutionTime e NSQuantumFailures per ottenere gli ID dei quantum.
Set di risultati
NSQuantumDetails genera cinque set di risultati. Il primo set di risultati contiene informazioni generali sul quantum.
Nome colonna | Tipo di dati | Descrizione |
---|---|---|
QuantumStartTime |
datetime |
Ora UTC di inizio dell'intervallo di tempo rappresentato dal quantum. |
QuantumEndTime |
datetime |
Ora UTC di fine dell'intervallo di tempo rappresentato dal quantum. L'ora di fine corrisponde all'ora di inizio più la durata del quantum. |
QuantumStatusDescription |
nvarchar(255) |
Testo che descrive lo stato corrente del quantum. |
ExecutionTimeInMS |
int |
Tempo necessario, in millisecondi, per completare l'elaborazione del quantum. |
ExecutionStartTime |
datetime |
Data e ora UTC effettive in cui è iniziata l'elaborazione del quantum. |
ExecutionEndTime |
datetime |
Data e ora UTC effettive in cui è finita l'elaborazione del quantum. |
EventNotificationsGenerated |
bigint |
Numero di notifiche generate da regole attivate da evento durante l'esecuzione del quantum. |
ScheduledNotificationsGenerated |
bigint |
Numero di notifiche generate da regole di sottoscrizione pianificata durante l'esecuzione del quantum. |
ChronicleRuleFiringsSkipped |
nvarchar(255) |
Indica se durante il quantum sono state ignorate le esecuzioni delle regole di cronologia degli eventi. |
SubscriptionRuleFiringsSkipped |
nvarchar(255) |
Indica se durante il quantum sono state ignorate le esecuzioni delle regole di sottoscrizione. |
Il secondo set di risultati contiene informazioni sulle esecuzioni di regole del quantum.
Nome colonna | Tipo di dati | Descrizione |
---|---|---|
RuleFiringId |
int |
ID univoco di una regola eseguita durante il quantum. |
RuleName |
nvarchar(255) |
Nome della regola, definita nel file di definizione dell'applicazione (ADF). |
ExecutionTimeInMS |
int |
Tempo, espresso in millisecondi, necessario per completare l'esecuzione della regola. |
PercentageQuantumTime |
numeric(7, 4) |
Percentuale del tempo complessivo di esecuzione del quantum utilizzata per l'esecuzione della regola. |
ExecutionStartTime |
datetime |
Data e ora UTC di inizio dell'esecuzione della regola. |
ExecutionEndTime |
datetime |
Data e ora UTC di fine dell'esecuzione della regola. |
RuleTypeDescription |
nvarchar(250) |
Descrive il tipo di regola eseguita: cronologia degli eventi, sottoscrizione di evento o sottoscrizione pianificata. |
EventClassName |
nvarchar(255) |
Nome della classe di evento degli eventi elaborati durante l'esecuzione della regola. Se l'esecuzione della regola è di tipo sottoscrizione pianificata, questa colonna è NULL, perché le regole di questo tipo non vengono attivate da eventi. |
EventCount |
bigint |
Numero di eventi elaborati dalla regola. |
EventBatchId |
bigint |
ID del batch di eventi che contiene gli eventi elaborati durante l'esecuzione della regola. Se l'esecuzione della regola è di tipo sottoscrizione pianificata oppure se il valore di ProcessEventsInOrder nel file ADF è false, questa colonna è NULL, perché durante l'esecuzione della regola potrebbero essere stati elaborati più batch di eventi. |
SubscriptionClassName |
nvarchar(255) |
Nome della classe di sottoscrizione delle sottoscrizioni elaborate durante l'esecuzione della regola. Se l'esecuzione della regola è di tipo cronologia degli eventi, questa colonna è NULL. |
SubscriptionCount |
bigint |
Numero stimato di sottoscrizioni elaborate dalla regola. Il valore viene stimato in base allo stato corrente delle sottoscrizioni nel database dell'applicazione. Il numero di sottoscrizioni presenti nel database al momento effettivo dell'esecuzione della regola potrebbe essere maggiore o minore. |
StartScanTime |
datetime |
Data e ora UTC di inizio delle sottoscrizioni pianificate utilizzate dalla regola. Questa colonna contiene un valore solo se la regola è di tipo sottoscrizione pianificata e l'applicazione elabora gli eventi in ordine. |
EndScanTime |
datetime |
Data e ora UTC di fine delle sottoscrizioni pianificate utilizzate dalla regola. Questa colonna contiene un valore solo se la regola è di tipo sottoscrizione pianificata e l'applicazione elabora gli eventi in ordine. |
NotificationsGenerated |
int |
Numero di notifiche generate dall'esecuzione della regola. |
Il terzo set di risultati contiene informazioni sui batch di eventi raccolti durante il quantum.
Nome colonna | Tipo di dati | Descrizione |
---|---|---|
EventClassName |
nvarchar(255) |
Nome di una classe di evento che ha inviato un batch di eventi. |
EventBatchId |
bigint |
ID del batch di eventi. |
EventCount |
bigint |
Numero di eventi nel batch di eventi. |
StartCollectionTime |
datetime |
Data e ora UTC di inizio della raccolta dei batch di eventi. |
EndCollectionTime |
datetime |
Data e ora UTC di fine della raccolta dei batch di eventi. |
CollectionTimeInMS |
int |
Durata totale, in millisecondi, della raccolta dei batch di eventi. |
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>. |
SystemName |
nvarchar(255) |
Nome del sistema in cui è in esecuzione il provider di eventi. Questo valore è NULL per i provider di eventi non hosted o se gli eventi sono stati inseriti direttamente nella vista <EventClassName>. |
Il quarto set di risultati contiene informazioni sulle sottoscrizioni elaborate durante il quantum.
Nome colonna | Tipo di dati | Descrizione |
---|---|---|
SubscriptionClassName |
nvarchar(255) |
Nome di una classe di sottoscrizione per la quale sono state elaborate sottoscrizioni durante il quantum. |
EventSubscriptionCount |
bigint |
Numero stimato di sottoscrizioni attivate da evento attive per la classe di sottoscrizione durante il periodo di quantum. |
ScheduledSubscriptionCount |
bigint |
Numero stimato di sottoscrizioni pianificate attive per la classe di sottoscrizione durante il periodo di quantum. |
Il quinto report contiene informazioni sulle notifiche generate durante il quantum.
Nome colonna
Tipo di dati
Descrizione
NotificationClassName
nvarchar(255)
Nome della classe di notifica a cui appartengono le notifiche del batch.
NotificationBatchId
bigint
ID univoco di un batch di notifiche generato dall'esecuzione di una regola durante il quantum.
RuleFiringId
int
ID univoco dell'esecuzione della regola che ha generato il batch di notifiche.
NotificationCount
int
Numero di notifiche incluse nel batch di notifiche.
NotificationDeliveryAttempts
int
Numero dei tentativi di recapito delle notifiche effettuati dal batch di notifiche.
Nota:
Se una notifica è stata consegnata al protocollo di recapito ma quest'ultimo non ha fornito informazioni sul suo stato, la notifica non viene calcolata come notifica di cui è stato tentato il recapito.
NotificationSuccessfulDeliveries
int
Numero di recapiti di notifiche riusciti dal batch di notifiche.
NotificationFailedAttempts
int
Numero di recapiti di notifiche non riusciti dal batch di notifiche.
NotificationsDeliveryNotAttempted
int
Numero di notifiche che il server di distribuzione non ha ancora tentato di recapitare.
NotificationsNotYetDelivered
int
Numero di notifiche che il server di distribuzione non ha ancora recapitato.
NotificationToMessageRatio
float
Rapporto tra le notifiche generate e i messaggi inviati.
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.
AvgNotificationBatchSucceedDeliveryTime
float
Tempo medio, espresso in secondi, necessario per inviare le notifiche tramite il processo di distribuzione.
Osservazioni
Notification Services crea la stored procedure NSQuantumDetails 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.
Dopo aver ottenuto informazioni generali su un quantum, è possibile utilizzare le stored procedure seguenti per ottenere informazioni più dettagliate:
- NSEventBatchDetails (Transact-SQL)
- NSNotificationBatchDetails (Transact-SQL)
- NSScheduledSubscriptionDetails (Transact-SQL)
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
Nell'esempio seguente vengono generati i cinque set di risultati descritti più indietro in questa sezione per il primo quantum del generatore di un'applicazione:
L'applicazione utilizza le impostazioni predefinite di SchemaName, che prevedono l'inserimento di tutti gli oggetti dell'applicazione nello schema dbo.
EXEC dbo.NSQuantumDetails
@QuantumId = 1;
Vedere anche
Riferimento
Stored procedure di Notification Services (Transact-SQL)
NSEventBatchDetails (Transact-SQL)
NSNotificationBatchDetails (Transact-SQL)
NSScheduledSubscriptionDetails (Transact-SQL)
Altre risorse
Report sulle prestazioni di Notification Services
SchemaName Element (ADF)