Noções Básicas de Tabelas de Rastreamento de Uso

O sistema armazena dados de rastreamento de uso em três tabelas de banco de dados.

O processo de rastreamento de uso cria essas tabelas com nomes que você especifica por meio de definições na página Definições do Sistema.

Tabela de Logs de Consulta Lógica de Rastreamento de Uso
Tabela de Logs de Consulta Física de Rastreamento de Uso
Tabela de Blocos de Inicialização do Rastreamento de Uso

Consulte Definir Parâmetros de Rastreamento de Uso.

Tabela de Logs de Consulta Lógica de Rastreamento de Uso

A tabela a seguir descreve cada coluna na tabela de banco de dados que rastreia consultas lógicas. Quando apropriado, o tipo de dados, como o campo de caractere de variável (varchar e varchar2) e o tamanho, é especificado. Enquanto confere as descrições nessa tabela, você poderá assumir que determinadas colunas relacionadas ao tempo podem ser adicionadas ou subtraídas a/de valores exatos iguais. Por exemplo, você pode assumir que TOTAL_TIME_SEC é igual a END_TS menos START_TS. As colunas não fornecem esses valores exatos porque:

Vários processos são executados em paralelo e a velocidade deles depende da carga e do desempenho do banco de dados. As operações baseadas no servidor podem ser leves ou intensas.
Se todas as conexões estiverem completas, a consulta será feita e aguardará o processamento. O tempo depende da carga e da configuração.

Colunas relacionadas a Usuário, Sessão e ID

Coluna	Descrição
`ID`	Na tabela de Consulta Lógica, essa coluna indica o identificador de linha exclusivo. Na tabela de Consulta Física, essa coluna é indicada pelo nome `LOGICAL_QUERY_ID`.
`NODE_ID`	Contém `<hostname>:obis1`. Por exemplo, `examplehost:obis1` (para uma instância única).
`PRESENTATION_NAME`	Indica o nome do Catálogo. O padrão é Nulo e o tipo de dados é Varchar(128).
`IMPERSONATOR_USER_NAME`	Especifica o nome do usuário personificado. Se a solicitação não for executada como usuário personificado, o valor será Nenhum. O padrão é Nenhum e o tipo de dados é Varchar(128).
`USER_NAME`	Especifica o nome do usuário que submeteu a consulta.
`ECID`	Indica o ID do contexto de execução gerado pelo sistema. O tipo de dados é Varchar2(1024).
`TENANT_ID`	Especifica o nome do tenant do usuário que executou o bloco de inicialização. O tipo de dados é Varchar2(128).
`SERVICE_NAME`	Especifica o nome do serviço. O tipo de dados é Varchar2(128).
`SESSION_ID`	Indica o ID da sessão. O tipo de dados é Number(10).
`HASH_ID`	Indica o valor `HASH` para a consulta lógica. O tipo de dados é Varchar2(128).

Colunas Relacionadas à Origem da Consulta

Coluna	Descrição
`QUERY_SRC_CD`	A origem da solicitação. Observe que o solicitante pode definir QUERY_SRC_CD como qualquer valor de string para identificar-se. Os valores possíveis incluem: Relatório - se a origem for uma análise ou qualquer operação de exportação. Drill - Se a origem for uma alteração na dimensão causada ao fazer drill-up ou drill-down. ValuePrompt - se a origem for a lista drop-down Valor em uma caixa de diálogo de filtro ou um prompt de painel de controle. VisualAnalyzer - Se a origem for uma pasta de trabalho para visualizar dados. DisplayValueMap, MemberBrowserDisplayValues ou MemberBrowserPath - Se a origem for um valor relacionado à exibição de uma análise. SOAP - Se a origem for uma chamada de web services, como DataSetSvc. Pré-implantado - se a origem for um agente que pré-implanta o cache do servidor de análise. Nulo - se a origem for a tabela física Ferramenta de Administração, contagem de linhas e colunas ou dados de exibição.
`SAW_DASHBOARD`	Indica o nome do caminho do painel de controle. Se a consulta não foi submetida por meio de um painel de controle, o valor será NULO.
`SAW_DASHBOARD_PG`	Indica o nome da página no painel de controle. Se a solicitação não for de um painel de controle, o valor será NULO. O padrão é Nulo e o tipo de dados é Varchar(150).
`SAW_SRC_PATH`	Especifica o nome do caminho no Catálogo para a análise.

Colunas Relacionadas a Detalhes da Consulta

Coluna	Descrição
`ERROR_TEXT`	Contém a mensagem de erro do banco de dados de back-end. Essa coluna só será aplicável se `SUCCESS_FLAG` estiver definido com um valor diferente de 0 (zero). Diversas mensagens são concatenadas e o sistema não faz parsing delas. O padrão é Nulo e o tipo de dados é Varchar(250).
`QUERY_BLOB`	Contém a instrução SQL lógica inteira sem qualquer truncamento. A coluna `QUERY_BLOB` é uma string de caractere do tipo Long.
`QUERY_KEY`	Contém uma chave de hash MD5 gerada pelo sistema com base na instrução SQL lógica. O padrão é Nulo e o tipo de dados é Varchar(128).
`QUERY_TEXT`	Indica a instrução SQL que foi submetida para a consulta. O tipo de dados é Varchar(1024). Você pode alterar a tamanho dessa coluna (usando o comando ALTER TABLE), mas observe que o texto escrito nela é sempre truncado para o tamanho definido na camada física. O administrador de modelo semântico não deve definir o tamanho dessa coluna com um valor maior que o tamanho máximo da consulta que é suportado pelo banco de dados físico de back-end. Por exemplo, os Bancos de Dados Oracle permitem um Varchar máximo igual a 4000, mas eles truncam para 4000 bytes, não 4000 caracteres. Se você usar um conjunto de caracteres multibyte, o tamanho máximo real da string tem um número variável de caracteres, dependendo do conjunto de caracteres e dos caracteres usados.
`REPOSITORY_NAME`	Especifica o nome do modelo semântico que a consulta acessa.
`SUBJECT_AREA_NAME`	Contém o nome do modelo de negócios que está sendo acessado.
`SUCCESS_FLG`	Indica o status de conclusão da consulta, conforme definido na lista a seguir: 0 - A consulta foi concluída com sucesso sem erros. 1 - A consulta esgotou o tempo limite. 2 - A consulta falhou porque os limites de linha foram excedidos. 3 - A consulta falhou por algum outro motivo.

Colunas Relacionadas ao Tempo de Execução

Coluna	Descrição
`COMPILE_TIME_SEC`	Contém o tempo em segundos exigido para compilar a consulta. O número para `COMPILE_TIME_SEC` é incluído em `TOTAL_TIME_SEC`.
`END_DT`	Indica a data em que a consulta lógica é concluída.
`END_HOUR_MIN`	Indica hora e minuto em que a consulta lógica é concluída.
`END_TS`	Indica data e horário em que a consulta lógica é concluída. Os timestamps de início e fim também refletem qualquer tempo que a consulta ficou aguardando a disponibilidade de recursos. Se o usuário que está submetendo a consulta navegar para fora da página antes da finalização da consulta, a extração final nunca acontecerá e um timeout de 3600 será registrado. No entanto, se o usuário navegar de volta para a página antes do timeout, a extração será concluída nesse momento, sendo registrada como o tempo `end_ts`.
`START_DT`	Indica a data em que a consulta lógica foi submetida.
`START_HOUR_MIN`	Indica hora e minuto em que a consulta lógica foi submetida.
`START_TS`	Indica data e horário em que a consulta lógica foi submetida.
`TOTAL_TIME_SEC`	Indica o tempo em segundos que o sistema gastou trabalhando na consulta enquanto o cliente aguardava as respostas a suas análises. `TOTAL_TIME_SEC` inclui o tempo para `COMPILE_TIME_SEC`.
`RESP_TIME_SEC`	Indica o tempo necessário para a resposta da consulta. O tipo de dados é Number(10).

Colunas Relacionadas a Detalhes da Execução

Coluna	Descrição
`CUM_DB_TIME_SEC`	Contém o tempo cumulativo de todas as consultas enviadas ao banco de dados. As consultas são executadas em paralelo; por isso, o tempo cumulativo é igual ou superior ao tempo total conectado ao banco de dados. Por exemplo, suponha que uma solicitação lógica gere 4 instruções SQL físicas enviadas ao banco de dados e que o tempo de 3 das consultas seja 10 segundos e uma consulta de 15 segundos, `CUM_DB_TIME_SEC` exibirá 45 segundos porque as consultas são executadas em paralelo.
`CUM_NUM_DB_ROW`	Contém o número total de linhas retornadas pelos bancos de dados de back-end.
`NUM_DB_QUERY`	Indica o número de consultas que foram submetidas aos bancos de dados de back-end para satisfazer a solicitação de consulta lógica. Para consultas bem-sucedidas (SuccessFlag = 0), esse número é 1 ou superior.
`ROW_COUNT`	Indica o número de linhas retornadas ao cliente da consulta. Quando uma quantidade grande de dados for retornada de uma consulta, essa coluna não será preenchida até que o usuário exiba todos os dados.
`TOTAL_TEMP_KB`	Especifica o total em KB recebidos para uma consulta. O tipo de dados é Number(10).

Colunas Relacionadas ao Cache

Coluna	Descrição
`CACHE_IND_FLG`	Mantém Y para indicar uma ocorrência no cache da consulta; N para indicar uma ausência no cache. O padrão é N.
`NUM_CACHE_HITS`	Indica o número de vezes que o resultado do cache retornou para a consulta. `NUM_CACHE_HITS` é um número inteiro de 32 bits (ou de 10 dígitos). O padrão é Nulo.
`NUM_CACHE_INSERTED`	Indica o número de vezes que a consulta gerou uma entrada no cache. O padrão é Nulo. `NUM_CACHE_INSERTED` é um número inteiro de 32 bits (ou de 10 dígitos).

Tabela de Logs de Consulta Física de Rastreamento de Uso

A tabela a seguir descreve a tabela de banco de dados que rastreia as consultas físicas. Essa tabela de banco de dados registra as informações SQL físicas das consultas lógicas armazenadas na tabela de logs de consulta lógica. A tabela de consulta física tem um relacionamento de chave estrangeira com a tabela de consulta lógica.

Colunas relacionadas a Usuário, Sessão e ID

Coluna	Descrição
`ID`	Especifica o identificador de linha exclusivo.
`LOGICAL_QUERY_ID`	Refere-se à consulta lógica na tabela de logs da consulta lógica. O tipo de dados é Varchar(250).
`HASH_ID`	Indica o valor `HASH` para a consulta lógica. O tipo de dados é Varchar2(128).
`PHYSICAL_HASH_ID`	Indica o valor `HASH` para a consulta física. O tipo de dados é Varchar2(128).

Colunas Relacionadas a Detalhes da Consulta

Coluna	Descrição
`QUERY_BLOB`	Contém a instrução SQL física inteira sem qualquer truncamento. A coluna `QUERY_BLOB` é uma string de caractere do tipo 'long'.
`QUERY_TEXT`	Contém a instrução SQL que foi submetida para a consulta. O tipo de dados é Varchar(1024).

Colunas Relacionadas ao Tempo de Execução

Coluna	Descrição
`END_DT`	Indica a data em que a consulta física é concluída.
`END_HOUR_MIN`	Indica hora e minuto em que a consulta física é concluída.
`END_TS`	Indica data e horário em que a consulta física é concluída. Os timestamps de início e fim também refletem qualquer tempo que a consulta ficou aguardando a disponibilidade de recursos.
`TIME_SEC`	Indica o tempo de execução da consulta física.
`START_DT`	Indica a data em que a consulta física foi submetida.
`START_HOUR_MIN`	Indica hora e minuto em que a consulta física foi submetida.
`START_TS`	Indica data e horário em que a consulta física foi submetida.

Colunas Relacionadas a Detalhes da Execução

Coluna	Descrição
`ROW_COUNT`	Contém o número de linhas retornadas ao cliente da consulta.

Tabela de Blocos de Inicialização do Rastreamento de Uso

A tabela a seguir descreve a tabela de banco de dados que rastreia informações sobre os blocos de inicialização.

Nota:

No momento, as tabelas de rastreamento de uso do bloco de inicialização incluem apenas blocos de inicialização de sessão e não incluem os de modelo semântico.

Colunas relacionadas a Usuário, Sessão e ID

Coluna	Descrição
`USER_NAME`	O nome do usuário que executou o bloco de inicialização. O tipo de dados é Varchar2(128).
`TENANT_ID`	O nome do tenant do usuário que executou o bloco de inicialização. O tipo de dados é Varchar2(128).
`SERVICE_NAME`	O nome do serviço. O tipo de dados é Varchar2(128).
`ECID`	O ID do contexto de execução gerado pelo sistema. O tipo de dados é Varchar2(1024).
`SESSION_ID`	O ID da sessão. O tipo de dados é Number(10).

Colunas Relacionadas a Detalhes da Consulta

Coluna	Descrição
`REPOSITORY_NAME`	O nome do modelo semântico que a consulta acessa. O tipo de dados é Varchar2(128).
`BLOCK_NAME`	O nome do bloco de inicialização que foi executado. O tipo de dados é Varchar2(128).

Colunas Relacionadas ao Tempo de Execução

Coluna	Descrição
`START_TS`	A data e o horário em que o bloco de inicialização foi iniciado.
`END_TS`	A data e o horário em que o bloco de inicialização foi finalizado. Os timestamps de início e fim também refletem o tempo durante o qual a consulta ficou aguardando a disponibilidade de recursos.
`DURATION`	O tempo necessário para executar o bloco de inicialização. O tipo de dados é Number(13,3).

Colunas Relacionadas a Detalhes da Execução

Coluna	Descrição
`NOTES`	Observações sobre o bloco de inicialização e sua execução. O tipo de dados é Varchar2(1024).