Parâmetros gerais do SoftExpert Analytics
Pré-requisitos
- Acesso ao menu Configuração > Parâmetros gerais (AN007).
- Licença Manager.
Apresentação
O menu Parâmetros gerais reúne configurações que controlam a execução e o desempenho das análises.
Por meio dele, é possível definir tempos limite para consultas e materializações, bloquear análises que apresentem lentidão, configurar a retenção de históricos, gerenciar a execução simultânea de operações e ajustar a porta de exportação de visões.
Essas parametrizações asseguram maior estabilidade, desempenho e governança no uso do SoftExpert Analytics.
Veja como configurar os parâmetros gerais do componente:
Configurar parâmetros gerais
1. Acesse o menu Configuração > Parâmetros gerais (AN007).
2. Parametrize o sistema conforme os recursos desejados. Estão disponíveis as seguintes operações:
Definir tempo limite
Nos parâmetros gerais, é possível estabelecer um tempo limite para a execução das seguintes operações:
Execução de comandos SQL
Por padrão, o tempo para execução de comandos SQL no SoftExpert Analytics é de 5 minutos. Passado este tempo, irá ocorrer erro de timeout.
Para alterar o tempo padrão, preencha o campo Tempo limite para execução de comandos SQL (minutos) com os minutos limite para execução do SQL, que devem ser entre 1 e 5.
• Para utilizar tempo superior a 5 minutos, será preciso realizar configurações complementares no servidor de aplicação. Se necessário, consulte o suporte técnico.
• O SQL de uma análise é executado sempre ao atualizar ou arrastar uma visão no portal ou no editor de visões.
Materialização
Por padrão, o tempo para materialização de uma análise do SoftExpert Analytics é de 5 minutos. Passado este tempo, irá ocorrer erro de timeout.
Porém, para grandes volumes de dados, pode ser necessário configurar um tempo maior. Neste caso, preencha o campo Tempo limite para a materialização (minutos) com o número de minutos limite para a materialização.
A materialização dos dados é configurada na análise, e a atualização da materialização é feita por meio de um agendamento, que também é configurado na análise.
Quando o agendamento for iniciado, o sistema irá executar o SQL e salvar os dados em uma tabela temporária.
Bloquear análises
O sistema permite bloquear análises lentas, possibilitando determinar um limite para erros de timeout e o tempo pelo qual elas permanecerão bloqueadas.
Para isso, realize os seguintes passos:
1. Na seção Tempo limite, marque a opção Bloquear de forma temporária análises lentas.
2. No campo Número de timeouts consecutivos que bloqueiam a análise, informe o número de erros consecutivos de timeout que, quando atingido, bloqueará a análise.
3. No campo Tempo de bloqueio da análise (minutos), informe a quantidade de minutos pelos quais a análise permanecerá bloqueada. Transcorridos os minutos definidos, a análise será desbloqueada.
O campo Número de timeouts consecutivos que bloqueiam a análise se refere aos timeouts que poderão ocorrer na análise toda vez que seu SQL for executado, ou seja, se a execução do comando SQL demorar para ser finalizada.
Gerenciar desempenho
É possível estabelecer se as seguintes operações serão executadas simultaneamente ou não:
Materialização
Para que as materializações agendadas em um mesmo horário sejam executadas ao mesmo tempo, marque a opção Permitir a execução de materializações simultâneas. É importante ressaltar, porém, que neste caso, o risco de sobrecarregar os servidores aumenta, o que pode comprometer o sistema.
Se a opção que permite a execução de materializações simultâneas não for marcada, as materializações agendadas em um mesmo horário serão executadas sequencialmente, reduzindo assim o risco de sobrecarregar os servidores.
O sistema também automatiza a inativação de materializações obsoletas, evitando que análises sem uso ou com erros contínuos continuem consumindo recursos do servidor.
São utilizadas duas rotinas automáticas para inativar análises nos seguintes cenários:
- Materializações sem uso: quando a tabela materializada não é acessada pelo SoftExpert Suite, por exemplo, ao longo de 15 dias seguidos.
- Materializações com erros recorrentes: quando a análise falha ao tentar materializar, por exemplo, ao longo de 15 dias seguidos.
A inativação das análises é reversível: caso uma análise seja reutilizada no futuro, basta reativá-la e ajustar sua configuração para que ela volte a funcionar normalmente.
Os critérios de inativação por falta de uso ou por erros recorrentes consideram metade do valor definido no campo Materializações e visualização de visões (Dias), cujo padrão é 30 dias.
Se em 15 dias a tabela materializada não for acessada ou apresentar falhas consecutivas, a análise será inativada automaticamente. Caso necessário, esse período pode ser ajustado para mais de 30 dias.
É possível ativar ou desativar as duas rotinas por meio das opções Inativar automaticamente análises com erros recorrentes e Inativar automaticamente análises sem uso.
O sistema também permite definir a quantidade máxima de registros suportados nas materializações. Basta preencher o campo Limite de registros para materialização.
O valor padrão de registros suportados nas materializações é de 1 milhão, e embora seja possível aumentar esse parâmetro, recomenda-se que os administradores ajam com cautela para evitar sobrecargas nos servidores e interferências no funcionamento de outras partes do sistema.
O sistema também permite configurar o limite de registros e a duração máxima do comando SQL para geração de visões a partir dos menus de consulta.
Ao tentar salvar uma visão proveniente de uma consulta, o usuário pode receber um aviso para aplicar filtros à consulta antes de continuar com a criação da visão.
O sistema apresenta os campos Limite de registros para gerar visões a partir dos menus de consultas e Duração máxima do comando SQL para gerar visões a partir dos menus de consultas (em segundos), que indicam a quantidade máxima de registros (com padrão de 1 milhão) e a duração máxima (com padrão de 15 segundos) que o comando SQL pode levar para retornar os dados da consulta.
Se o comando SQL ultrapassar esses limites, o sistema continuará solicitando que o usuário aplique filtros para garantir uma experiência eficiente e otimizada.
Exportações
Para que as exportações para XLSX agendadas em um mesmo horário sejam executadas ao mesmo tempo, marque a opção Permitir a execução de exportações simultâneas.
Porém, é importante ressaltar que, neste caso, o risco de sobrecarregar os servidores aumenta, o que pode comprometer o sistema.
Se a opção que permite a execução de exportações simultâneas não for marcada, as exportações agendadas em um mesmo horário serão executadas sequencialmente, reduzindo assim o risco de sobrecarregar os servidores.
Queries
Por padrão, o SoftExpert Analytics está parametrizado para permitir a execução de até 15 queries simultaneamente.
Para editar esta parametrização, informe no campo Máximo de queries simultâneas o número máximo de queries que poderão ser executadas ao mesmo tempo. O número informado deve ser maior que 0.
Configurar histórico
O sistema permite parametrizar por quantos dias os históricos das análises permanecerão no banco de dados até sua exclusão.
Para isso, nos campos Visualização de relatórios (dias) e Materializações e visualização de visões (Dias), informe a quantidade de dias pelos quais deseja guardar os históricos.
Transcorridos os dias configurados, os históricos das análises serão excluídos.
Definir porta de serviço de exportação
O componente permite parametrizar a porta que será utilizada pelo serviço responsável pela exportação das visões para imagem.
Para isso, preencha o campo Porta do serviço de exportação com a porta que deverá ser utilizada pelo serviço. Para que o SoftExpert Analytics selecione a porta automaticamente, informe o valor 0.
3. Clique no botão 
.
Conclusão
Os parâmetros gerais estarão devidamente configurados.