Présentation des tables de suivi de l'utilisation

Le système stocke les données de suivi de l'utilisation dans trois tables de base de données.

Le processus de suivi de l'utilisation crée ces tables avec les noms de table indiqués dans les paramètres de la page Paramètres système.

  • Table de journalisation des requêtes logiques du suivi de l'utilisation
  • Table de journalisation des requêtes physiques du suivi de l'utilisation
  • Table de bloc d'initialisation du suivi de l'utilisation

Reportez-vous à Définition des paramètres de suivi de l'utilisation.

Table de journalisation des requêtes logiques du suivi de l'utilisation

Le tableau ci-dessous décrit chaque colonne de la table de base de données qui suit les requêtes logiques. Le cas échéant, le type de données, tel que la longueur et le champ de caractère variable (varchar et varchar2), est indiqué. Lorsque vous consultez les descriptions de ce tableau, vous pouvez supposer que certaines colonnes en lien avec le temps peuvent être ajoutées aux valeurs exactes égales ou soustraites de celles-ci. Par exemple, vous pouvez supposer que la colonne TOTAL_TIME_SEC est égale à END_TS moins START_TS. Les colonnes ne fournissent pas de telles valeurs exactes pour les raisons suivantes :
  • Divers processus sont exécutés en parallèle et leur vitesse dépend du chargement et des performances de la base de données. Les opérations basées sur le serveur peuvent consommées peu ou beaucoup de ressources.
  • Si toutes les connexions sont pleines, la requête est mise en file d'attente et attend d'être traitée. La mise à disposition dépend du chargement et de la configuration.

Colonnes relatives à l'utilisateur, à la session et à l'ID

Colonne Description

ID

Dans la table de requêtes logiques, cette colonne indique l'identificateur de ligne unique. Dans la table de requêtes physiques, cette colonne est identifiée par le nom LOGICAL_QUERY_ID.

NODE_ID

Contient <hostname>:obis1. Par exemple, examplehost:obis1 (pour une instance unique).

PRESENTATION_NAME

Indique le nom du catalogue. La valeur par défaut est NULL et le type de données est Varchar(128).

IMPERSONATOR_USER_NAME

Indique le nom de l'utilisateur dont l'identité a été empruntée. Si la demande n'est pas exécutée en tant qu'utilisateur dont l'identité a été empruntée, la valeur est Aucun. La valeur par défaut est Aucun et le type de données est Varchar(128).

USER_NAME

Indique le nom de l'utilisateur ayant soumis la requête.
ECID Indique l'ID de contexte d'exécution généré par le système. Le type de données est Varchar2(1024).
TENANT_ID Indique le nom du locataire de l'utilisateur qui a exécuté le bloc d'initialisation. Le type de données est Varchar2(128).
SERVICE_NAME Indique le nom du service. Le type de données est Varchar2(128).
SESSION_ID Indique l'ID de la session. Le type de données est Number(10).
HASH_ID Indique la valeur HASH de la requête logique. Le type de données est Varchar2(128).

Colonnes relatives à l'origine de la requête

Colonne Description

QUERY_SRC_CD

Source de la demande.

Le demandeur peut définir QUERY_SRC_CD sur n'importe quelle valeur de chaîne pour s'identifier.

Valeurs possibles :
  • Report : si la source est une analyse ou une opération d'export.
  • Drill : si la source est une modification de dimension découlant d'une analyse ascendante ou descendante.
  • ValuePrompt : si la source est la liste déroulante Valeur dans une boîte de dialogue de filtre ou une invite de tableau de bord.
  • VisualAnalyzer : si la source est un classeur de visualisation de données.
  • DisplayValueMap, MemberBrowserDisplayValues ou MemberBrowserPath : si la source est une valeur relative à l'affichage d'une analyse.
  • SOAP : si la source est un appel de services Web tel que DataSetSvc.
  • Seed : si la source est un agent qui saisit les données de départ du cache du serveur Analytics Server.
  • NULL : si la source est le nombre de lignes de colonne ou la table physique de l'outil d'administration, ou les données de vue.

SAW_DASHBOARD

Indique le chemin du tableau de bord. Si la requête n'a pas été soumise via un tableau de bord, la valeur est NULL.

SAW_DASHBOARD_PG

Indique le nom de la page dans le tableau de bord. Si la demande n'est pas une demande de tableau de bord, la valeur est NULL. La valeur par défaut est NULL et le type de données est Varchar(150).

SAW_SRC_PATH

Indique le chemin dans le catalogue pour l'analyse.

Colonnes relatives aux détails de la requête

Colonne Description

ERROR_TEXT

Contient le message d'erreur provenant de la base de données back-end. Cette colonne n'est applicable que si SUCCESS_FLAG est défini sur une valeur autre que 0 (zéro). Plusieurs messages sont concaténés et ne sont pas analysés par le système. La valeur par défaut est NULL et le type de données est Varchar(250).

QUERY_BLOB

Contient l'instruction SQL logique complète sans aucune troncation. La colonne QUERY_BLOB est une chaîne de caractères de type Long.

QUERY_KEY

Contient une clé de hachage MD5 générée par le système à partir de l'instruction SQL logique. La valeur par défaut est NULL et le type de données est Varchar(128).

QUERY_TEXT

Indique l'instruction SQL soumise pour la requête. Le type de données est Varchar(1024).

Vous pouvez modifier la longueur de cette colonne (à l'aide de la commande ALTER TABLE), mais le texte écrit dans cette colonne est toujours tronqué de façon à respecter la taille définie dans la couche physique. L'administrateur de modèle sémantique ne doit pas définir la longueur de cette colonne sur une valeur supérieure à la longueur de requête maximale prise en charge par la base de données physique back-end. Par exemple, les bases de données Oracle autorisent une valeur Varchar maximale de 4 000, mais tronquent le texte lorsqu'il atteint 4 000 octets, et non 4 000 caractères. Si vous utilisez un jeu de caractères multioctets, la taille de chaîne maximale réelle a un nombre variable de caractères, en fonction du jeu de caractères et des caractères utilisés.

REPOSITORY_NAME

Indique le nom du modèle sémantique auquel la requête accède.

SUBJECT_AREA_NAME

Contient le nom du modèle de gestion en cours d'utilisation.

SUCCESS_FLG

Indique le statut d'achèvement de la requête, tel que défini dans la liste suivante :

  • 0 : requête terminée sans erreur.
  • 1 : la requête a expiré.
  • 2 : échec de la requête en raison du dépassement des limites de ligne.
  • 3 : échec de la requête pour un autre motif.

Colonnes relatives aux données temporelles d'exécution

Colonne Description

COMPILE_TIME_SEC

Contient la durée requise pour compiler la requête en secondes. Le nombre pour COMPILE_TIME_SEC est inclus dans TOTAL_TIME_SEC.

END_DT

Indique la date de fin de la requête logique.

END_HOUR_MIN

Indique l'heure de fin (avec heures et minutes) de la requête logique.

END_TS

Indique la date et l'heure de fin de la requête logique. Les horodatages de début et de fin reflètent également le temps que la requête a passé à attendre que les ressources soient disponibles. Si l'utilisateur qui soumet la requête quitte la page avant la fin de celle-ci, l'extraction finale n'est pas effectuée et une valeur d'expiration de 3 600 est enregistrée. Toutefois, si l'utilisateur revient sur la page avant la fin du délai d'expiration, l'extraction se termine à ce moment, qui est enregistré en tant que temps end_ts.

START_DT

Indique la date de soumission de la requête logique.

START_HOUR_MIN

Indique l'heure de soumission (avec heures et minutes) de la requête logique.

START_TS

Indique la date et l'heure de soumission de la requête logique.

TOTAL_TIME_SEC

Indique la durée en secondes durant laquelle le système a travaillé sur la requête pendant que le client attendait des réponses à ses analyses. TOTAL_TIME_SEC inclut le temps de COMPILE_TIME_SEC.
RESP_TIME_SEC Indique le temps nécessaire pour répondre à la requête. Le type de données est Number(10).

Colonnes relatives aux détails d'exécution

Colonne Description

CUM_DB_TIME_SEC

Contient la durée cumulée de toutes les requêtes envoyées à la base de données. Les requêtes sont exécutées en parallèle. Par conséquent, la durée de requête cumulée est égale ou supérieure à la durée totale de connexion à la base de données. Par exemple, si une requête logique génère 4 instructions SQL physiques envoyées à la base de données, et que la durée de requête est de 10 secondes pour 3 d'entre elles et de 15 secondes pour la dernière, CUM_DB_TIME_SEC affiche 45 secondes car les requêtes sont exécutées en parallèle.

CUM_NUM_DB_ROW

Contient le nombre total de lignes renvoyées par les bases de données back-end.

NUM_DB_QUERY

Indique le nombre de requêtes soumises aux bases de données back-end pour répondre à la demande de requête logique. Pour les requêtes ayant abouti (SuccessFlag = 0), ce nombre est égal ou supérieur à 1.

ROW_COUNT

Indique le nombre de lignes renvoyées au client de requête. Si la requête renvoie une grande quantité de données, cette colonne n'est remplie que lorsque l'utilisateur affiche toutes les données.
TOTAL_TEMP_KB Indique le nombre total de ko reçus pour une requête. Le type de données est Number(10).

Colonnes relatives au cache

Colonne Description

CACHE_IND_FLG

Contient Y pour indiquer un accès réussi au cache de la requête et N pour indiquer un accès non réussi au cache. La valeur par défaut est N.

NUM_CACHE_HITS

Indique le nombre de résultats du cache renvoyés pour la requête. NUM_CACHE_HITS est un entier 32 bits (ou un entier de 10 chiffres). La valeur par défaut est NULL.

NUM_CACHE_INSERTED

Indique le nombre d'entrées de cache générées par la requête. La valeur par défaut est NULL. NUM_CACHE_INSERTED est un entier 32 bits (ou un entier de 10 chiffres).

Table de journalisation des requêtes physiques du suivi de l'utilisation

Le tableau ci-dessous décrit la table de base de données qui suit les requêtes physiques. Cette table de base de données enregistre les informations SQL physiques pour les requêtes logiques stockées dans la table de journalisation de requêtes logiques. La table de requêtes physiques a une relation de clé étrangère avec la table de requêtes logiques.

Colonnes relatives à l'utilisateur, à la session et à l'ID

Colonne Description

ID

Indique l'identificateur de ligne unique.

LOGICAL_QUERY_ID

Fait référence à la requête logique dans la table de journalisation des requêtes logiques. Le type de données est Varchar2(50).
HASH_ID Indique la valeur HASH de la requête logique. Le type de données est Varchar2(128).
PHYSICAL_HASH_ID Indique la valeur HASH de la requête physique. Le type de données est Varchar2(128).

Colonnes relatives aux détails de la requête

Colonne Description

QUERY_BLOB

Contient l'instruction SQL physique complète sans aucune troncation. La colonne QUERY_BLOB est une chaîne de caractères de type Long.

QUERY_TEXT

Contient l'instruction SQL soumise pour la requête. Le type de données est Varchar(1024).

Colonnes relatives aux données temporelles d'exécution

Colonne Description

END_DT

Indique la date de fin de la requête physique.

END_HOUR_MIN

Indique l'heure de fin (avec heures et minutes) de la requête physique.

END_TS

Indique la date et l'heure de fin de la requête physique. Les horodatages de début et de fin reflètent également le temps que la requête a passé à attendre que les ressources soient disponibles.

TIME_SEC

Indique le temps d'exécution de la requête physique.

START_DT

Indique la date de soumission de la requête physique.

START_HOUR_MIN

Indique l'heure de soumission (avec heures et minutes) de la requête physique.

START_TS

Indique la date et l'heure de soumission de la requête physique.

Colonnes relatives aux détails d'exécution

Colonne Description

ROW_COUNT

Contient le nombre de lignes renvoyées au client de requête.

Table de bloc d'initialisation du suivi de l'utilisation

Le tableau ci-dessous décrit la table de base de données qui suit les informations sur les blocs d'initialisation.

Remarque :

Actuellement, les tables de suivi de l'utilisation des blocs d'initialisation incluent uniquement les blocs d'initialisation de session, et non les blocs d'initialisation de modèle sémantique.

Colonnes relatives à l'utilisateur, à la session et à l'ID

Colonne Description
USER_NAME Nom de l'utilisateur qui a exécuté le bloc d'initialisation. Le type de données est Varchar2(128).
TENANT_ID Nom du locataire de l'utilisateur qui a exécuté le bloc d'initialisation. Le type de données est Varchar2(128).
SERVICE_NAME Nom du service. Le type de données est Varchar2(128).
ECID ID de contexte d'exécution généré par le système. Le type de données est Varchar2(1024).
SESSION_ID ID de la session. Le type de données est Number(10).

Colonnes relatives aux détails de la requête

Colonne Description
REPOSITORY_NAME Nom du modèle sémantique auquel la requête accède. Le type de données est Varchar2(128).
BLOCK_NAME Nom du bloc d'initialisation exécuté. Le type de données est Varchar2(128).

Colonnes relatives aux données temporelles d'exécution

Colonne Description
START_TS Date et heure de démarrage du bloc d'initialisation.
END_TS Date et heure de fin du bloc d'initialisation. Les horodatages de début et de fin reflètent également le temps que la requête a passé à attendre que les ressources soient disponibles.
DURATION Durée d'exécution du bloc d'initialisation. Le type de données est Number(13,3).

Colonnes relatives aux détails d'exécution

Colonne Description
NOTES Remarques sur le bloc d'initialisation et son exécution. Le type de données est Varchar2(1024).