Sintaxis del archivo de configuración del log de consultas

El nombre de archivo de configuración del log de consultas debe tener el formato dbname.cfg, donde dbname representa el nombre de la base de datos (cubo). El archivo dbname.cfg debe estar ubicado en el directorio de cubo. Configure el archivo dbname.cfg con la siguiente sintaxis:

QUERYLOG [dimension_name]
QUERYLOG NONE GENERATION generation-range
QUERYLOG NONE LEVEL level-range
QUERYLOG GENERATION generation-range
QUERYLOG LEVEL level-range
QUERYLOG LOGPATH path-expression
QUERYLOG LOGFORMAT CLUSTER | TUPLE
QUERYLOG LOGFILESIZE n
QUERYLOG TOTALLOGFILESIZE n
QUERYLOG ON | OFF

Note:

El directorio de cubo significa <Application Directory>/app/appname/dbname. Si no sabe dónde está <Application Directory> en su entorno,

Consulte Ubicaciones de entorno en la plataforma de Essbase si utiliza un despliegue de Essbase independiente.
Si utiliza un despliegue de Essbase en Oracle Cloud Infrastructure Marketplace, <Application Directory> es /u01/data/essbase/app.

Tabla 4-1 Parámetros QUERYLOG

Parámetro QUERYLOG	Descripción
[dimension_name]	Identifica el nombre de dimensión del que se va a realizar un seguimiento. Los corchetes alrededor del nombre de dimensión son necesarios. QUERYLOG [dimension_name] registra todos los miembros de una dimensión. Por ejemplo, QUERYLOG [Product] realiza un seguimiento de todos los miembros de la dimensión Product. Cada dimensión se debe especificar en un valor QUERYLOG [dimension_name] independiente.
NONE GENERATION <genlevel_range_val> (consulte la Tabla 4-2)	Impide el seguimiento de los miembros del rango de generación especificado. Por ejemplo, QUERYLOG NONE GENERATION 2 excluye el seguimiento de todos los miembros de la generación 2 de la dimensión con nombre.
NONE LEVEL <genlevel_range_val> (consulte laTabla 4-2)	Impide el seguimiento de miembros del rango de niveles especificado. Por ejemplo, QUERYLOG NONE LEVEL 0-2 excluye el seguimiento de todos los miembros de los niveles 0, 1 y 2 de la dimensión con nombre.
GENERACIÓN <genlevel_range_val> (consulte laTabla 4-2)	Realiza el seguimiento de los miembros del rango de generación especificado por número de generación, en lugar de por nombre de miembro. Por ejemplo, QUERYLOG GENERATION 5-7 registra los miembros de las generaciones 5, 6 y 7 de la dimensión con nombre por su número de generación en el archivo log.
LEVEL <genlevel_range_val> (consulte laTabla 4-2)	Realiza el seguimiento de los miembros del rango de niveles especificado por número de nivel, en lugar de por nombre de miembro. Por ejemplo, QUERYLOG LEVEL -3 registra los miembros de los niveles 0, 1, 2 y 3 de la dimensión con nombre por su número de nivel en el archivo log.
RUTA DE LOG path-expression	Especifica la ubicación del archivo log de salida. El nombre del archivo log es `dbname00001.qlg`; por ejemplo, `basic00001.qlg`. Algunos ejemplos de la ruta de log son QUERYLOG LOGPATH `/usr/local/Essbaselogs/` y QUERYLOG LOGPATH `d:\Essbaselogs\querylogs\`. Debe incluir una barra invertida \ (para directorios Windows) o una barra inclinada / (para directorios UNIX) al final de la expresión de ruta; de lo contrario, el archivo log de consulta no se crea. Por defecto, la ubicación del archivo de salida de log es el directorio de cubo. Si falta el valor path-expression de LOGPATH, se utiliza el valor por defecto. Essbase escribe información de log en el archivo log de consulta después de que una aplicación deja de ejecutarse.
CLUSTER DE LOGFORMAT \| TUPLE	Especifica el formato de la salida del log. CLUSTER y TUPLE proporcionan la misma información de log, pero muestran la información de manera diferente. CLUSTER proporciona información sobre cuántos miembros de una dimensión se han consultado y enumera los miembros consultados dentro de sus respectivas dimensiones. TUPLE muestra cada combinación de miembros consultados. Por defecto, CLUSTER es el formato de log. Debido a que el formato TUPLE muestra cada combinación de miembros consultada, TUPLE puede tener un mayor impacto en el rendimiento de la consulta que CLUSTER. Consulte Salida de Cluster de Ejemplo para obtener un ejemplo de un log de consultas en formato de cluster. Consulte Sample Tuple Output para obtener un ejemplo de un log de consultas en formato de tupla.
TAMAÑO DE ARCHIVO LOG n	Especifica el tamaño máximo de un archivo log de consulta individual en megabytes (MB). El valor mínimo es 1 MB. El valor máximo es 2048 MB (2 GB). Si falta el valor LOGFILESIZE, el tamaño del archivo log de consulta es, por defecto, de 1 MB. Si el tamaño de un archivo log de consulta inicial supera la especificación, la información de log se agrega a un nuevo archivo log de consulta. Cada vez que se crea un nuevo archivo, el nombre del archivo se incrementa en uno.
TAMAÑO TOTAL DE ARCHIVOS LOG n	Especifica el tamaño máximo de todos los archivos log de consulta combinados en megabytes (MB). El valor mínimo es de 512 MB (1/2 GB). El valor máximo es 4095 MB. Si falta la configuración TOTALLOGFILESIZE, por defecto, el tamaño total del archivo log de consulta es de 1024 MB (1 GB). Los archivos log de consulta se crean hasta que el tamaño total del archivo supera el máximo especificado. Cuando se supera el máximo, se muestra un mensaje y el registro de consultas se desactiva automáticamente.
ON \| OFF	Especifica si la función de registro de consultas está activada o desactivada. Todos los valores del log de consultas se ignoran si este valor está desactivado o falta. De forma predeterminada, el valor está desactivado.

Los valores Generation-range y level-range (<genlevel_range_val>) se representan de una de las siguientes formas:

Tabla 4-2 Especificaciones de generación y rango de niveles

Valor de rango de generación o de nivel	Descripción
x	Número de generación o nivel específico. Por ejemplo, QUERYLOG NONE GENERATION 2 excluye la generación 2 del registro de consultas.
x-y	Todas las generaciones o niveles incluidos del número x al número y. Por ejemplo, QUERYLOG GENERATION 1-3 o QUERYLOG LEVEL 1-3 incluye los números de generación o nivel 1, 2 y 3.
-x	Para generation-range, todas las generaciones dentro del rango de 1 a x. Para level-range, todos los niveles del rango de 0 a x. Por ejemplo, QUERYLOG GENERATION -2 incluye las generaciones 1 y 2. QUERYLOG LEVEL -3 incluye los niveles 0, 1, 2 y 3.
x-	Para generation-range, todas las generaciones dentro del rango desde el número x hasta la generación más alta. Para level-range, todos los niveles dentro del rango desde el número x hasta el nivel más alto. Por ejemplo, QUERYLOG Nivel 1- incluye los niveles 1, 2, 3 y así sucesivamente hasta el nivel más alto.

Notas:

Cuando el registro de consultas está activado, las consultas al cubo pueden ser más lentas. El rendimiento depende del número de miembros de los que se realiza un seguimiento y del tamaño de la consulta.
Si el nombre del archivo de configuración no coincide con el nombre del cubo o se encuentra en un lugar que no sea el directorio del cubo, Essbase ignora el registro de consultas.
Si, en la configuración, falta QUERYLOG ON o si QUERYLOG OFF está definido, el registro de consultas está desactivado.
Si la configuración de generación y nivel provoca contradicciones en el archivo de configuración, se aplican las siguientes reglas de prioridad:
- números de generación (prioridad más alta)
- números de nivel
- nombres de miembros (prioridad más baja)
Por ejemplo, si un miembro pertenece tanto al nivel 1 como a la generación 2 y la configuración QUERYLOG GENERATION 2 y QUERYLOG NONE LEVEL 1 están en el archivo de configuración, la configuración de generación tiene prioridad y los miembros de la generación 2 se registran por número de generación.

Sugerencias

Para ver fácilmente la salida del log de consultas, cambie la extensión de archivo .qlg a .xml y utilice un explorador para ver el XML.
Si Essbase no está produciendo un archivo .qlg del log de consultas como se esperaba, consulte el archivo dbname.log en el directorio del cubo para buscar mensajes del log de consultas.