Rastrear Uso

O rastreamento de uso permite que os administradores rastreiem as consultas de nível de usuário ao conteúdo.

O rastreamento de uso é uma maneira útil de determinar quais consultas do usuário estão criando gargalos de desempenho, com base na frequência e no tempo de resposta da consulta. Os administradores configuram os critérios para rastrear as consultas do usuário e geram relatórios de uso que podem ser utilizados de várias maneiras, como otimização do banco de dados, estratégias de agregação ou cobrança a usuários ou departamentos com base nos recursos consumidos.

Tópicos:

Sobre Rastreamento de Uso

Você pode configurar o rastreamento de uso em serviços que ofereçam funcionalidades de modelagem empresarial. As informações de uso são rastreadas no nível de consulta detalhada do usuário para que você responda perguntas como:

Como os usuários estão interagindo com o Oracle Analytics Cloud?
Onde eles estão perdendo ou não tempo?
Quanto tempo os usuários gastam em cada sessão, entre as sessões e entre as consultas?
Como são as consultas dentro das sessões, entre as sessões e entre os usuários relacionados uns com os outros?
Os usuários estão fazendo drill-up e drill-down nas análises?
Quais consultas estão sendo executadas quando os problemas são reportados?

As estatísticas de uso que você reúne podem ajudar a monitorar o uso e o desempenho do sistema para você poder entender melhor e prever o comportamento do usuário. Você pode aumentar a eficiência e reduzir erros se souber antecipadamente como seu sistema provavelmente será utilizado.

Quando você ativa o rastreamento de uso, o sistema coleta registros de dados de cada consulta executada e os grava nas tabelas de banco de dados. As consultas lógicas e físicas são rastreadas e registradas em tabelas distintas, com várias medidas de desempenho, como o tempo gasto para executar a consulta e o número de linhas pesquisadas durante o processamento da consulta de um usuário.

Pré-requisitos de Rastreamento de Uso

Para rastrear usos, verifique se você atende aos seguintes pré-requisitos:

Você usa atualmente o Semantic Modeler ou a Model Administration Tool para gerenciar seu modelo semântico.
Para configurar o rastreamento de uso, adicione os detalhes do banco de dados de rastreamento de uso ao seu modelo semântico usando o Semantic Modeler ou a Model Administration Tool.
Você tem as permissões de acesso apropriadas no banco de dados em que deseja armazenar informações de uso.
Você deve ter as credenciais de um usuário que tem permissões para criar as tabelas de rastreamento de uso no esquema de banco de dados e gravar os dados de uso nas tabelas.
O banco de dados suporta rastreamento de uso: Oracle Database ou Oracle Autonomous Data Warehouse
Você criou uma conexão de dados com seu banco de dados de rastreamento de uso com as definições a seguir. Consulte Estabelecer Conexão com Dados.
- Conexão do Sistema - Marque a caixa de seleção Conexão do Sistema.
  Quando você marcar a caixa de seleção Conexão do Sistema, a conexão ficará disponível no Semantic Modeler. De modo semelhante, na Model Administration Tool, a opção Conexão do Sistema permite que você selecione Usar Conexão de Dados e informe o ID do Objeto da conexão em vez de inserir manualmente os detalhes da conexão no campo Nome da Origem de Dados. Consulte Especificar o Banco de Dados de Rastreamento de Uso.
- Nome do Usuário e Senha - O Nome do Usuário deve corresponder ao nome do esquema no banco de dados que você deseja usar para rastreamento de uso. Por exemplo, se o esquema que você quiser usar for chamado de UT_Schema, o Nome do Usuário terá de ser UT_Schema.
Nota:

Se você usar a Model Administration Tool, também poderá definir conexões de banco de dados para modelos semânticos e o banco de dados de rastreamento de uso usando a Console. Consulte Estabelecer Conexão com Dados em um Banco de Dados Oracle Cloud. Se você usar a Console, poderá selecionar Usar Conexão da Console e informar o Nome da conexão enquanto especifica o banco de dados de rastreamento de uso no Model Administration Tool, em vez de informar os detalhes da conexão no Nome da Origem de Dados.

Se você quiser usar o Oracle Autonomous Data Warehouse como o banco de dados de rastreamento de uso, conclua estas tarefas adicionais antes de especificar o banco de dados de rastreamento de uso no seu modelo semântico:

Fazer download da wallet do Oracle Autonomous Data Warehouse. Consulte Fazer Download das Credenciais do Cliente (Wallets) em Usando o Oracle Autonomous Database sem Servidor.
Fazer upload da wallet do Oracle Autonomous Data Warehouse para o Oracle Analytics Cloud. Consulte Proteger as Conexões de Banco de Dados com SSL.
Crie uma conexão de autoatendimento com o Oracle Autonomous Data Warehouse e certifique-se de marcar a caixa de seleção Conexão do Sistema. Consulte Estabelecer Conexão com o Oracle Autonomous Data Warehouse.

Sobre o Banco de Dados de Rastreamento de Uso

O sistema armazena os detalhes de rastreamento de uso em um banco de dados especificado por você. O banco de dados pode ser um Oracle Database ou o Oracle Autonomous Data Warehouse. Especifique os detalhes do banco de dados e do pool de conexões em seu modelo semântico usando o Semantic Modeler ou a Model Administration Tool.

Consulte Especificar o Banco de Dados de Rastreamento de Uso.

Sobre Parâmetros de Rastreamento de Uso

Após a especificação do banco de dados no qual deseja armazenar informações de rastreamento de uso, você deve definir vários parâmetros de rastreamento de uso por meio da Console (página Definições Avançadas do Sistema).

Parâmetros necessários para configurar o rastreamento de uso:

Ativar rastreamento de uso
Nome do pool de conexões
Nomes de tabela de logs de consulta física e lógica
Número máximo de linhas de consulta nas tabelas de rastreamento de uso

Após você definir esses parâmetros e aplicar as alterações, o Oracle Analytics:

Cria as tabelas de logs de consulta física e lógica no banco de dados especificado no modelo semântico. Os nomes de tabelas se baseiam nos nomes que você fornece nos parâmetros de nomes de tabela de registro em logs de consulta física e lógica.
Começa a registrar em log dados de rastreamento de uso nessas tabelas.

Consulte Definir Parâmetros de Rastreamento de Uso.

Sobre a Análise de Dados de Uso

Você pode usar o sistema para criar relatórios úteis de uso dos dados de rastreamento adicionados às tabelas de logs de consulta física e lógica.

É possível estabelecer conexão com o banco de dados, criar um conjunto de dados das tabelas e criar relatórios e visualizações para ajudar a entender as consultas dos usuários e tomar a ação apropriada para melhorar o desempenho.

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).

Workflow Típico para Rastreamento de Uso

Aqui estão as tarefas para rastrear as consultas de nível de usuário no Oracle Analytics Cloud.

Tarefa	Descrição	Mais Informações
Decida onde armazenar seus dados de rastreamento de uso	Entenda quais tipos de banco de dados você pode usar para rastreamento de uso.	Sobre o Banco de Dados de Rastreamento de Uso
Configurar uma conexão com o banco de dados de rastreamento de uso	Crie uma conexão de dados (ou uma conexão da Console) com o banco de dados em que você deseja armazenar informações de rastreamento de uso.	Pré-requisitos de Rastreamento de Uso
Especifique o banco de dados de rastreamento de uso	Defina o banco de dados de rastreamento de uso no seu modelo semântico.	Especificar o Banco de Dados de Rastreamento de Uso
Especificar parâmetros de rastreamento de uso	Ative o rastreamento de uso para seu sistema e depois especifique detalhes da conexão e nomes de tabela para o banco de dados de rastreamento de uso.	Definir Parâmetros de Rastreamento de Uso
Analisar os dados de rastreamento de uso	Crie relatórios de uso com base nos dados de rastreamento de uso.	Analisar Dados de Rastreamento de Uso

Especificar o Banco de Dados de Rastreamento de Uso

Para poder rastrear o uso de relatórios, painéis de controle e pastas de trabalho de visualização de dados em seu sistema, especifique o banco de dados no qual deseja armazenar os dados de rastreamento de uso em seu modelo semântico.

O banco de dados especificado deve ter pelo menos um esquema definido. O sistema cria tabelas de rastreamento de uso no esquema cujo nome corresponde ao nome do usuário que você especifica nos detalhes da conexão do banco de dados. Por exemplo, se o nome de um esquema no banco de dados de rastreamento de uso for “UT_Schema”, especifique "UT_Schema" no campo Nome do Usuário da conexão. As tabelas de rastreamento de uso são criadas no esquema chamado “UT_Schema”.

Configure os detalhes do banco de dados e do pool de conexões na camada física de seu modelo semântico. Use o Semantic Modeler ou a Model Administration Tool para configurar o banco de dados de rastreamento de uso.

Se você quiser usar o Oracle Autonomous Data Warehouse como o banco de dados de rastreamento de uso, conclua algumas tarefas adicionais relativas ao Oracle Autonomous Data Warehouse antes de especificar o banco de dados de rastreamento de uso. Consulte Pré-requisitos de Rastreamento de Uso.

Especificar o Banco de Dados de Rastreamento de Uso com o Semantic Modeler

Use o Semantic Modeler para configurar seu banco de dados de rastreamento de uso caso utilize no momento o Semantic Modeler para desenvolver modelos semânticos.

Se você ainda não fez isso, crie uma conexão de dados com seu banco de dados de rastreamento de uso com a opção Conexão do Sistema selecionada.
O tipo de banco de dados deve ser Oracle Database ou Oracle Autonomous Data Warehouse e o Nome do Usuário utilizado para estabelecer conexão com o banco de dados deve corresponder ao nome do esquema em que você deseja que as tabelas de rastreamento do usuário sejam armazenadas. Consulte Pré-requisitos de Rastreamento de Uso.
Na home page do Oracle Analytics, clique no Navegador e, em seguida, clique em Console.
Clique em Modelos Semânticos. Na página Modelos Semânticos, clique em um modelo semântico para abri-lo.
Crie um objeto de banco de dados para o banco de dados de rastreamento de uso.
1. Clique em Camada Física.
2. No painel Camada Física, clique em Criar e, em seguida, clique em Criar Banco de Dados.
3. Em Nome, informe um nome para o banco de dados do seu modelo semântico (por exemplo, UsageTracking) e clique em OK.
Adicione um pool de conexões para estabelecer conexão com o banco de dados de rastreamento de uso.
1. Na guia do banco de dados, clique em Pools de Conexões.
2. Clique em Adicionar Origem.
3. Clique duas vezes no campo Nome e informe um nome para o pool de conexões. Por exemplo, UTConnectionPool.
4. Clique duas vezes no campo Conexão e selecione na lista a conexão de dados que deseja usar. Por exemplo, MyUTDatabase.
  Nota:
  - Conexão do sistema - Modelos semânticos só podem usar conexões de dados com a opção Conexão do sistema selecionada. Consulte .
  - Nome do Usuário e Senha - O Nome do Usuário especificado na conexão de dados deve corresponder ao nome de um esquema no banco de dados que deseja usar para rastreamento de uso. Por exemplo, se o esquema que você quiser usar for chamado de UT_Schema, o Nome do Usuário terá de ser UT_Schema. Consulte Pré-requisitos de Rastreamento de Uso.
5. Clique em Abrir Detalhe. No painel Pool de Conexões, verifique se a caixa de seleção Exigir nomes de tabela totalmente qualificados não está marcada.
Valide suas alterações. Consulte Executar a Verificação de Consistência Avançada antes de Implantar um Modelo Semântico.
Salve suas alterações.

Especificar o Banco de Dados de Rastreamento de Uso com a Model Administration Tool

Use a Model Administration Tool para configurar seu banco de dados de rastreamento de uso caso utilize no momento a Model Administration Tool para desenvolver modelos semânticos.

Não será necessário fazer qualquer atualização no seu modelo semântico se você quiser rastrear o uso em um banco de dados ou pool de conexão existente. Você pode ignorar essas etapas. É possível usar o banco de dados, o pool de conexão e as tabelas existentes como parte da configuração do sistema de rastreamento de uso. O rastreamento de uso não vai excluir as tabelas existentes e criar novas com o mesmo nome se o esquema de tabela corresponder entre as tabelas antigas e novas.

Na Model Administration Tool, abra o modelo semântico na nuvem.
No menu Arquivo, selecione Abrir, Na Nuvem e insira informações de conexão para sua instância.
Especifique o banco de dados de rastreamento de uso:
1. Na camada Física do modelo semântico, clique com o botão direito do mouse e selecione Novo Banco de Dados.
2. Na caixa de diálogo Banco de Dados, forneça um nome para o banco de dados do seu modelo semântico; por exemplo, SQLDB_UsageTracking, especifique o tipo de banco de dados, por exemplo, Oracle 12c, e clique em OK.
3. Clique com o botão direito do mouse no banco de dados recém-criado, selecione Novo Objeto e depois selecione Pool de Conexões.
4. Na caixa de diálogo Pool de Conexões, informe detalhes do pool de conexões e especifique os valores de:
  - Interface de chamada: selecione Padrão (Oracle Call Interface (OCI)).
  - Exigir nomes de tabela totalmente qualificados: certifique-se de que essa caixa de seleção não esteja marcada.
  - Nome da Origem de Dados**: Especifique a origem de dados à qual você deseja que esse pool de conexões se conecte e envie consultas físicas. Por exemplo: (DESCRIPTION =(ADDRESS = (PROTOCOL = TCP)(HOST = <DB Host>)(PORT = <DB port>))(CONNECT_DATA =(SERVER = DEDICATED)(SERVICE_NAME = <Servicename>)))
  - Nome do usuário e Senha: Informe um nome de usuário que corresponda ao nome de um esquema disponível no banco de dados de rastreamento de uso.
  **Como alternativa para fornecer o Nome da Origem de Dados, você pode se referir a uma conexão de banco de dados existente “pelo nome” na caixa de diálogo Pool de Conexões.
  - Conexões de dados - Para usar os detalhes de conexão de um banco de dados definido por meio da guia Dados como seu banco de dados de rastreamento de uso, selecione Usar Conexão de Dados e informe o ID do Objeto da conexão em vez de inserir manualmente os detalhes da conexão no campo Nome da Origem de Dados. Certifique-se de que a conexão de dados que você deseja usar foi criada com a opção Conexão do Sistema selecionada.
  - Conexões da console - Se você usa a Model Administration Tool, pode definir conexões de banco de dados para modelos semânticos usando a Console. Para usar os detalhes da conexão de um banco de dados que você definiu por meio da Console como seu banco de dados de rastreamento de uso, marque a caixa de seleção Usar Conexão da Console e informe o nome da conexão de banco de dados no campo Nome da Conexão.
  Por exemplo:
  
  .gif
Valide suas alterações clicando em Ferramentas, Mostrar Verificador de Consistência e em Verificar Todos os Objetos.
Opcional: Salve as alterações localmente clicando em Arquivo e depois em Salvar.
Faça upload do arquivo .rpd de modelo semântico que você editou, clicando em Arquivo, Nuvem e Publicar.

Definir Parâmetros de Rastreamento de Uso

Para começar a registrar informações de uso, especifique os detalhes de conexão do banco de dados que você deseja usar e os nomes das tabelas de banco de dados usadas para rastrear o uso. Você define esses parâmetros na Console (página Definições Avançadas do Sistema).

Acesse seu serviço.
Clique em Console.
Clique em Definições Avançadas do Sistema.
Clique em Rastreamento de Uso.
Ative o rastreamento de uso para o seu sistema. Certifique-se de que a opção Ativar Rastreamento de Uso esteja ativada.
Defina as seguintes propriedades:
- Pool de Conexões de Rastreamento de Uso
  Nome do pool de conexões que você criou para seu banco de dados de rastreamento de uso, no formato <database name>.<connection pool name>. Por exemplo, UsageTracking.UTConnectionPool.
- Tabela de Blocos de Inicialização do Rastreamento de Uso
  Nome da tabela de banco de dados que você deseja usar para armazenar informações sobre blocos de inicialização, no formato <database name>.<catalog name>.<schema name>.<table name> ou <database name>.<schema name>.<table name>. Por exemplo, UsageTracking.UT_Schema.InitBlockInfo.
- Tabela de Logs de Consulta Física de Rastreamento de Uso
  Nome da tabela de banco de dados que você deseja usar para armazenar detalhes da consulta física, no formato <database name>.<catalog name>.<schema name>.<table name> ou <database name>.<schema name>.<table name>. Por exemplo, UsageTracking.UT_Schema.PhysicalQueries.
- Tabela de Logs de Consulta Lógica de Rastreamento de Uso
  Nome da tabela de banco de dados que você deseja usar para armazenar detalhes da consulta lógica, no formato <database name>.<catalog name>.<schema name>.<table name> ou <database name>.<schema name>.<table name>. Por exemplo, UsageTracking.UT_Schema.LogicalQueries.
- Máximo de Linhas de Rastreamento de Uso
  Número máximo de linhas que você deseja nas tabelas de rastreamento de uso. O valor mínimo é 1, o máximo é 100.000 e 0 significa ilimitado. Se a contagem de linhas exceder o número máximo, o processo de rastreamento de uso excluirá as linhas em excesso com base no timestamp mais antigo.
Clique em Aplicar.

O Oracle Analytics cria as tabelas de rastreamento de uso e começa a registrar em log as consultas do usuário.

Analisar Dados de Rastreamento de Uso

Crie relatórios de uso para entender as consultas do usuário e executar a ação apropriada.

Siga estes exemplos:

Analisar Dados de Rastreamento de Uso Criando um Conjunto de Dados

Elabore relatórios de uso criando conjuntos de dados com dados das tabelas de registro em log de consultas físicas e lógicas para entender as consultas do usuário.

Na home page do Oracle Analytics, clique no Menu Página e selecione Abrir Home Clássica. Crie e execute uma análise.
O sistema preenche a consulta nas tabelas de rastreamento de uso, no banco de dados de rastreamento de uso.
Na home page do Oracle Analytics, clique em Criar e em Conjunto de Dados.
Em Criar Conjunto de Dados, clique na conexão com o banco de dados de rastreamento de uso e selecione o esquema especificado nos nomes das tabelas de Registro em Log de Consulta Física e Consulta Lógica, nas Definições do Sistema. Por exemplo, o nome do esquema fornecido em <database name>.<schema name>.<table name> para os nomes de tabelas de Registro em Logs de Consulta Física e Consulta Lógica.
Esta é a conexão de banco de dados que você criou para configurar o rastreamento de uso. Consulte Pré-requisitos de Rastreamento de Uso.
Em Adicionar Conjunto de Dados, procure a tabela de logs de consulta física de rastreamento de uso, adicione todas as colunas, nomeie o conjunto de dados (por exemplo, Consultas Físicas) e, em seguida, clique em Adicionar. Da mesma forma, procure a tabela de logs de consulta lógica de rastreamento de uso, adicione todas as colunas, nomeie o conjunto de dados (por exemplo, Consultas Lógicas) e, em seguida, clique em Adicionar.
Na página Resultados do conjunto de dados, clique em Criar Pasta de Trabalho. Adicione ambos os conjuntos de dados à pasta de trabalho: por exemplo, Consultas Físicas e Consultas Lógicas. Nomeie a pasta de trabalho (por exemplo, Rastreamento de Uso).
Na guia Preparar da pasta de trabalho, clique em Diagrama de Dados e crie junções entre os conjuntos de dados usando uma coluna, como de ID.
Em Visualizar, arraste os dados para criar visualizações com base no seu requisito.
Consulte as descrições de tabela de rastreamento de uso em "Noções Básicas de Tabelas de Rastreamento de Uso" para selecionar as colunas aplicáveis. Por exemplo, você pode criar uma visualização para mostrar quanto tempo foi gasto em determinado número de consultas.

Analisar Dados de Rastreamento de Uso Utilizando uma Área de Assunto no Modelo Semântico

Crie relatórios de uso utilizando uma área de assunto no modelo semântico para entender as consultas dos usuários.

Importe metadados para garantir a sincronização entre eles e a camada física. Não personalize adicionando novas colunas nas tabelas de rastreamento de uso para evitar problemas de incompatibilidade de esquema.

Na home page do Oracle Analytics, clique no Menu Página e selecione Abrir Home Clássica. Crie e execute uma análise.
O sistema preenche a consulta nas tabelas de rastreamento de uso, no banco de dados de rastreamento de uso.
Importe o modelo semântico que tem as tabelas de Rastreamento de Uso atualizadas com os resultados da consulta. Consulte Importar o Modelo Implantado para Criar um Modelo Semântico.
Na home page do Oracle Analytics, clique em Dados e, em Conjuntos de Dados, selecione a área de assunto que corresponde às tabelas de rastreamento de uso para criar uma pasta de trabalho.
Na página Nova Pasta de Trabalho, em Visualizar, arraste os dados para criar visualizações com base nos requisitos.
Consulte as descrições de tabela de rastreamento de uso em "Noções Básicas de Tabelas de Rastreamento de Uso" para selecionar as colunas aplicáveis. Por exemplo, você pode criar uma visualização para mostrar quanto tempo foi gasto em determinado número de consultas.