Monitoraggio di tracce (XMLA)
È possibile utilizzare il comando Subscribe disponibile in XML for Analysis (XMLA) per monitorare una traccia esistente definita in un'istanza di MicrosoftSQL ServerAnalysis Services. Il comando Subscribe restituisce i risultati di una traccia come set di righe.
Specifica di una traccia
La proprietà Object del comando Subscribe deve contenere un riferimento all'oggetto a un'istanza di Analysis Services oppure a una traccia in un'istanza di Analysis Services. Se la proprietà Object non viene specificata o se un identificatore di traccia non viene specificato nella proprietà Object, il comando Subscribe controlla la traccia della sessione predefinita per la sessione esplicita specificata nell'intestazione SOAP per il comando.
Restituzione di risultati
Il comando Subscribe restituisce un set di righe che contiene gli eventi di traccia acquisiti dalla traccia specificata. Il comando Subscribe restituisce i risultati della traccia fino a quando non viene annullato dal comando Cancel.
Nel set di righe sono contenute le colonne elencate nella tabella seguente.
Colonna |
Tipo di dati |
Descrizione |
|---|---|---|
EventClass |
Integer |
Classe di evento dell'evento ricevuto dalla traccia. |
EventSubclass |
Long integer |
Sottoclasse di evento dell'evento ricevuto dalla traccia. |
CurrentTime |
Datetime |
Ora di inizio dell'evento, se disponibile. I formati previsti per l'applicazione di filtri sono "YYYY-MM-DD" e "YYYY-MM-DD HH:MM:SS". |
StartTime |
Datetime |
Ora di inizio dell'evento, se disponibile. I formati previsti per l'applicazione di filtri sono "YYYY-MM-DD" e "YYYY-MM-DD HH:MM:SS". |
EndTime |
Datetime |
Ora di fine dell'evento, se disponibile. I formati previsti per l'applicazione di filtri sono "YYYY-MM-DD" e "YYYY-MM-DD HH:MM:SS". Questa colonna non viene popolata per classi di evento che descrivono l'inizio di un processo o di un'azione. |
Duration |
Long integer |
Durata dell'evento (in millisecondi). |
CPUTime |
Long integer |
Tempo processore utilizzato per l'evento (in millisecondi). |
JobID |
Long integer |
Identificatore di processo. |
SessionID |
String |
Identificatore della sessione per cui si è verificato l'evento. |
SessionType |
String |
Tipo della sessione per cui si è verificato l'evento. |
ProgressTotal |
Long integer |
Numero o quantità coplessiva dello stato di avanzamento segnalato dall'evento. |
IntegerData |
Long integer |
Dati di tipo integer associati all'evento. Il contenuto di questa colonna dipende dalla classe e dalla sottoclasse di evento. |
ObjectID |
String |
Identificatore dell'oggetto per cui si è verificato l'evento. |
ObjectType |
String |
Tipo dell'oggetto specificato in ObjectName. |
ObjectName |
String |
Nome dell'oggetto per cui si è verificato l'evento. |
ObjectPath |
String |
Percorso gerarchico dell'oggetto per cui si è verificato l'evento. Il percorso viene rappresentato come una stringa delimitata da virgole di identificatori di oggetto per i padri dell'oggetto specificato in ObjectName. |
ObjectReference |
String |
Rappresentazione XML del riferimento all'oggetto per l'oggetto specificato in ObjectName. |
NestLevel |
Integer |
Livello della transazione per cui si è verificato l'evento. |
NumSegments |
Long integer |
Numero di segmenti di dati interessati o utilizzati dal comando per cui si è verificato l'evento. |
Severity |
Integer |
Livello di gravità di un'eccezione per l'evento. I possibili valori della colonna sono i seguenti:
ValoreDescrizione
0Esito positivo
1Informazioni
2Avviso
3Errore
|
Success |
Boolean |
Indica se un comando ha avuto esito positivo o negativo. |
Error |
Long integer |
Numero di errore di un evento, se applicabile. |
ConnectionID |
String |
Identificatore della connessione per cui si è verificato l'evento. |
DatabaseName |
String |
Nome del database per cui si è verificato l'evento. |
NTUserName |
String |
Nome utente di Windows dell'utente associato all'evento. |
NTDomainName |
String |
Dominio di Windows dell'utente associato all'evento. |
ClientHostName |
String |
Nome del computer in cui viene eseguita l'applicazione client. Questa colonna viene popolata con i valori passati dall'applicazione client. |
ClientProcessID |
Long integer |
Identificatore di processo dell'applicazione client. |
ApplicationName |
String |
Nome dell'applicazione client che ha creato la connessione all'istanza di Analysis Services. Questa colonna viene popolata con i valori passati dall'applicazione client anziché con il nome visualizzato del programma. |
NTCanonicalUserName |
String |
Nome utente di Windows in forma canonica dell'utente associato all'evento. |
SPID |
String |
ID del processo server (SPID) della sessione per cui si è verificato l'evento. Il valore di questa colonna corrisponde direttamente all'ID di sessione specificato nell'intestazione SOAP del messaggio XMLA per cui si è verificato l'evento. |
TextData |
String |
Dati di testo associati all'evento. Il contenuto di questa colonna dipende dalla classe e dalla sottoclasse di evento. |
ServerName |
String |
Nome dell'istanza di Analysis Services per cui si è verificato l'evento. |
RequestParameters |
String |
Parametri della query con parametri o del comando XMLA per cui si è verificato l'evento. |
RequestProperties |
String |
Proprietà del metodo XMLA per cui si è verificato l'evento. |