Sintaxe do arquivo de configurações de log de consulta

Para configurar o registro em log de consultas para um cubo do Essbase, configure o arquivo de configurações de registro em log de consultas usando parâmetros QUERYLOG para especificar quais dimensões e membros você deseja rastrear e como deseja que as informações sejam registradas.

O nome do arquivo de definições do log de consulta deve ser no formato dbname.cfg, em que dbname representa o nome do banco de dados (cubo). O arquivo dbname.cfg deve estar localizado no diretório de cubo. Configure o arquivo dbname.cfg usando a seguinte sintaxe: 

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

Observação:

O diretório de cubo significa <Application Directory>/app/appname/dbname. Se você não souber onde <Application Directory> está em seu ambiente,

  • Consulte Locais de Ambiente na Plataforma Essbase se você usar uma implantação independente do Essbase.

  • Se você usar uma implantação do Essbase no Oracle Cloud Infrastructure Marketplace, o <Application Directory> será /u01/data/essbase/app.

Tabela 4-1 Parâmetros QUERYLOG

Parâmetro QUERYLOG Descrição
[dimension_name] Identifica o nome da dimensão a ser rastreada. Os colchetes ao redor do nome da dimensão são obrigatórios. QUERYLOG [dimension_name] registra todos os membros de uma dimensão. Por exemplo, QUERYLOG [Produto] rastreia todos os membros da dimensão Produto. Cada dimensão deve ser especificada em uma definição QUERYLOG [dimension_name] separada.
NONE GENERATION <genlevel_range_val> (consulte a Tabela 4-2) Impede o rastreamento de membros do intervalo de geração especificado. Por exemplo, QUERYLOG NONE GENERATION 2 exclui o rastreamento de todos os membros da geração 2 da dimensão nomeada.
NENHUM NÍVEL <genlevel_range_val> (consulte aTabela 4-2) Impede o rastreamento de membros do intervalo de níveis especificado. Por exemplo, QUERYLOG NONE LEVEL 0-2 exclui o rastreamento de todos os membros dos níveis 0, 1 e 2 da dimensão nomeada.
GERATION <genlevel_range_val> (consulte aTabela 4-2) Rastreia membros da faixa de geração especificada por número de geração, em vez de por nome de membro. Por exemplo, QUERYLOG GENERATION 5-7 registra os membros das gerações 5, 6 e 7 da dimensão nomeada por seu número de geração no arquivo de log.
NÍVEL <genlevel_range_val> (consulte a Tabela 4-2) Rastreia membros do intervalo de níveis especificado por número de nível, em vez de por nome de membro. Por exemplo, QUERYLOG LEVEL -3 registra os membros dos níveis 0, 1, 2 e 3 da dimensão nomeada pelo número do nível no arquivo de log.
CAMINHO DO LOG path-expression Especifica a localização do arquivo de log de saída. O nome do arquivo de log é dbname00001.qlg; por exemplo, basic00001.qlg. Exemplos do caminho de log são QUERYLOG LOGPATH /usr/local/Essbaselogs/ e QUERYLOG LOGPATH d:\Essbaselogs\querylogs\. É necessário incluir uma barra invertida \ (para diretórios do Windows) ou barra / (para diretórios UNIX) no final da expressão de caminho; caso contrário, o arquivo de log de consulta não será criado.

Por padrão, o local do arquivo de saída de log é o diretório de cubo. Se a definição LOGPATH path-expression estiver ausente, o default será usado. O Essbase grava informações de log no arquivo de log de consulta após a execução de um aplicativo.

CLUSTER DE LOGFORMAT | TUPLA Especifica o formato da saída do log. CLUSTER e TUPLE fornecem as mesmas informações de log, mas exibem as informações de maneira diferente. CLUSTER fornece informações sobre quantos membros de uma dimensão foram consultados e lista os membros consultados em suas respectivas dimensões. TUPLE lista cada combinação de membros consultados. Por padrão, CLUSTER é o formato de log. Como o formato TUPLE lista cada combinação de membros consultada, TUPLE pode ter um impacto maior no desempenho da consulta do que CLUSTER. Consulte Saída de Cluster de Amostra para obter um exemplo de log de consulta no formato de cluster. Consulte Saída de Tupla de Amostra para obter um exemplo de log de consulta no formato de tupla.
LOGFILESIZE n Especifica o tamanho máximo de um arquivo de log de consulta individual em megabytes (MB). O valor mínimo é 1 MB. O valor máximo é 2048 MB (2 GB). Se a configuração LOGFILESIZE estiver ausente, o tamanho do arquivo de log de consulta, por padrão, será de 1 MB. Se o tamanho de um arquivo de log de consulta inicial exceder a especificação, as informações de log serão adicionadas a um novo arquivo de log de consulta. Cada vez que um novo arquivo é criado, o nome do arquivo é incrementado em um.
TOTALLOGFILESIZE n Especifica o tamanho máximo de todos os arquivos de log de consulta combinados em megabytes (MB). O valor mínimo é 512 MB (1/2 GB). O valor máximo é 4095 MB. Se a definição TOTALLOGFILESIZE estiver ausente, então, por padrão, o tamanho total do arquivo de log de consulta será de 1024 MB (1 GB). Os arquivos de log de consulta são criados até que o tamanho total do arquivo exceda o máximo especificado. Quando o máximo é excedido, uma mensagem é exibida e o registro de consulta é desativado automaticamente.
ON | OFF Especifica se o recurso de registro de consulta está ativado ou desativado. Todas as configurações de log de consulta serão ignoradas se esta configuração estiver DESATIVADA ou ausente. Por padrão, a configuração é DESATIVADA.

Os valores Generation-range e level-range (<genlevel_range_val>) são representados de uma das seguintes maneiras:

Tabela 4-2 Especificações de Geração e Faixa de Níveis

Intervalo de Geração ou Valor do Intervalo de Níveis Descrição
x Um número de nível ou geração específico. Por exemplo, QUERYLOG NONE GENERATION 2 exclui a geração 2 do log de consultas.
x-y Todas as gerações ou níveis, incluindo número x até número y. Por exemplo, QUERYLOG GENERATION 1-3 ou QUERYLOG LEVEL 1-3 inclui a geração ou os números de nível 1, 2 e 3.
-x Para generation-range, todas as gerações dentro da faixa de 1 a x. Para level-range, todos os níveis na faixa de 0 a x. Por exemplo, QUERYLOG GENERATION -2 inclui as gerações 1 e 2. QUERYLOG LEVEL -3 inclui os níveis 0, 1, 2 e 3.
x- Para generation-range, todas as gerações dentro da faixa de número x até a geração mais alta. Para level-range, todos os níveis dentro do intervalo do número x até o nível mais alto. Por exemplo, QUERYLOG Nível 1- inclui os níveis 1, 2, 3 e assim por diante até o nível mais alto.

Notas

  • Quando o log de consultas está ativado, as consultas ao cubo podem ser mais lentas. O desempenho depende de quantos membros estão sendo rastreados e do tamanho da consulta.

  • Se o nome do arquivo de definições não corresponder ao nome do cubo ou estiver localizado em um local diferente do diretório do cubo, o Essbase ignorará o registro em log da consulta.

  • Se, nas configurações, QUERYLOG ON estiver ausente ou se QUERYLOG OFF estiver definido, o log de consultas será desativado.

  • Se as configurações de geração e nível causarem contradições no arquivo de configurações, as seguintes regras de precedência serão aplicadas:

    • números de geração (prioridade mais alta)

    • números de nível

    • nomes de membros (prioridade mais baixa)

    Por exemplo, se um membro pertencer ao nível 1 e à geração 2 e as configurações QUERYLOG GENERATION 2 e QUERYLOG NONE LEVEL 1 estiverem no arquivo de configurações, a configuração de geração terá precedência e os membros da geração 2 serão registrados por número de geração.

Sugestões

  • Para exibir facilmente a saída do log de consulta, altere a extensão de arquivo .qlg para .xml e use um browser para exibir o XML.

  • Se o Essbase não estiver produzindo um arquivo .qlg de log de consulta conforme esperado, exiba o arquivo dbname.log no diretório de cubo para procurar mensagens de log de consulta.