Comprendre les 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.

Pour créer ces tables, le processus de suivi de l'utilisation utilise les noms que vous spécifiez dans la page Paramètres de système.

Table d'enregistrement des interrogations logiques de suivi de l'utilisation
Table d'enregistrement des interrogations physiques de suivi de l'utilisation
Table du bloc d'initialisation du suivi de l'utilisation

Voir Définir les paramètres de suivi de l'utilisation.

Table d'enregistrement des interrogations logiques de suivi de l'utilisation

Le tableau suivant décrit chaque colonne de la table de base de données de suivi des interrogations logiques. Le cas échéant, le type de données, tel que champ de caractères variables (varchar et varchar2) et longueur, est indiqué. Lorsque vous vérifiez les descriptions de ce tableau, vous pouvez présumer que certaines colonnes correspondant à des valeurs de temps peuvent être additionnées ou soustraites pour obtenir des valeurs exactes. Vous pouvez, par exemple, présumer que TOTAL_TIME_SEC est égal à END_TS moins START_TS. Les valeurs des colonnes ne sont pas aussi précises car :

Divers processus sont exécutés en parallèle et leur vitesse dépend de la charge et de la performance de la base de données. Les opérations de serveur peuvent être limitées ou intensives.
Si toutes les connexions sont occupées, l'interrogation est placée dans la file d'attente de traitement. Le délai dépend de la charge et de la configuration.

Colonnes associées à l'utilisateur, la session et l'ID

Colonne	Description
`ID`	Dans la table des interrogations logiques, cette colonne indique l'identificateur de rangée unique. Dans la table des interrogations physiques, cette colonne est indiquée par le nom `LOGICAL_QUERY_ID`.
`NODE_ID`	Contient `<hostname>:obis1`. Par exemple, `examplehost:obis1` (pour une seule instance).
`PRESENTATION_NAME`	Indique le nom du catalogue. La valeur par défaut est nulle et le type de données, Varchar(128).
`IMPERSONATOR_USER_NAME`	Spécifie le nom de l'utilisateur faisant l'objet d'un emprunt d'identité. Si la demande n'est pas exécutée dans ce mode, la valeur est Aucun. La valeur par défaut est Aucun et le type de données, Varchar(128).
`USER_NAME`	Spécifie le nom de l'utilisateur qui a soumis l'interrogation.
`ECID`	Indique l'ID contexte d'exécution généré par le système. Le type de données est Varchar2(1024).
`TENANT_ID`	Indique le nom de la location 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` pour l'interrogation logique. Le type de données est Varchar2(128).

Colonnes associées à l'origine de l'interrogation

Colonne	Description
`QUERY_SRC_CD`	Source de la demande. Notez que le demandeur peut régler QUERY_SRC_CD à toute valeur de chaîne pour s'identifier. Les valeurs valides sont les suivantes : Report - Si la source est une analyse ou une opération d'exportation quelconque. Drill - Si la source est une modification de dimension causée par un forage ascendant ou descendant. ValuePrompt - Si la source est la liste déroulante Valeur de la boîte de dialogue de filtre ou une invite du tableau de bord. VisualAnalyzer - Si la source est un classeur de visualisation des données. DisplayValueMap ou MemberBrowserDisplayValues ou MemberBrowserPath - Si la source est une valeur liée à l'affichage d'une analyse. SOAP - Si la source est un appel à partir de services Web, par exemple DataSetSvc. Seed - Si la source est un agent qui entre les données de départ dans la mémoire cache du serveur d'analyse. Null - Si la source est la table physique ou le nombre de rangées par colonne de l'outil d'administration, ou les données affichées.
`SAW_DASHBOARD`	Indique le nom du chemin d'accès au tableau de bord. Si l'interrogation n'a pas été soumise par l'intermédiaire d'un tableau de bord, la valeur est nulle.
`SAW_DASHBOARD_PG`	Indique le nom de la page dans le tableau de bord. S'il ne s'agit pas d'une demande de tableau de bord, la valeur est nulle. La valeur par défaut est nulle et le type de données, Varchar(150).
`SAW_SRC_PATH`	Spécifie le nom du chemin d'accès à l'analyse dans le catalogue.

Colonnes associées aux détails de l'interrogation

Colonne	Description
`ERROR_TEXT`	Contient le message d'erreur provenant de la base de données dorsale. Cette colonne ne s'applique que si `SUCCESS_FLAG` est réglé à une valeur différente de 0 (zéro). Les messages multiples sont concaténés et ne sont pas analysés par le système. La valeur par défaut est nulle et le type de données, Varchar(250).
`QUERY_BLOB`	Contient l'énoncé SQL logique entier, non tronqué. 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'énoncé SQL logique. La valeur par défaut est nulle et le type de données, Varchar(128).
`QUERY_TEXT`	Indique l'énoncé SQL soumis pour l'interrogation. Le type de données est Varchar(1024). Vous pouvez modifier la longueur de cette colonne (à l'aide de la commande ALTER TABLE), mais notez que le texte qui y est inscrit est toujours tronqué à la taille définie dans la couche physique. L'administrateur du modèle sémantique ne doit pas régler la longueur de cette colonne à une valeur supérieure à la longueur d'interrogation maximum prise en charge par la base de données physique dorsale. Par exemple, les bases de données Oracle autorisent une Varchar maximum de 4000, mais les tronquent à 4000 octets, et non à 4000 caractères. Si vous utilisez un jeu de caractères multioctets, la taille de chaîne maximum réelle comprend un nombre de caractères variable, en fonction du jeu et des caractères utilisés.
`REPOSITORY_NAME`	Spécifie le nom du modèle sémantique auquel l'interrogation accède.
`SUBJECT_AREA_NAME`	Contient le nom du modèle d'affaires consulté.
`SUCCESS_FLG`	Indique le statut d'achèvement de l'interrogation, tel que défini dans la liste suivante : 0 - L'interrogation a été exécutée sans erreur. 1 - Temporisation de l'interrogation. 2 - L'interrogation a échoué car les limites de rangée ont été dépassées. 3 - L'interrogation a échoué pour un autre motif.

Colonnes associées à la durée d'exécution

Colonne	Description
`COMPILE_TIME_SEC`	Contient la durée en secondes nécessaire à la compilation de l'interrogation. Le nombre `COMPILE_TIME_SEC` est inclus dans `TOTAL_TIME_SEC`.
`END_DT`	Indique la date de fin d'exécution de l'interrogation logique.
`END_HOUR_MIN`	Indique l'heure et la minute de fin d'exécution de l'interrogation logique.
`END_TS`	Indique la date et l'heure de fin d'exécution de l'interrogation logique. Les horodatages de début et de fin reflètent également la durée éventuelle pendant laquelle l'interrogation attend la libération des ressources. Si l'utilisateur quitte la page avant la fin de l'exécution de l'interrogation qu'il soumet, l'extraction finale n'a jamais lieu et une valeur de temporisation de 3600 est enregistrée. Toutefois, s'il retourne dans la page avant la temporisation, l'extraction s'exécute alors et est enregistrée dans la valeur `end_ts`.
`START_DT`	Indique la date de soumission de l'interrogation logique.
`START_HOUR_MIN`	Indique l'heure et la minute de soumission de l'interrogation logique.
`START_TS`	Indique la date et l'heure de soumission de l'interrogation logique.
`TOTAL_TIME_SEC`	Indique la durée (en secondes) de traitement de l'interrogation par le système pendant que le client attendait les réponses à ses analyses. `TOTAL_TIME_SEC` inclut la durée de `COMPILE_TIME_SEC`.
`RESP_TIME_SEC`	Indique le temps de réponse à l'interrogation. Le type de données est Number(10).

Colonnes associées aux détails d'exécution

Colonne	Description
`CUM_DB_TIME_SEC`	Contient la durée cumulée de toutes les interrogations envoyées à la base de données. Les interrogations étant exécutées en parallèle, leur durée cumulée est égale ou supérieure à la durée totale de connexion à la base de données. Supposons qu'une demande logique entraîne l'envoi de quatre énoncés SQL physique à la base de données et que la durée de trois des interrogations est de 10 secondes, de 15 secondes pour la quatrième. `CUM_DB_TIME_SEC` affiche alors 45 secondes, car les interrogations sont exécutées en parallèle.
`CUM_NUM_DB_ROW`	Contient le nombre de rangées retournées par les bases de données dorsales.
`NUM_DB_QUERY`	Indique le nombre d'interrogations soumises aux bases de données dorsales pour répondre à la demande d'interrogation logique. Pour les interrogations réussies (SuccessFlag = 0), ce nombre est supérieur ou égal à 1.
`ROW_COUNT`	Indique le nombre de rangées retournées au client d'interrogation. Si une interrogation retourne un volume important de données, cette colonne n'est alimentée que lorsque l'utilisateur les affiche toutes.
`TOTAL_TEMP_KB`	Indique le nombre total de Ko reçus pour une interrogation. Le type de données est Number(10).

Colonnes associées à la mise en cache

Colonne	Description
`CACHE_IND_FLG`	Contient Y pour indiquer une présence dans la mémoire cache pour l'interrogation; N, pour une absence. La valeur par défaut est N.
`NUM_CACHE_HITS`	Indique le nombre d'occurrences retournées par le résultat de la mémoire cache pour l'interrogation. `NUM_CACHE_HITS` est un nombre entier de 32 bits (ou un nombre entier à 10 chiffres). La valeur par défaut est nulle.
`NUM_CACHE_INSERTED`	Indique le nombre de fois où l'interrogation a généré une entrée en mémoire cache. La valeur par défaut est nulle. `NUM_CACHE_INSERTED` est un nombre entier de 32 bits (ou un nombre entier à 10 chiffres).

Table d'enregistrement des interrogations physiques de suivi de l'utilisation

Le tableau suivant décrit les tables de base de données de suivi des interrogations physiques. Cette table de base de données enregistre les informations SQL physiques des interrogations logiques stockées dans la table d'enregistrement des interrogations logiques. La table des interrogations physiques est dotée d'une relation de clé étrangère à la table des interrogations logiques.

Colonnes associées à l'utilisateur, la session et l'ID

Colonne	Description
`ID`	Spécifie l'identificateur de rangée unique.
`LOGICAL_QUERY_ID`	Fait référence à l'interrogation logique dans la table d'enregistrement des interrogations logiques. Le type de données est Varchar2(50).
`HASH_ID`	Indique la valeur `HASH` pour l'interrogation logique. Le type de données est Varchar2(128).
`PHYSICAL_HASH_ID`	Indique la valeur `HASH` pour l'interrogation physique. Le type de données est Varchar2(128).

Colonnes associées aux détails de l'interrogation

Colonne	Description
`QUERY_BLOB`	Contient l'énoncé SQL physique entier, non tronqué. La colonne `QUERY_BLOB` est une chaîne de caractères de type Long.
`QUERY_TEXT`	Contient l'énoncé SQL soumis pour l'interrogation. Le type de données est Varchar(1024).

Colonnes associées à la durée d'exécution

Colonne	Description
`END_DT`	Indique la date de fin d'exécution de l'interrogation physique.
`END_HOUR_MIN`	Indique l'heure et la minute de fin d'exécution de l'interrogation physique.
`END_TS`	Indique la date et l'heure de fin d'exécution de l'interrogation physique. Les horodatages de début et de fin reflètent également la durée éventuelle pendant laquelle l'interrogation attend la libération des ressources.
`TIME_SEC`	Indique la durée d'exécution de l'interrogation physique.
`START_DT`	Indique la date de soumission de l'interrogation physique.
`START_HOUR_MIN`	Indique l'heure et la minute de soumission de l'interrogation physique.
`START_TS`	Indique la date et l'heure de soumission de l'interrogation physique.

Colonnes associées aux détails d'exécution

Colonne	Description
`ROW_COUNT`	Contient le nombre de rangées retournées au client d'interrogation.

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

Le tableau suivant décrit la table de base de données de suivi des informations sur les blocs d'initialisation.

Note :

Actuellement les tables de suivi de l'utilisation des blocs d'initialisation ne comportent pas les blocs d'initialisation de modèle sémantique mais uniquement les blocs d'initialisation de session.

Colonnes associées à 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 de la location 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 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 associées aux détails de l'interrogation

Colonne	Description
`REPOSITORY_NAME`	Nom du modèle sémantique auquel l'interrogation accède. Le type de données est Varchar2(128).
`BLOCK_NAME`	Nom du bloc d'initialisation qui a été exécuté. Le type de données est Varchar2(128).

Colonnes associées à la durée 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 la durée éventuelle pendant laquelle l'interrogation attend la libération des ressources.
`DURATION`	Durée d'exécution du bloc d'initialisation. Le type de données est Number(13,3).

Colonnes associées aux détails d'exécution

Colonne	Description
`NOTES`	Notes au sujet du bloc d'initialisation et de son exécution. Le type de données est Varchar2(1024).