Comprendere le tabelle di registrazione dell'uso

Il sistema memorizza i dati di registrazione dell'uso in tre tabelle di database.

Il processo di registrazione dell'uso crea queste tabelle con i nomi tabella specificati dall'utente per le impostazioni della pagina Impostazioni di sistema.

Tabella di log delle query logiche di registrazione dell'uso
Tabella di log delle query fisiche di registrazione dell'uso
Tabella dei blocchi inizializzazione di registrazione dell'uso

Vedere Impostare i parametri di registrazione dell'uso.

Tabella di log delle query logiche di registrazione dell'uso

Nella tabella riportata di seguito viene descritta ogni colonna della tabella di database che tiene traccia delle query logiche. Ove appropriato, vengono specificati il tipo di dati, ad esempio un campo carattere variabile (varchar e varchar2) e la lunghezza. Nell'esaminare le descrizioni della tabella, supporre che è possibile aggiungere o sottrarre determinate colonne correlati al tempo per ottenere i valori esatti. Ad esempio, si potrebbe supporre che TOTAL_TIME_SEC è uguale a END_TS meno START_TS. Di seguito sono riportate alcune cause della mancata visualizzazione dei valori esatti nelle colonne.

Vari processi vengono eseguiti in parallelo e la velocità di esecuzione dipende dal carico e dalle prestazioni del database. Le operazioni basate su server possono essere poco o molto intensive.
Se tutte le connessioni sono complete, la query viene inserita in una coda in attesa di essere elaborata. La tempificazione dipende dal carico e dalla configurazione.

Colonne relative a utente, sessione e ID

Colonna	Descrizione
`ID`	Nella tabella delle query logiche, questa colonna indica l'identificativo di riga univoco. Nella tabella delle query fisiche questa colonna è indicata dal nome `LOGICAL_QUERY_ID`.
`NODE_ID`	Contiene `<hostname>:obis1`. Ad esempio, `examplehost:obis1` (per un'istanza singola).
`PRESENTATION_NAME`	Indica il nome del catalogo. L'impostazione predefinita è Null e il tipo di dati è Varchar(128).
`IMPERSONATOR_USER_NAME`	Specifica il nome utente dell'utente rappresentato. Se la richiesta non viene eseguita come utente rappresentato, il valore sarà None. L'impostazione predefinita è None e il tipo di dati è Varchar(128).
`USER_NAME`	Specifica il nome dell'utente che ha sottomesso la query.
`ECID`	Indica l'ID del contesto di esecuzione generato dal sistema. Il tipo di dati è Varchar2(1024).
`TENANT_ID`	Specifica il nome del tenant dell'utente che ha eseguito il blocco di inizializzazione. Il tipo di dati è Varchar2(128).
`SERVICE_NAME`	Specifica il nome del servizio. Il tipo di dati è Varchar2(128).
`SESSION_ID`	Indica l'ID della sessione. Il tipo di dati è Number(10).
`HASH_ID`	Indica il valore `HASH` per la query logica. Il tipo di dati è Varchar2(128).

Colonne relative all'origine della query

Colonna	Descrizione
`QUERY_SRC_CD`	Origine della richiesta. Tenere presente che il richiedente può impostare QUERY_SRC_CD su un valore stringa qualsiasi per identificare se stesso. Di seguito vengono indicati i valori possibili. Report: se l'origine è un'analisi o un'operazione di esportazione qualsiasi. Drill: se l'origine è una modifica della dimensione causata dal drill-up o dal drill-down. ValuePrompt: se l'origine è un elenco a discesa di valori in una finestra di dialogo di filtro o un prompt del dashboard. VisualAnalyzer: se l'origine è una cartella di lavoro per visualizzare i dati. DisplayValueMap, MemberBrowserDisplayValues o MemberBrowserPath: se l'origine è un valore correlato alla visualizzazione di un'analisi. SOAP: se l'origine è una chiamata da un Web Service quale DataSetSvc. Seed: se l'origine è un agente che popola la cache di Analytics Server. Null: se l'origine è la tabella fisica di Admininistration Tool, un conteggio di righe di colonna o i dati di una vista.
`SAW_DASHBOARD`	Indica il nome percorso del dashboard. Se la query non è stata sottomessa tramite un dashboard, il valore è NULL.
`SAW_DASHBOARD_PG`	Indica il nome della pagina nel dashboard. Se la richiesta non è una richiesta di tipo dashboard, il valore è NULL. L'impostazione predefinita è Null e il tipo di dati è Varchar(150).
`SAW_SRC_PATH`	Specifica il nome percorso nel catalogo per l'analisi.

Colonne relative ai dettagli della query

Colonna	Descrizione
`ERROR_TEXT`	Contiene il messaggio di errore inviato dal database backend. Questa colonna è applicabile solo se la colonna `SUCCESS_FLAG` è impostata su un valore diverso da 0 (zero). I messaggi multipli vengono concatenati e non vengono analizzati dal sistema. L'impostazione predefinita è Null e il tipo di dati è Varchar(250).
`QUERY_BLOB`	Contiene l'intera istruzione SQL logica senza alcun troncamento. La colonna `QUERY_BLOB` è una stringa di caratteri di tipo Long.
`QUERY_KEY`	Contiene una chiave hash MD5 generata dal sistema sulla base dell'istruzione SQL logica. L'impostazione predefinita è Null e il tipo di dati è Varchar(128).
`QUERY_TEXT`	Indica l'istruzione SQL sottomessa per la query. Il tipo di dati è Varchar(1024). Utilizzando il comando ALTER TABLE è possibile modificare la lunghezza di questa colonna, ma tenere presente che il testo scritto viene sempre troncato alla dimensione definita nel layer fisico. L'amministratore del modello semantico non deve impostare la lunghezza di questa colonna su un valore maggiore della lunghezza di query massima supportata dal database fisico backend. Ad esempio, i database Oracle accettano un valore Varchar massimo di 4000, ma i database Oracle effettuano il troncamento a 4000 byte, non a 4000 caratteri. Se si utilizza un set di caratteri costituiti da più byte, la dimensione massima effettiva della stringa conterrà un numero di caratteri variabile a seconda del set di caratteri e dei caratteri utilizzati.
`REPOSITORY_NAME`	Specifica il nome del modello semantico al quale accede la query.
`SUBJECT_AREA_NAME`	Contiene il nome del modello aziendale al quale si accede.
`SUCCESS_FLG`	Indica lo stato di completamento della query, come definito nella lista seguente. 0: completamento della query riuscito senza errori. 1: timeout della query. 2: la query non è riuscita perché sono stati superati i limiti delle righe. 3: la query non è riuscita per un'altra causa.

Colonne relative al tempo di esecuzione

Colonna	Descrizione
`COMPILE_TIME_SEC`	Contiene il tempo necessario per compilare la query espresso in secondi. Il numero per `COMPILE_TIME_SEC` è incluso in `TOTAL_TIME_SEC`.
`END_DT`	Indica la data di completamento della query logica.
`END_HOUR_MIN`	Indica l'ora e i minuti di completamento della query logica.
`END_TS`	Indica la data e l'ora di completamento della query logica. Gli indicatori orari iniziale e finale riflettono inoltre qualsiasi periodo di tempo durante il quale la query è rimasta in attesa della disponibilità delle risorse. Se l'utente che sottomette la query esce dalla pagina prima della fine dell'esecuzione della query, l'operazione di FETCH finale non si verificherà e verrà registrato il valore di timeout 3600. Se tuttavia l'utente torna alla pagina prima del timeout, l'operazione di FETCH viene completata in quel momento, registrato come tempo `end_ts`.
`START_DT`	Indica la data di sottomissione della query logica.
`START_HOUR_MIN`	Indica l'ora e i minuti di sottomissione della query logica.
`START_TS`	Indica la data e l'ora di sottomissione della query logica.
`TOTAL_TIME_SEC`	Indica, in secondi, il tempo dedicato dal sistema all'elaborazione della query mentre il client era in attesa delle risposte alle proprie analisi. `TOTAL_TIME_SEC` include il tempo per `COMPILE_TIME_SEC`.
`RESP_TIME_SEC`	Indica il tempo impiegato per la risposta alla query. Il tipo di dati è Number(10).

Colonne relative ai dettagli di esecuzione

Colonna	Descrizione
`CUM_DB_TIME_SEC`	Contiene il tempo cumulativo per tutte le query inviate al database. Le query vengono eseguite in parallelo, pertanto il tempo cumulativo è maggiore o uguale al tempo totale di connessione al database. Si supponga, ad esempio, che una richiesta logica generi dinamicamente 4 istruzioni SQL fisiche inviate al database e che il tempo per 3 query sia di 10 secondi e per una query sia di 15 secondi: `CUM_DB_TIME_SEC` visualizzerà 45 secondi perché le query vengono eseguite in parallelo.
`CUM_NUM_DB_ROW`	Contiene il numero totale delle righe restituite dai database backend.
`NUM_DB_QUERY`	Indica il numero di query sottomesse ai database backend per soddisfare la richiesta della query logica. Per le query riuscite (SuccessFlag = 0), questo numero è 1 o un numero maggiore.
`ROW_COUNT`	Indica il numero delle righe restituite al client della query. Quando una query restituisce una grande quantità di dati, questa colonna non viene popolata finché l'utente non visualizza tutti i dati.
`TOTAL_TEMP_KB`	Specifica i KB totali ricevuti per una query. Il tipo di dati è Number(10).

Colonne relative alla cache

Colonna	Descrizione
`CACHE_IND_FLG`	Contiene Y per indicare un accesso alla cache e N per indicare un accesso alla cache non riuscito. L'impostazione predefinita è N.
`NUM_CACHE_HITS`	Indica il numero di volte in cui il risultato della cache è stato restituito per la query. `NUM_CACHE_HITS` è un numero intero a 32 bit (o un numero intero a 10 cifre). L'impostazione predefinita è Null.
`NUM_CACHE_INSERTED`	Indica il numero di volte in cui la query ha generato una voce cache. L'impostazione predefinita è Null. `NUM_CACHE_INSERTED` è un numero intero a 32 bit (o un numero intero a 10 cifre).

Tabella di log delle query fisiche di registrazione dell'uso

Nella tabella riportata di seguito viene descritta la tabella di database che tiene traccia delle query fisiche. In questa tabella di database vengono registrate le informazioni di SQL fisico per le query logiche memorizzate nella tabella di log delle query logiche. La tabella delle query fisiche contiene una relazione di chiave esterna con la tabella delle query logiche.

Colonne relative a utente, sessione e ID

Colonna	Descrizione
`ID`	Specifica l'identificativo univoco della riga.
`LOGICAL_QUERY_ID`	Fa riferimento alla query logica nella tabella di log delle query logiche. Il tipo di dati è Varchar2(50).
`HASH_ID`	Indica il valore `HASH` per la query logica. Il tipo di dati è Varchar2(128).
`PHYSICAL_HASH_ID`	Indica il valore `HASH` per la query fisica. Il tipo di dati è Varchar2(128).

Colonne relative ai dettagli della query

Colonna	Descrizione
`QUERY_BLOB`	Contiene l'intera istruzione SQL fisica senza alcun troncamento. La colonna `QUERY_BLOB` è una stringa di caratteri di tipo Long.
`QUERY_TEXT`	Contiene l'istruzione SQL sottomessa per la query. Il tipo di dati è Varchar(1024).

Colonne relative al tempo di esecuzione

Colonna	Descrizione
`END_DT`	Indica la data di completamento della query fisica.
`END_HOUR_MIN`	Indica l'ora e i minuti di completamento della query fisica.
`END_TS`	Indica la data e l'ora di completamento della query fisica. Gli indicatori orari iniziale e finale riflettono inoltre qualsiasi periodo di tempo durante il quale la query è rimasta in attesa della disponibilità delle risorse.
`TIME_SEC`	Indica il tempo di esecuzione della query fisica.
`START_DT`	Indica la data di sottomissione della query fisica.
`START_HOUR_MIN`	Indica l'ora e i minuti di sottomissione della query fisica.
`START_TS`	Indica la data e l'ora di sottomissione della query fisica.

Colonne relative ai dettagli di esecuzione

Colonna	Descrizione
`ROW_COUNT`	Contiene il numero delle righe restituite al client della query.

Tabella dei blocchi inizializzazione di registrazione dell'uso

Nella tabella riportata di seguito viene descritta la tabella di database che tiene traccia delle informazioni relative ai blocchi di inizializzazione.

Nota:

Attualmente le tabelle di registrazione dell'uso dei blocchi di inizializzazione includono solo i blocchi di inizializzazione della sessione e non includono i blocchi di inizializzazione del modello semantico.

Colonne relative a utente, sessione e ID

Colonna	Descrizione
`USER_NAME`	Nome dell'utente che ha eseguito il blocco di inizializzazione. Il tipo di dati è Varchar2(128).
`TENANT_ID`	Nome del tenant dell'utente che ha eseguito il blocco di inizializzazione. Il tipo di dati è Varchar2(128).
`SERVICE_NAME`	Il nome del servizio. Il tipo di dati è Varchar2(128).
`ECID`	ID del contesto di esecuzione generato dal sistema. Il tipo di dati è Varchar2(1024).
`SESSION_ID`	ID della sessione. Il tipo di dati è Number(10).

Colonne relative ai dettagli della query

Colonna	Descrizione
`REPOSITORY_NAME`	Il nome del modello semantico al quale accede la query. Il tipo di dati è Varchar2(128).
`BLOCK_NAME`	Nome del blocco di inizializzazione eseguito. Il tipo di dati è Varchar2(128).

Colonne relative al tempo di esecuzione

Colonna	Descrizione
`START_TS`	Data e ora di avvio del blocco di inizializzazione.
`END_TS`	Data e ora di fine del blocco di inizializzazione. Gli indicatori orari iniziale e finale riflettono inoltre il periodo di tempo durante il quale la query è rimasta in attesa della disponibilità delle risorse.
`DURATION`	Tempo richiesto per l'esecuzione del blocco di inizializzazione. Il tipo di dati è Number(13,3).

Colonne relative ai dettagli di esecuzione

Colonna	Descrizione
`NOTES`	Note inerenti al blocco di inizializzazione e alla relativa esecuzione. Il tipo di dati è Varchar2(1024).