QUERYTRACE

Mit QUERYTRACE können Sie die Performance für eine einzelne Abfrage debuggen. Mit dem Abfragetracing können Sie Essbase-Abfragemetriken überwachen. Die Informationen, die Sie beibehalten möchten, werden in der separaten Tracinglogdatei query_trace.txt gemeldet.

Beschreibung

Die QUERYTRACE-Konfiguration gilt nur für Aggregate Storage-(ASO-) und BSO-Hybridmodus-Cubes.

Diese Einstellung aktiviert das Abfrage-Tracing für Berechnungsabläufe. Die Ausgabedatei für das Tracing von Abfragen umfasst:

  • Die Eingabeabfrage

  • Ein erweiterter Abfragetometer

  • Allgemeine Informationen zu Abfrageberechnungseinheiten

  • Eine Liste von Formeln und Aggregationen

  • Eine sortierte Liste aller Ausgabezellen, die während der Abfrage gemäß der Lösungsreihenfolge berechnet oder aggregiert werden

Die Ausgabedatei für das Tracing der Abfrage, query_trace.txt, wird in das Cube-Verzeichnis geschrieben.

Hinweis:

Das Abfragetracking ist nicht das Gleiche wie das Abfragetracing.

Mit dem Abfrage-Tracking können Sie Benutzerabrufstatistiken für einen Aggregate Storage-(ASO-)Cube erfassen, damit Essbase ansichtsbasierte Optimierungen vornehmen kann, um die Performance von Aggregationen zu verbessern. Diese Funktion ist standardmäßig aktiviert. Zugehörige MaxL-Anweisungen:

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

Mit dem Abfragetracing können Sie Essbase-Abfragemetriken für Aggregate Storage-(ASO-)Cubes überwachen, einschließlich Block Storage-(BSO-)Cubes mit Hybridmodus-Cubes. Diese Funktion ist standardmäßig deaktiviert. Wenn Sie sie aktivieren, protokolliert Essbase Metriken in einem Tracebericht. Zugehörige Konfigurationsparameter: TRACE_REPORT, QUERYTRACE, QUERYTRACETHRESHOLD, LONGQUERYTIMETHRESHOLD.

Syntax

QUERYTRACE n

Dabei muss n auf -1 gesetzt werden, um das Abfragetracing zu aktivieren. Der Standardwert ist 0 (Abfrage-Tracing ist deaktiviert).

Wann verschiedene Abfrage-Tracing-Optionen verwendet werden sollten

Die Konfigurationseinstellung QUERYTRACE dient zum Debuggen einer einzelnen Abfrage, falls Probleme auftreten. Das Trace-Log wird als query_trace.txt in das Cube-Verzeichnis gedruckt, und die Datei wird vor jeder Abfrageausführung standardmäßig gelöscht. QUERYTRACE darf in der Anwendungskonfiguration nicht für eine langfristige Verwendung aktiviert bleiben, da dies die Performance beeinträchtigen kann.

Hinweis:

Wenn QUERYTRACE auf -1 gesetzt ist, werden nebenläufige Abfragen möglicherweise nicht parallel ausgeführt, und die Performance kann beeinträchtigt werden. Deaktivieren Sie QUERYTRACE nach Abschluss der Fehlerbehebung.

Die Konfigurationseinstellung TRACE_REPORT enthält weniger Details als QUERYTRACE, kann jedoch mehrere gleichzeitige Abfragen verfolgen. TRACE_REPORT ist eine gute Option zum Sammeln von Informationen zu vielen gleichzeitigen Abfragen, die über einen bestimmten Zeitraum ausgeführt werden.

Beispiel

QUERYTRACE -1

Legt das Abfrage-Tracing so fest, dass es alle in der Beschreibung aufgeführten Tracing-Features enthält.