QUERYTRACE

Utilisez QUERYTRACE pour déboguer les performances d'une seule requête. La fonction de trace des requêtes vous aide à surveiller les mesures de performances des requêtes Essbase. Les informations à conserver sont consignées dans le fichier journal de trace distinct, query_trace.txt.

Description

La configuration QUERYTRACE s'applique uniquement aux cubes en mode "aggregate storage" (ASO) et "BSO" en mode hybride.

Ce paramètre active la fonction de trace des requêtes pour les flux de calcul. Le fichier de sortie du suivi des requêtes comprend les éléments suivants :

  • La requête d'entrée

  • Odomètre de requête développé

  • Informations générales sur les unités de calcul de requête

  • Liste de formules et d'agrégations

  • Liste ordonnée de toutes les cellules de sortie qui sont calculées ou agrégées au cours de la requête, selon l'ordre de résolution

Le fichier de sortie de trace de requête, query_trace.txt, est écrit dans le répertoire de cube.

Remarques :

Le suivi de requête et la trace de requête sont deux fonctions différentes.

Le suivi de requête vous permet de capturer des statistiques d'extraction utilisateur sur un cube en mode "aggregate storage" (ASO), de sorte qu'Essbase puisse optimiser les performances des agrégations en raison de la vue. Cette fonction est activée par défaut. Instructions MaxL associées :

import query_tracking
export query_tracking
alter database enable query_tracking
query database appname.dbname get cube_size_info

Le suivi des requêtes vous aide à surveiller les mesures de performances des requêtes Essbase pour les cubes en mode "aggregate storage", y compris le mode "block storage" (BSO) avec des cubes en mode hybride. Cette fonction est désactivée par défaut. Si vous l'activez, Essbase consigne les métriques dans un rapport de trace. Paramètres de configuration associés : TRACE_REPORT, QUERYTRACE, QUERYTRACETHRESHOLD, LONGQUERYTIMETHRESHOLD.

Syntaxe

QUERYTRACE n

n doit être défini sur -1, pour activer la fonction de trace des requêtes. La valeur par défaut est 0 (la fonction de trace des requêtes est désactivée).

Quand utiliser différentes options de trace de requête

Le paramètre de configuration QUERYTRACE est conçu pour le débogage d'une requête unique, en cas de problème. Il imprime le journal de trace dans le répertoire de cube en tant que query_trace.txt, et le fichier est effacé par défaut avant chaque exécution de requête. La fonction QUERYTRACE ne doit pas être activée dans la configuration de l'application pour une utilisation à long terme, car elle peut affecter les performances.

Remarques :

Lorsque QUERYTRACE est défini sur -1, les interrogations simultanées peuvent ne pas s'exécuter en parallèle et les performances peuvent être affectées. Désactivez QUERYTRACE une fois le dépannage terminé.

Le paramètre de configuration TRACE_REPORT fournit moins de détails que QUERYTRACE, mais il permet de suivre plusieurs requêtes simultanées. TRACE_REPORT est une bonne option pour collecter des informations sur de nombreuses requêtes simultanées exécutées sur une période donnée.

Exemple

QUERYTRACE -1

Définit la fonction de trace des requêtes pour inclure toutes les fonctions de trace répertoriées dans la description.