Nutzungstrackingtabellen

Das System speichert Nutzungstrackingdaten in drei Datenbanktabellen.

Der Nutzungstrackingprozess erstellt diese Tabellen mit Tabellennamen, die Sie über Einstellungen auf der Seite "Systemeinstellungen" angeben.

  • Loggingtabelle für logische Abfragen zum Nutzungstracking
  • Loggingtabelle für physische Abfragen zum Nutzungstracking
  • Initialisierungsblocktabelle für Nutzungstracking

Siehe Nutzungstrackingparameter festlegen.

Loggingtabelle für logische Abfragen zum Nutzungstracking

In der folgenden Tabelle werden die einzelnen Spalten in der Datenbanktabelle beschrieben, in der logische Abfragen verfolgt werden. Gegebenenfalls sind der Datentyp wie Variablenzeichenfeld (varchar und varchar2) und -länge angegeben. Die Beschreibungen in dieser Tabelle lassen möglicherweise vermuten, dass bestimmte zeitbezogene Spalten zu exakt gleichen Werten addiert oder subtrahiert werden können. Beispiel: Sie gehen möglicherweise davon aus, dass TOTAL_TIME_SEC gleich END_TS minus START_TS ist. Die Spalten stellen keine solchen exakten Werte bereit, weil:
  • verschiedene Prozesse parallel ausgeführt werden und ihre Geschwindigkeit von der Last und der Datenbankperformance abhängt. Serverbasierte Vorgänge können leicht oder intensiv sein.
  • die Abfrage in eine Queue gestellt wird und auf ihre Verarbeitung wartet, wenn alle Verbindungen ausgelastet sind. Das Timing hängt von der Last und der Konfiguration ab.

Benutzer-, session- und ID-bezogene Spalten

Spalte Beschreibung

ID

In der Tabelle für logische Abfragen gibt diese Spalte die eindeutige Zeilen-ID an. In der Tabelle für physische Abfragen ist diese Spalte mit dem Namen LOGICAL_QUERY_ID gekennzeichnet.

NODE_ID

Enthält <hostname>:obis1. Beispiel: examplehost:obis1 (für eine Einzelinstanz).

PRESENTATION_NAME

Gibt den Namen des Katalogs an. Der Standardwert ist "Null", und der Datentyp ist "Varchar(128)".

IMPERSONATOR_USER_NAME

Gibt den Benutzernamen des impersonierten Benutzers an. Wenn die Anforderung nicht als impersonierter Benutzer ausgeführt wird, ist kein Wert angegeben. Der Standardwert ist "Kein Wert", und der Datentyp ist "Varchar(128)".

USER_NAME

Gibt den Namen des Benutzers an, der die Abfrage weitergeleitet hat.

ECID Gibt die vom System generierte Ausführungskontext-ID an. Der Datentyp ist "Varchar2(1024)".
TENANT_ID Gibt den Namen des Mandanten des Benutzers an, der den Initialisierungsblock ausgeführt hat. Der Datentyp ist "Varchar2(128)".
SERVICE_NAME Gibt den Namen des Service an. Der Datentyp ist "Varchar2(128)".
SESSION_ID Gibt die ID der Session an. Der Datentyp lautet "Number(10)".
HASH_ID Gibt den HASH-Wert für die logische Abfrage an. Der Datentyp ist "Varchar2(128)".

Spalten zum Abfrageursprung

Spalte Beschreibung

QUERY_SRC_CD

Die Quelle der Anforderung.

Beachten Sie, dass der Anforderer QUERY_SRC_CD auf beliebige Zeichenfolgenwerte setzen kann, um sich selbst zu identifizieren.

Mögliche Werte sind:
  • Bericht - Wenn es sich bei der Quelle um eine Analyse oder einen Exportvorgang handelt.
  • Drill: Wenn die Quelle eine Dimensionsänderung ist, die durch einen Drillvorgang nach oben oder unten verursacht wird.
  • ValuePrompt - Wenn es sich bei der Quelle um die Dropdown-Liste "Wert" in einem Filterdialogfeld oder um einen Dashboard-Prompt handelt.
  • VisualAnalyzer: Wenn die Quelle eine Arbeitsmappe zur Datenvisualisierung ist.
  • DisplayValueMap oder MemberBrowserDisplayValues oder MemberBrowserPath: Wenn die Quelle ein Wert im Zusammenhang mit der Anzeige einer Analyse ist.
  • SOAP: Wenn die Quelle ein Aufruf von Webservices wie DataSetSvc ist.
  • Seed - Wenn es sich bei der Quelle um einen Agent handelt, der Seed-Werte für den Cache des Analytics-Servers bereitstellt.
  • Null - Wenn es sich bei der Quelle um die Zeilenanzahl der physischen Tabellen oder Spalten des Administrationstools oder Anzeigedaten handelt.

SAW_DASHBOARD

Gibt den Pfadnamen des Dashboards an. Wenn die Abfrage nicht über ein Dashboard weitergeleitet wurde, ist der Wert NULL.

SAW_DASHBOARD_PG

Gibt den Seitennamen im Dashboard an. Wenn es sich nicht um eine Dashboard-Anforderung handelt, ist der Wert NULL. Der Standardwert ist "Null", und der Datentyp ist "Varchar(150)".

SAW_SRC_PATH

Gibt den Pfadnamen im Katalog für die Analyse an.

Spalten zu Abfragedetails

Spalte Beschreibung

ERROR_TEXT

Enthält die Fehlermeldung von der Backend-Datenbank. Diese Spalte ist nur anwendbar, wenn SUCCESS_FLAG auf einen Wert ungleich 0 (Null) gesetzt ist. Mehrere Meldungen werden verkettet und nicht vom System geparst. Der Standardwert ist "Null", und der Datentyp ist "Varchar(250)".

QUERY_BLOB

Enthält die gesamte logische SQL-Anweisung ohne Kürzung. Die Spalte QUERY_BLOB ist eine Zeichenfolge des Typs "Lang".

QUERY_KEY

Enthält einen MD5-Hashschlüssel, der aus der logischen SQL-Anweisung vom System generiert wird. Der Standardwert ist "Null", und der Datentyp ist "Varchar(128)".

QUERY_TEXT

Gibt die SQL-Anweisung an, die für die Abfrage weitergeleitet wurde. Der Datentyp ist "Varchar(1024)".

Sie können die Länge dieser Spalte (mit dem Befehl ALTER TABLE) ändern. Beachten Sie aber, dass der Text in dieser Spalte immer auf die Größe gekürzt wird, die im physischen Layer definiert ist. Der Administrator für semantische Modelle darf die Länge dieser Spalte nicht auf einen größeren Wert als die maximale Abfragelänge festlegen, die von der physischen Backend-Datenbank unterstützt wird. Beispiel: Für Oracle-Datenbanken ist ein maximaler Varchar-Wert von 4000 zulässig. Allerdings verkürzen Oracle-Datenbanken den Text auf 4000 Byte, nicht auf 4000 Zeichen. Wenn Sie einen Multibyte-Zeichensatz verwenden, entspricht die tatsächliche maximale Zeichenfolgegröße je nach verwendetem Zeichensatz und verwendeten Zeichen verschiedenen Zeichenzahlen.

REPOSITORY_NAME

Gibt den Namen des semantischen Modells an, auf das die Abfrage zugreift.

SUBJECT_AREA_NAME

Enthält den Namen des Geschäftsmodells, auf das zugegriffen wird.

SUCCESS_FLG

Gibt den Abschlussstatus der Abfrage gemäß der Definition in der folgenden Liste an:

  • 0 - Die Abfrage wurde erfolgreich ohne Fehler abgeschlossen.
  • 1 - Die Abfrage wurde wegen Timeout abgebrochen.
  • 2 - Die Abfrage war aufgrund überschrittener Zeilengrenzwerte nicht erfolgreich.
  • 3 - Die Abfrage war aus anderen Gründen nicht erfolgreich.

Spalten zum Ausführungstiming

Spalte Beschreibung

COMPILE_TIME_SEC

Enthält die Zeit in Sekunden, die zum Kompilieren der Abfrage erforderlich ist. Die Anzahl für COMPILE_TIME_SEC ist in TOTAL_TIME_SEC enthalten.

END_DT

Gibt das Datum an, an dem die logische Abfrage abgeschlossen wurde.

END_HOUR_MIN

Gibt die Stunde und Minute an, zu der die logische Abfrage abgeschlossen wurde.

END_TS

Gibt das Datum und die Uhrzeit an, zu der die logische Abfrage abgeschlossen wurde. Bei den Start- und Endzeitstempeln wird auch die Zeit berücksichtigt, während der die Abfrage darauf wartete, dass Ressourcen verfügbar werden. Wenn der Benutzer, der die Abfrage weiterleitet, die Seite vor Abschluss der Abfrage verlässt, wird der abschließende Abruf nicht ausgeführt, und ein Timeoutwert von 3600 wird erfasst. Wenn der Benutzer allerdings noch vor dem Timeout zurück zur Seite navigiert, wird der Abruf zu diesem Zeitpunkt abgeschlossen. Dieser Zeitpunkt wird als end_ts-Zeit erfasst.

START_DT

Gibt das Datum an, an dem die logische Abfrage weitergeleitet wurde.

START_HOUR_MIN

Gibt die Stunde und Minute an, zu der die logische Abfrage weitergeleitet wurde.

START_TS

Gibt das Datum und die Uhrzeit an, zu der die logische Abfrage weitergeleitet wurde.

TOTAL_TIME_SEC

Gibt die Zeit in Sekunden an, die das System für die Bearbeitung der Abfrage gebraucht hat, während der Client auf Antworten für seine Analysen wartete.In TOTAL_TIME_SEC ist die Zeit für COMPILE_TIME_SEC inbegriffen.

RESP_TIME_SEC Gibt die Zeit für die Abfrageantwort an. Der Datentyp lautet "Number(10)".

Spalten zu Ausführungsdetails

Spalte Beschreibung

CUM_DB_TIME_SEC

Enthält die kumulative Zeit aller an die Datenbank gesendeten Abfragen. Die Abfragen werden parallel ausgeführt. Daher ist die kumulative Abfragezeit mindestens gleich der Gesamtzeit der Datenbankverbindung. Beispiel: Eine logische Anforderung erstellt 4 physische SQL-Anweisungen, die an die Datenbank gesendet werden, und die Abfragezeit beträgt für 3 der Abfragen 10 Sekunden und für eine Abfrage 15 Sekunden. In diesem Fall zeigt CUM_DB_TIME_SEC 45 Sekunden an, weil die Abfragen parallel ausgeführt werden.

CUM_NUM_DB_ROW

Enthält die Gesamtanzahl der Zeilen, die von den Backend-Datenbanken zurückgegeben werden.

NUM_DB_QUERY

Gibt die Anzahl der Abfragen an, die an die Backend-Datenbank weitergeleitet wurden, um die logische Abfrageanforderung zu erfüllen. Bei erfolgreichen Abfragen (SuccessFlag = 0) ist diese Anzahl mindestens 1.

ROW_COUNT

Gibt die Anzahl der Zeilen an, die vom Abfrageclient zurückgegeben werden. Wird von einer Abfrage eine große Datenmenge zurückgegeben, wird diese Spalte erst aufgefüllt, wenn der Benutzer alle Daten anzeigt.

TOTAL_TEMP_KB Gibt die insgesamt für eine Abfrage empfangenen KB an. Der Datentyp lautet "Number(10)".

Cachebezogene Spalten

Spalte Beschreibung

CACHE_IND_FLG

Der Wert "J" gibt einen Cachetreffer für die Abfrage an. Der Wert "N" gibt einen Cachefehlschlag an. Der Standardwert ist "N".

NUM_CACHE_HITS

Gibt an, wie oft ein Cacheergebnis für die Abfrage zurückgegeben wird. NUM_CACHE_HITS ist eine 32-Bit-Ganzzahl (oder eine 10-stellige Ganzzahl). Der Standardwert ist Null.

NUM_CACHE_INSERTED

Gibt an, wie häufig die Abfrage einen Cacheeintrag generiert hat. Der Standardwert ist Null. NUM_CACHE_INSERTED ist eine 32-Bit-Ganzzahl (oder eine 10-stellige Ganzzahl).

Loggingtabelle für physische Abfragen zum Nutzungstracking

In der folgenden Tabelle wird die Datenbanktabelle beschrieben, in der physische Abfragen verfolgt werden. In dieser Datenbanktabelle werden physische SQL-Informationen für die logischen Abfragen erfasst, die in der Loggingtabelle für logische Abfragen gespeichert sind. Die physische Abfragetabelle hat eine Fremdschlüsselbeziehung zur logischen Abfragetabelle.

Benutzer-, session- und ID-bezogene Spalten

Spalte Beschreibung

ID

Gibt die eindeutige Zeilen-ID an.

LOGICAL_QUERY_ID

Bezieht sich auf die logische Abfrage in der Loggingtabelle für logische Abfragen. Der Datentyp ist "Varchar(250)".

HASH_ID Gibt den HASH-Wert für die logische Abfrage an. Der Datentyp ist "Varchar2(128)".
PHYSICAL_HASH_ID Gibt den HASH-Wert für die physische Abfrage an. Der Datentyp ist "Varchar2(128)".

Spalten zu Abfragedetails

Spalte Beschreibung

QUERY_BLOB

Enthält die gesamte physische SQL-Anweisung ohne Kürzung. Die Spalte QUERY_BLOB ist eine Zeichenfolge des Typs "Long".

QUERY_TEXT

Enthält die SQL-Anweisung, die für die Abfrage weitergeleitet wurde. Der Datentyp ist "Varchar(1024)".

Spalten zum Ausführungstiming

Spalte Beschreibung

END_DT

Gibt das Datum an, an dem die physische Abfrage abgeschlossen wurde.

END_HOUR_MIN

Gibt die Stunde und Minute an, zu der die physische Abfrage abgeschlossen wurde.

END_TS

Gibt das Datum und die Uhrzeit an, zu der die physische Abfrage abgeschlossen wurde. Bei den Start- und Endzeitstempeln wird auch die Zeit berücksichtigt, während der die Abfrage darauf wartete, dass Ressourcen verfügbar werden.

TIME_SEC

Gibt die Ausführungszeit der physischen Abfrage an.

START_DT

Gibt das Datum an, an dem die physische Abfrage weitergeleitet wurde.

START_HOUR_MIN

Gibt die Stunde und Minute an, zu der die physische Abfrage weitergeleitet wurde.

START_TS

Gibt das Datum und die Uhrzeit an, zu der die physische Abfrage weitergeleitet wurde.

Spalten zu Ausführungsdetails

Spalte Beschreibung

ROW_COUNT

Enthält die Anzahl der Zeilen, die vom Abfrageclient zurückgegeben werden.

Initialisierungsblocktabelle für Nutzungstracking

In der folgenden Tabelle wird die Datenbanktabelle beschrieben, in der Informationen zu den Initialisierungsblöcken verfolgt werden.

Hinweis:

Derzeit enthalten die Nutzungstrackingtabellen für Initialisierungsblöcke nur Sessioninitialisierungsblöcke und keine Initialisierungsblöcke für semantische Modelle.

Benutzer-, session- und ID-bezogene Spalten

Spalte Beschreibung
USER_NAME Der Name des Benutzers, der den Initialisierungsblock ausgeführt hat. Der Datentyp ist "Varchar2(128)".
TENANT_ID Der Name des Mandanten des Benutzers, der den Initialisierungsblock ausgeführt hat. Der Datentyp ist "Varchar2(128)".
SERVICE_NAME Der Name des Service. Der Datentyp ist "Varchar2(128)".
ECID Die vom System generierte Ausführungskontext-ID. Der Datentyp ist "Varchar2(1024)".
SESSION_ID Die ID der Session. Der Datentyp lautet "Number(10)".

Spalten zu Abfragedetails

Spalte Beschreibung
REPOSITORY_NAME Der Name des semantischen Modells, auf das die Abfrage zugreift. Der Datentyp ist "Varchar2(128)".
BLOCK_NAME Der Name des ausgeführten Initialisierungsblocks. Der Datentyp ist "Varchar2(128)".

Spalten zum Ausführungstiming

Spalte Beschreibung
START_TS Datum und Uhrzeit des Starts des Initialisierungsblocks.
END_TS Datum und Uhrzeit der Beendigung des Initialisierungsblocks. Bei den Start- und Endzeitstempeln wird auch die Zeit berücksichtigt, während der die Abfrage darauf wartete, dass Ressourcen verfügbar werden.
DURATION Die Dauer der Ausführung des Initialisierungsblocks. Der Datentyp lautet "Number(13,3)".

Spalten zu Ausführungsdetails

Spalte Beschreibung
NOTES Hinweise zum Initialisierungsblock und dessen Ausführung. Der Datentyp ist "Varchar2(1024)".