Noções sobre as Tabelas de Controlo da Utilização

O sistema armazena dados de controlo da utilização em três tabelas da base de dados.

O processo de controlo da utilização cria estas tabelas com os nomes que especificar através das definições na página Definições do Sistema.

Tabela de Registo no Diário de Consultas Lógicas do Controlo da Utilização
Tabela de Registo no Diário de Consultas Físicas do Controlo da Utilização
Tabela de Blocos de Inicialização de Controlo de Utilização

Consulte Definir Parâmetros de Controlo da Utilização.

Tabela de Registo no Diário de Consultas Lógicas do Controlo da Utilização

A tabela seguinte descreve cada coluna da tabela da base de dados que controla as consultas lógicas. Quando adequado, é especificado o tipo de dados, tal como campo de carácter variável (varchar e varchar2), e o comprimento. Ao analisar as descrições nesta tabela, poderá supor que a adição ou subtração de colunas relacionadas com tempo é possível para valores exatos iguais. Por exemplo, poderá supor que TOTAL_TIME_SEC é igual a END_TS menos START_TS. As colunas não fornecem este tipo de valores exatos porque:

Vários processos são executados em paralelo e a respetiva velocidade depende da carga e do desempenho da base de dados. As operações baseadas no servidor podem ser ligeiras ou intensivas.
Se todas as ligações estiverem cheias, a consulta é introduzida numa fila de espera e aguarda pelo processamento. O tempo depende da carga e da configuração.

Colunas relacionadas com Utilizador, Sessão e ID

Coluna	Descrição
`ID`	Na tabela Consulta Lógica, esta coluna indica o único identificador de linha. Na tabela Consulta Física, esta coluna é marcada com o 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 valor por omissão é Null e o tipo de dados é Varchar(128).
`IMPERSONATOR_USER_NAME`	Especifica o nome do utilizador cujas credenciais foram adotadas. Se o pedido não for executado como um utilizador cujas credenciais foram adotadas, o valor é Nenhum. O valor por omissão é Nenhum e o tipo de dados é Varchar(128).
`USER_NAME`	Especifica o nome do utilizador que submeteu a consulta.
`ECID`	Indica a ID do contexto de execução gerada pelo sistema. O tipo de dados é Varchar2(1024).
`TENANT_ID`	Especifica o nome do tenant do utilizador 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 a 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 com Origem da Consulta

Coluna	Descrição
`QUERY_SRC_CD`	A origem do pedido. Note que o requisitante pode definir QUERY_SRC_CD como qualquer valor de cadeia de caracteres para se identificar a si próprio. Os valores possíveis incluem: Report - 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 pela definição do nível de detalhe superior ou inferior. ValuePrompt - Se a origem for a lista pendente Valor numa caixa de diálogo de filtro ou um prompt do dashboard. VisualAnalyzer - Se a origem for um livro para visualizar dados. DisplayValueMap ou MemberBrowserDisplayValues ou MemberBrowserPath - Se a origem for um valor relacionado com a apresentação de uma análise. SOAP - Se a origem for uma chamada de serviços para a Web como o DataSetSvc. Seed - Se a origem for um agente que cria a cache do Analytics Server. Null - Se a origem for a tabela física ou a contagem de linhas de coluna da Ferramenta de Administração ou os dados da visualização.
`SAW_DASHBOARD`	Indica o nome do percurso do dashboard. Se a consulta não tiver sido submetida através de um dashboard, o valor é NULL.
`SAW_DASHBOARD_PG`	Indica o nome da página no dashboard. Caso não se trate de um pedido do dashboard, o valor é NULL. O valor por omissão é Null e o tipo de dados é Varchar(150).
`SAW_SRC_PATH`	Especifica o nome do percurso no Catálogo para a análise.

Colunas relacionadas com Detalhes da Consulta

Coluna	Descrição
`ERROR_TEXT`	Contém a mensagem de erro da base de dados auxiliar. Esta coluna só é aplicável se `SUCCESS_FLAG` estiver definido como um valor diferente de 0 (zero). No caso de várias mensagens, são concatenadas e não são analisadas pelo sistema. O valor por omissão é Null e o tipo de dados é Varchar(250).
`QUERY_BLOB`	Contém a instrução de SQL lógico completa sem qualquer truncamento. A coluna `QUERY_BLOB` é uma cadeia de caracteres do tipo Long.
`QUERY_KEY`	Contém uma chave hash MD5 gerada pelo sistema a partir da instrução de SQL lógico. O valor por omissão é Null e o tipo de dados é Varchar(128).
`QUERY_TEXT`	Indica a instrução de SQL que foi submetida para a consulta. O tipo de dados é Varchar(1024). Pode alterar o comprimento desta coluna (utilizando o comando ALTER TABLE), mas tenha em atenção que o texto escrito nesta coluna é sempre truncado para o tamanho definido na camada física. O administrador do modelo semântico não deve definir o comprimento desta coluna como um valor superior ao comprimento máximo da consulta suportado pela base de dados física backend. Por exemplo, as Bases de Dados Oracle permitem um Varchar máximo de 4000, mas truncam para 4000 bytes, não 4000 caracteres. Se utilizar um conjunto de caracteres multibyte, o tamanho máximo real da cadeia de caracteres tem um número variável de caracteres, consoante o conjunto de caracteres e os caracteres utilizados.
`REPOSITORY_NAME`	Especifica o nome do modelo semântico acedido pela consulta.
`SUBJECT_AREA_NAME`	Contém o nome do modelo de negócio que está a ser acedido.
`SUCCESS_FLG`	Indica o estado de conclusão da consulta, conforme definido na lista seguinte: 0 - A consulta foi concluída com êxito e sem erros. 1 - O limite de tempo da consulta foi esgotado. 2 - A consulta falhou porque os limites de linhas foram excedidos. 3 - A consulta falhou por outro motivo.

Colunas relacionadas com Temporização da Execução

Coluna	Descrição
`COMPILE_TIME_SEC`	Contém o tempo em segundos necessário para compilar a consulta. O número de `COMPILE_TIME_SEC` está incluído em `TOTAL_TIME_SEC`.
`END_DT`	Indica a data em que a consulta lógica foi concluída.
`END_HOUR_MIN`	Indica a hora e minuto em que a consulta lógica foi concluída.
`END_TS`	Indica a data e hora em que a consulta lógica foi concluída. As indicações de data/hora de início e de fim também refletem o tempo despendido pela consulta a aguardar pela disponibilização dos recursos. Se o utilizador que submete a consulta navegar para fora da página antes de a consulta terminar, a extração final nunca ocorre e é registado um valor de limite de tempo de 3600. No entanto, se o utilizador regressar à página antes do limite de tempo, a extração é concluída nessa altura, sendo registado como a data/hora de `end_ts`.
`START_DT`	Indica a data em que a consulta lógica foi submetida.
`START_HOUR_MIN`	Indica a hora e minuto em que a consulta lógica foi submetida.
`START_TS`	Indica a data e hora em que a consulta lógica foi submetida.
`TOTAL_TIME_SEC`	Indica o tempo em segundos despendido pelo sistema a trabalhar na consulta, enquanto o cliente esteve a aguardar por respostas às respetivas análises. `TOTAL_TIME_SEC` inclui o tempo de `COMPILE_TIME_SEC`.
`RESP_TIME_SEC`	Indica o tempo de resposta à consulta. O tipo de dados é Number(10).

Colunas relacionadas com Detalhes da Execução

Coluna	Descrição
`CUM_DB_TIME_SEC`	Contém o tempo acumulado de todas as consultas enviadas para a base de dados. As consultas são executadas em paralelo, por isso o tempo de consulta acumulado é igual a ou superior ao tempo total de ligação à base de dados. Por exemplo, suponha que um pedido lógico gera 4 instruções de SQL físico enviadas para a base de dados e que o tempo de consulta para 3 das consultas é 10 segundos e para uma consulta é 15 segundos; `CUM_DB_TIME_SEC` apresenta 45 segundos porque as consultas são executadas em paralelo.
`CUM_NUM_DB_ROW`	Contém o número total de linhas devolvidas pelas bases de dados auxiliares.
`NUM_DB_QUERY`	Indica o número de consultas que foram submetidas nas bases de dados auxiliares para satisfazer o pedido da consulta lógica. Para consultas com êxito (SuccessFlag = 0), este número é 1 ou superior.
`ROW_COUNT`	Indica o número de linhas devolvidas ao cliente da consulta. Quando é devolvida uma grande quantidade de dados de uma consulta, esta coluna só é preenchida quando o utilizador apresentar todos os dados.
`TOTAL_TEMP_KB`	Especifica o total de KB recebidos para uma consulta. O tipo de dados é Number(10).

Colunas relacionadas com Cache

Coluna	Descrição
`CACHE_IND_FLG`	Contém Y para indicar um sucesso da cache para a consulta; N para indicar uma falha da cache. O valor por omissão é N.
`NUM_CACHE_HITS`	Indica o número de vezes que o resultado da cache foi devolvido para a consulta. `NUM_CACHE_HITS` é um número inteiro de 32 bits (ou um número inteiro de 10 dígitos). O valor por omissão é Null.
`NUM_CACHE_INSERTED`	Indica o número de vezes que a consulta gerou uma entrada da cache. O valor por omissão é Null. `NUM_CACHE_INSERTED` é um número inteiro de 32 bits (ou um número inteiro de 10 dígitos).

Tabela de Registo no Diário de Consultas Físicas do Controlo da Utilização

A tabela seguinte descreve a tabela da base de dados que controla as consultas físicas. Esta tabela da base de dados regista as informações do SQL físico para as consultas lógicas armazenadas na tabela de registo no diário de consultas lógicas. A tabela de consultas físicas tem uma relação de chave externa com a tabela de consultas lógicas.

Colunas relacionadas com Utilizador, Sessão e ID

Coluna	Descrição
`ID`	Especifica o identificador exclusivo da linha.
`LOGICAL_QUERY_ID`	Faz referência à consulta lógica na tabela de registo no diário de consultas lógicas. O tipo de dados é Varchar2(50).
`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 com Detalhes da Consulta

Coluna	Descrição
`QUERY_BLOB`	Contém a instrução de SQL físico completa sem qualquer truncamento. A coluna `QUERY_BLOB` é uma cadeia de caracteres do tipo long.
`QUERY_TEXT`	Contém a instrução de SQL submetida para a consulta. O tipo de dados é Varchar(1024).

Colunas relacionadas com Temporização da Execução

Coluna	Descrição
`END_DT`	Indica a data em que a consulta física foi concluída.
`END_HOUR_MIN`	Indica a hora e minuto em que a consulta física foi concluída.
`END_TS`	Indica a data e hora em que a consulta física foi concluída. As indicações de data/hora de início e de fim também refletem o tempo despendido pela consulta a aguardar pela disponibilização dos 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 a hora e minuto em que a consulta física foi submetida.
`START_TS`	Indica a data e hora em que a consulta física foi submetida.

Colunas relacionadas com Detalhes da Execução

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

Tabela de Blocos de Inicialização de Controlo de Utilização

A tabela seguinte descreve a tabela da base de dados que controla as informações sobre os blocos de inicialização.

Nota:

Atualmente, as tabelas de controlo da utilização de blocos de inicialização incluem apenas blocos de inicialização de sessões e não incluem os blocos de inicialização de modelos semânticos.

Colunas relacionadas com Utilizador, Sessão e ID

Coluna	Descrição
`USER_NAME`	O nome do utilizador que executou o bloco de inicialização. O tipo de dados é Varchar2(128).
`TENANT_ID`	O nome do tenant do utilizador 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`	A ID do contexto de execução gerada pelo sistema. O tipo de dados é Varchar2(1024).
`SESSION_ID`	A ID da sessão. O tipo de dados é Number(10).

Colunas relacionadas com Detalhes da Consulta

Coluna	Descrição
`REPOSITORY_NAME`	O nome do modelo semântico acedido pela consulta. 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 com Temporização da Execução

Coluna	Descrição
`START_TS`	A data e hora em que o bloco de inicialização foi iniciado.
`END_TS`	A data e hora em que o bloco de inicialização foi terminado. As indicações de data/hora de início e de fim também refletem o tempo despendido pela consulta a aguardar pela disponibilização dos recursos.
`DURATION`	O tempo que demorou a executar o bloco de inicialização. O tipo de dados é Number(13,3).

Colunas relacionadas com Detalhes da Execução

Coluna	Descrição
`NOTES`	Notas sobre o bloco de inicialização e a respetiva execução. O tipo de dados é Varchar2(1024).