Descripción de las tablas de seguimiento de uso

El sistema almacena los datos de seguimiento de uso en tres tablas de base de datos.

El proceso de seguimiento de uso crea estas tablas con los nombres de tabla que especifique mediante los valores de la página Configuración del sistema.

  • Tabla de registro de seguimiento de uso de las consultas lógicas
  • Tabla de registro de seguimiento de uso de las consultas físicas
  • Tabla de bloque de inicialización de seguimiento de uso

Consulte Definir parámetros de seguimiento de uso.

Tabla de registro de seguimiento de uso de las consultas lógicas

En la tabla siguiente, se describe cada columna de la tabla de base de datos que realiza un seguimiento de las consultas lógicas. Cuando es necesario, se especifica el tipo de dato, como el campo de caracteres de variable (varchar y varchar2) y la longitud. Mientras revisa las descripciones de esta tabla, podría asumir que determinadas columnas relacionadas con el tiempo se pueden agregar o restar a valores exactos iguales. Por ejemplo, podría asumir que TOTAL_TIME_SEC es igual que END_TS menos START_TS. Las columnas no proporcionan estos valores exactos porque:
  • Se ejecutan varios procesos en paralelo, y su velocidad depende de la carga y del rendimiento de la base de datos. Las operaciones basadas en el servidor pueden ser ligeras o intensivas.
  • Si todas las conexiones están completas, la consulta entra en una cola y espera su procesamiento. El tiempo depende de la carga y de la configuración.

Columnas relacionadas con el usuario, la sesión y el identificador

Columna Descripción

ID

En la tabla de consultas lógicas, esta columna indica el identificado de fila único. En la tabla de consultas físicas, esta columna se identifica mediante el nombre LOGICAL_QUERY_ID.

NODE_ID

Contiene <hostname>:obis1. Por ejemplo, examplehost:obis1 (para una instancia única).

PRESENTATION_NAME

Indica el nombre del catálogo. El valor por defecto es Null y el tipo de dato es Varchar(128).

IMPERSONATOR_USER_NAME

Especifica el nombre del usuario suplantado. Si la solicitud no se ejecuta como un usuario suplantado, el valor es None. El valor por defecto es None y el tipo de dato es Varchar(128).

USER_NAME

Especifica el nombre del usuario que ha enviado la consulta.

ECID Indica el identificador de contexto de ejecución generado por el sistema. El tipo de dato es Varchar2(1024).
TENANT_ID Especifica el nombre del inquilino del usuario que ha ejecutado el bloque de inicialización. El tipo de dato es Varchar2(128).
SERVICE_NAME Especifica el nombre del servicio. El tipo de dato es Varchar2(128).
SESSION_ID Indica el identificador de la sesión. El tipo de datos es Number(10).
HASH_ID Indica el valor HASH de la consulta lógica. El tipo de dato es Varchar2(128).

Columnas relacionadas con el origen de la consulta

Columna Descripción

QUERY_SRC_CD

Origen de la solicitud.

Tenga en cuenta que el solicitante puede definir QUERY_SRC_CD en cualquier valor de cadena para identificarse a sí mismo.

Entre los valores posibles se incluyen:
  • Report: si el origen es un análisis o cualquier operación de exportación.
  • Drill: si el origen es un cambio en la dimensión causado por una reducción o un aumento de detalle.
  • ValuePrompt: si el origen es la lista desplegable Valor de un cuadro de diálogo de filtro o una petición de datos del panel de control.
  • VisualAnalyzer: si el origen es un libro de trabajo para visualizar datos.
  • DisplayValueMap o MemberBrowserDisplayValues o MemberBrowserPath: si el origen es un valor relacionado con la visualización de un análisis.
  • SOAP: si el origen es una llamada desde servicios web como DataSetSvc.
  • Seed: si el origen es un agente que inicia la caché del servidor de análisis.
  • Null: si el origen es la tabla física o el recuento de filas/columnas de la herramienta de administración, o los datos de visualización.

SAW_DASHBOARD

Indica el nombre de la ruta de acceso del panel de control. Si la consulta no se ha enviado a través de un panel de control, el valor es NULL.

SAW_DASHBOARD_PG

Indica el nombre de página en el panel de control. Si la solicitud no es una solicitud de panel de control, el valor es NULL. El valor por defecto es Null y el tipo de dato es Varchar(150).

SAW_SRC_PATH

Especifica el nombre de la ruta de acceso en el catálogo para el análisis.

Columnas relacionadas con los detalles de la consulta

Columna Descripción

ERROR_TEXT

Contiene el mensaje de error de la base de datos backend. Esta columna solo es aplicable si SUCCESS_FLAG se define en un valor distinto de 0 (cero). Se concatenan varios mensajes, y el sistema no los analiza. El valor por defecto es Null, y el tipo de dato es Varchar(250).

QUERY_BLOB

Contiene la sentencia SQL lógica completa sin ningún truncamiento. La columna QUERY_BLOB es una cadena de caracteres de tipo long.

QUERY_KEY

Contiene una clave hash MD5 generada por el sistema a partir de la sentencia SQL lógica. El valor por defecto es Null, y el tipo de dato es Varchar(128).

QUERY_TEXT

Indica la sentencia SQL que se ha enviado para la consulta. El tipo de dato es Varchar(1024).

Puede cambiar la longitud de esta columna (mediante el comando ALTER TABLE), pero tenga en cuenta que el texto que se escribe en esta columna siempre se trunca al tamaño que se haya definido en la capa física. El administrador del modelo semántico no debe definir la longitud de esta columna en un valor mayor que la longitud máxima de consulta soportada por la base de datos backend física. Por ejemplo, las bases de datos Oracle permiten un Varchar máximo de 4000, pero lo truncan en 4000 bytes, y no en 4000 caracteres. Si utiliza un juego de caracteres multibyte, el tamaño máximo de cadena real tiene un número de caracteres que varía según el juego de caracteres y los caracteres utilizados.

REPOSITORY_NAME

Especifica el nombre del modelo semántico al que accede la consulta.

SUBJECT_AREA_NAME

Contiene el nombre del modelo de negocio al que se está accediendo.

SUCCESS_FLG

Indica el estado de terminación de la consulta, como se define en la siguiente lista:

  • 0: la consulta se ha completado correctamente sin errores.
  • 1: la consulta ha sufrido un timeout.
  • 2: la consulta ha fallado porque se han sobrepasado los límites de fila.
  • 3: la consulta ha fallado debido a algún otro motivo.

Columnas relacionadas con la temporización de la ejecución

Columna Descripción

COMPILE_TIME_SEC

Contiene el tiempo, en segundos, necesario para compilar la consulta. El número de COMPILE_TIME_SEC está incluido en TOTAL_TIME_SEC.

END_DT

Indica la fecha en la que se completó la consulta lógica.

END_HOUR_MIN

Indica la hora y los minutos a la que se completó la consulta lógica.

END_TS

Indica la fecha y la hora a la que se completó la consulta lógica. Los registros de hora de inicio y finalización también reflejan el tiempo que ha estado esperando la consulta para que estén disponibles los recursos. Si el usuario que envía la consulta sale de la página antes de que finalice la consulta, no se realizará la recuperación final y se registrará un valor de timeout de 3600. Sin embargo, si el usuario regresa a la página antes del timeout, en ese momento se completará la recuperación y se registrará como la hora end_ts.

START_DT

Indica la fecha en la que se envió la consulta lógica.

START_HOUR_MIN

Indica la hora y los minutos a la que se envió la consulta lógica.

START_TS

Indica la fecha y la hora a la que se envió la consulta lógica.

TOTAL_TIME_SEC

Indica el tiempo, en segundos, que ha invertido el sistema en trabajar en la consulta mientras el cliente esperaba las respuestas a sus análisis. TOTAL_TIME_SEC incluye el tiempo para COMPILE_TIME_SEC.

RESP_TIME_SEC Indica el tiempo empleado para la respuesta a la consulta. El tipo de datos es Number(10).

Columnas relacionadas con los detalles de la ejecución

Columna Descripción

CUM_DB_TIME_SEC

Contiene el tiempo acumulado de todas las consultas enviadas a la base de datos. Las consultas se ejecutan en paralelo, de modo que el tiempo de consulta acumulado es igual o mayor que el tiempo total de conexión a la base de datos. Por ejemplo, suponga que una solicitud lógica genera el envío de 4 sentencias SQL físicas a la base de datos, y que el tiempo de consulta de 3 de las consultas es de 10 segundos, y el de una consulta, de 15 segundos; CUM_DB_TIME_SEC muestra 45 segundos porque las consultas se ejecutan en paralelo.

CUM_NUM_DB_ROW

Contiene el número total de filas devueltas por las bases de datos backend.

NUM_DB_QUERY

Indica el número de consultas que se han enviado a las bases de datos backend para cumplir la solicitud de consulta lógica. Para las consultas correctas (SuccessFlag = 0), este número es 1 o mayor.

ROW_COUNT

Indica el número de filas devueltas al cliente de la consulta. Cuando se devuelve una gran cantidad de datos de una consulta, esta columna no se rellena hasta que el usuario muestra todos los datos.

TOTAL_TEMP_KB Especifica el total de KB recibidos para una consulta. El tipo de datos es Number(10).

Columnas relacionadas con la caché

Columna Descripción

CACHE_IND_FLG

Contiene Y para indicar un acierto de caché de la consulta; N para indicar una falta de caché. El valor por defecto es N.

NUM_CACHE_HITS

Indica el número de veces que se ha devuelto el resultado de la caché para la consulta. NUM_CACHE_HITS es un entero de 32 bits (o un entero de 10 dígitos). El valor por defecto es Null.

NUM_CACHE_INSERTED

Indica el número de veces que la consulta ha generado una entrada de caché. El valor por defecto es Null. NUM_CACHE_INSERTED es un entero de 32 bits (o un entero de 10 dígitos).

Tabla de registro de seguimiento de uso de las consultas físicas

En la tabla siguiente, se describe la tabla de base de datos que realiza el seguimiento de las consultas físicas. Esta tabla de base de datos registra la información SQL física de las consultas lógicas almacenadas en la tabla de registro de consultas lógicas. La tabla de consultas físicas tiene una relación de clave ajena con la tabla de consultas lógicas.

Columnas relacionadas con el usuario, la sesión y el identificador

Columna Descripción

ID

Especifica el identificador de fila único.

LOGICAL_QUERY_ID

Hace referencia a la consulta lógica en la tabla de registro de consultas lógicas. El tipo de dato es Varchar2(50).

HASH_ID Indica el valor HASH de la consulta lógica. El tipo de dato es Varchar2(128).
PHYSICAL_HASH_ID Indica el valor HASH de la consulta física. El tipo de dato es Varchar2(128).

Columnas relacionadas con los detalles de la consulta

Columna Descripción

QUERY_BLOB

Contiene la sentencia SQL física completa sin ningún truncamiento. La columna QUERY_BLOB es una cadena de caracteres de tipo long.

QUERY_TEXT

Contiene la sentencia SQL enviada para la consulta. El tipo de dato es Varchar(1024).

Columnas relacionadas con la temporización de la ejecución

Columna Descripción

END_DT

Indica la fecha en la que se completó la consulta física.

END_HOUR_MIN

Indica la hora y los minutos a la que se completó la consulta lógica.

END_TS

Indica la fecha y la hora a la que se completó la consulta física. Los registros de hora de inicio y finalización también reflejan el tiempo que ha estado esperando la consulta para que estén disponibles los recursos.

TIME_SEC

Indica el tiempo de ejecución de la consulta física.

START_DT

Indica la fecha en la que se envió la consulta física.

START_HOUR_MIN

Indica la hora y los minutos a la que se envió la consulta física.

START_TS

Indica la fecha y la hora a la que se envió la consulta física.

Columnas relacionadas con los detalles de la ejecución

Columna Descripción

ROW_COUNT

Contiene el número de filas devueltas al cliente de la consulta.

Tabla de bloque de inicialización de seguimiento de uso

En la tabla siguiente se describe la tabla de base de datos que realiza el seguimiento de la información sobre los bloques de inicialización.

Nota:

Actualmente, las tablas de seguimiento de uso de bloques de inicialización solo incluyen los bloques de inicialización de sesión y no incluyen los bloques de inicialización del modelo semántico.

Columnas relacionadas con el usuario, la sesión y el identificador

Columna Descripción
USER_NAME Nombre del usuario que ha ejecutado el bloque de inicialización. El tipo de datos es Varchar2(128).
TENANT_ID Nombre del inquilino del usuario que ha ejecutado el bloque de inicialización. El tipo de datos es Varchar2(128).
SERVICE_NAME Nombre del servicio. El tipo de datos es Varchar2(128).
ECID Identificador de contexto de ejecución generado por el sistema. El tipo de datos es Varchar2(1024).
SESSION_ID Identificador de la sesión. El tipo de datos es Number(10).

Columnas relacionadas con los detalles de la consulta

Columna Descripción
REPOSITORY_NAME Nombre del modelo semántico al que accede la consulta. El tipo de datos es Varchar2(128).
BLOCK_NAME Nombre del bloque de inicialización que se ha ejecutado. El tipo de datos es Varchar2(128).

Columnas relacionadas con la temporización de la ejecución

Columna Descripción
START_TS Fecha y hora cuando se inició el bloque de inicialización.
END_TS Fecha y hora cuando finalizó el bloque de inicialización. Los registros de hora de inicio y finalización también reflejan el tiempo que ha estado esperando la consulta para que estén disponibles los recursos.
DURATION Período de tiempo que ha tardado en ejecutarse el bloque de inicialización. El tipo de datos es Number(13,3).

Columnas relacionadas con los detalles de la ejecución

Columna Descripción
NOTES Notas sobre el bloque de inicialización y su ejecución. El tipo de datos es Varchar2(1024).