Sintassi file impostazioni log query

Il nome del file delle impostazioni del log di query deve essere nel formato dbname.cfg, dove dbname rappresenta il nome del database (cubo). Il file dbname.cfg deve trovarsi nella directory del cubo. Configurare il file dbname.cfg utilizzando la seguente sintassi:

QUERYLOG [dimension_name]
QUERYLOG NONE GENERATION generation-range
QUERYLOG NONE LEVEL level-range
QUERYLOG GENERATION generation-range
QUERYLOG LEVEL level-range
QUERYLOG LOGPATH path-expression
QUERYLOG LOGFORMAT CLUSTER | TUPLE
QUERYLOG LOGFILESIZE n
QUERYLOG TOTALLOGFILESIZE n
QUERYLOG ON | OFF

Nota

La directory cubo indica <Application Directory>/app/appname/dbname. Se non si conosce la posizione del <Application Directory> nell'ambiente in uso,

Se si utilizza una distribuzione Essbase indipendente, fare riferimento alla sezione Posizioni degli ambienti nella piattaforma Essbase.
Se si utilizza una distribuzione Essbase nel Marketplace di Oracle Cloud Infrastructure, <Application Directory> è /u01/data/essbase/app.

Tabella 4-1 Parametri QUERYLOG

Parametro QUERYLOG	Descrizione
[dimension_name]	Identifica il nome della dimensione da tenere traccia. Le parentesi intorno al nome della dimensione sono obbligatorie. QUERYLOG [dimension_name] registra tutti i membri di una dimensione. Ad esempio, QUERYLOG [Product] tiene traccia di tutti i membri della dimensione Prodotto. Ogni dimensione deve essere specificata in un'impostazione QUERYLOG [dimension_name] separata.
NONE GENERATION <genlevel_range_val> (vedere la Tabella 4-2)	Impedisce il tracciamento dei membri dell'intervallo di generazione specificato. Ad esempio, QUERYLOG NONE GENERATION 2 esclude il tracciamento di tutti i membri della generazione 2 della dimensione denominata.
NONE LEVEL <genlevel_range_val> (vedere Tabella 4-2)	Impedisce il tracciamento dei membri dall'intervallo di livelli specificato. Ad esempio, QUERYLOG NONE LEVEL 0-2 esclude il tracciamento di tutti i membri dei livelli 0, 1 e 2 della dimensione denominata.
GENERATION <genlevel_range_val> (vedere Tabella 4-2)	Tiene traccia dei membri dell'intervallo di generazione specificato in base al numero di generazione, anziché in base al nome del membro. Ad esempio, QUERYLOG GENERATION 5-7 registra i membri delle generazioni 5, 6 e 7 della dimensione denominata in base al numero di generazione nel file di log.
LEVEL <genlevel_range_val> (vedere Tabella 4-2)	Tiene traccia dei membri dell'intervallo di livelli specificato in base al numero di livello, anziché in base al nome del membro. Ad esempio, QUERYLOG LEVEL -3 registra i membri dei livelli 0, 1, 2 e 3 della dimensione denominata in base al numero di livello nel file di log.
PERCORSO LOG path-expression	Specifica la posizione del file di log di output. Il nome del file di log è `dbname00001.qlg`, ad esempio `basic00001.qlg`. Esempi del percorso di log sono QUERYLOG LOGPATH `/usr/local/Essbaselogs/` e QUERYLOG LOGPATH `d:\Essbaselogs\querylogs\`. È necessario includere una barra rovesciata \ (per le directory Windows) o una barra / (per le directory UNIX) alla fine dell'espressione del percorso; in caso contrario, il file di log delle query non viene creato. Per impostazione predefinita, la posizione del file di output del log è la directory del cubo. Se l'impostazione LOGPATH path-expression non è presente, viene utilizzata l'impostazione predefinita. Essbase scrive le informazioni di log nel file di log delle query dopo l'interruzione dell'esecuzione di un'applicazione.
CLUSTER LOGFORMAT \| TUPLA	Specifica il formato dell'output del log. CLUSTER e TUPLE forniscono le stesse informazioni di log, ma visualizzano le informazioni in modo diverso. CLUSTER fornisce informazioni sul numero di membri di una dimensione sottoposti a query ed elenca i membri sottoposti a query all'interno delle rispettive dimensioni. TUPLE elenca ogni combinazione di membri interrogati. Per impostazione predefinita, CLUSTER è il formato di log. Poiché il formato TUPLE elenca ogni combinazione di membri interrogata, TUPLE può avere un impatto maggiore sulle prestazioni della query rispetto a CLUSTER. Per un esempio di log di query in formato cluster, vedere Output cluster di esempio. Per un esempio di log di query in formato tupla, vedere Output tupla di esempio.
DIMENSIONE FILE DI LOG n	Specifica la dimensione massima di un singolo file di log delle query in megabyte (MB). Il valore minimo è 1 MB. Il valore massimo è 2048 MB (2 GB). Se manca l'impostazione LOGFILESIZE, per impostazione predefinita la dimensione del file di log delle query è di 1 MB. Se la dimensione di un file di log query iniziale supera la specifica, le informazioni di log vengono aggiunte a un nuovo file di log query. Ogni volta che viene creato un nuovo file, il nome file viene incrementato di uno.
TOTALLOGFILESIZE n	Specifica la dimensione massima di tutti i file di log delle query combinati in megabyte (MB). Il valore minimo è 512 MB (1/2 GB). Il valore massimo è 4095 MB. Se manca l'impostazione TOTALLOGFILESIZE, per impostazione predefinita la dimensione totale del file di log delle query è di 1024 MB (1 GB). I file di log delle query vengono creati fino a quando la dimensione totale del file supera il numero massimo specificato. Quando viene superato il limite massimo, viene visualizzato un messaggio e il log delle query viene disattivato automaticamente.
ON \| OFF	Specifica se la funzione di log delle query è attivata o disattivata. Tutte le impostazioni del log delle query vengono ignorate se questa impostazione è OFF o mancante. Per impostazione predefinita, l'impostazione è OFF.

I valori Generation-range e level-range (<genlevel_range_val>) sono rappresentati in uno dei modi seguenti:

Tabella 4-2 Generazione e intervallo di livelli Specifiche

Valore intervallo generazione o intervallo livello	Descrizione
x	Numero di generazione o di livello specifico. Ad esempio, QUERYLOG NONE GENERATION 2 esclude la generazione 2 dal log delle query.
x-y	Tutte le generazioni o i livelli compresi tra il numero x e il numero y. Ad esempio, QUERYLOG GENERATION 1-3 o QUERYLOG LEVEL 1-3 include i numeri di generazione o livello 1, 2 e 3.
-x	Per generation-range, tutte le generazioni comprese tra 1 e x. Per level-range, tutti i livelli compresi tra 0 e x. Ad esempio, QUERYLOG GENERATION -2 include le generazioni 1 e 2. QUERYLOG LIVEL -3 include i livelli 0, 1, 2 e 3.
x-	Per generation-range, tutte le generazioni comprese nell'intervallo compreso tra il numero x e la generazione più recente. Per level-range, tutti i livelli compresi nell'intervallo tra il numero x e il livello più alto. Ad esempio, il livello QUERYLOG 1- include i livelli 1, 2, 3 e così via fino al livello più alto.

Note

Quando il log delle query è abilitato, le query sul cubo potrebbero risultare più lente. Le prestazioni dipendono dal numero di membri di cui viene eseguito il tracciamento e dalla dimensione della query.
Se il nome del file delle impostazioni non corrisponde al nome del cubo o si trova in una posizione diversa dalla directory del cubo, Essbase ignora il log delle query.
Se nelle impostazioni manca QUERYLOG ON o se QUERYLOG OFF è impostato, il log delle query è disattivato.
Se le impostazioni di generazione e livello causano contraddizioni nel file delle impostazioni, vengono applicate le regole di precedenza riportate di seguito.
- numeri di generazione (priorità massima)
- numeri di livello
- nomi dei membri (priorità più bassa)
Ad esempio, se un membro appartiene sia al livello 1 che alla generazione 2 e le impostazioni QUERYLOG GENERATION 2 e QUERYLOG NONE LEVEL 1 si trovano nel file delle impostazioni, l'impostazione di generazione ha la precedenza e i membri della generazione 2 vengono registrati in base al numero di generazione.

Suggerimenti

Per visualizzare facilmente l'output del log delle query, modificare l'estensione file .qlg in .xml e utilizzare un browser per visualizzare l'XML.
Se Essbase non produce un file .qlg di log delle query come previsto, visualizzare il file dbname.log nella directory del cubo per cercare i messaggi di log delle query.