Proteções de conteúdo

Esta página de documentação descreve a página Diretrizes de conteúdo na seção Central de performance do painel Administrador. Os guardrails de conteúdo são configurações que permitem que os administradores do Looker imponham limites sobre como algumas configurações de painel podem ser definidas pelos usuários do Looker.

Embora os painéis sejam ferramentas eficientes para transmitir insights de negócios, a performance deles pode ser afetada por vários fatores, incluindo:

  • Quantidades não verificadas de blocos, guias ou visualizações do painel
  • Execuções de consultas frequentes
  • Execuções de consultas complexas

Como administrador, os guardrails de conteúdo permitem considerar a troca entre a capacidade de personalização e o desempenho do painel.

A página Proteções de conteúdo tem as seguintes opções:

Para mais informações e recomendações sobre como criar painéis de alta performance, consulte Considerações ao criar painéis do Looker de alta performance.

Limitar consultas de resultados combinados

É possível desativar ou limitar as consultas de resultados combinados para todos os painéis em uma instância. As consultas de resultados combinados são calculadas após o processamento da consulta. Cálculos excessivos podem disputar a memória Java na instância do Looker, o que pode fazer com que ela responda mais lentamente.

Você pode ativar uma ou ambas as opções a seguir:

  • Ative a opção Limitar todas as consultas de resultados combinados para impedir a execução de todas as consultas combinadas. Os dashboards atuais que contêm blocos de consulta de resultados combinados vão mostrar No Results e um erro para os elementos correspondentes. Se o Looker encontrar esses erros, os envios programados de dashboards que contêm blocos de consultas de resultados combinados não serão executados.
  • Ative a opção Limitar novas consultas de resultados combinados em dashboards para impedir que os usuários salvem novas consultas de resultados combinados em dashboards. Os painéis que já têm blocos de consultas de resultados combinados não serão afetados.

Reduzir o tempo de carregamento das visualizações personalizadas

Ative a opção Pré-renderizar iframes (antes do carregamento de dados) para visualizações personalizadas e reduza o tempo de carregamento das visualizações personalizadas ao iniciar a renderização do iframe antes dos dados da consulta serem carregados.

Algumas visualizações personalizadas podem não ser mostradas corretamente no primeiro carregamento de um painel quando essa configuração está ativada.

Se o código JavaScript de uma visualização personalizada for escrito com a premissa de que os dados já estão disponíveis quando o ambiente do iframe é inicializado, a pré-renderização do iframe antes do carregamento dos dados poderá causar erros ou comportamento inesperado. A visualização pode tentar acessar dados que ainda não estão disponíveis, o que pode causar falhas ou renderização incorreta.

Proteções do dashboard

Com as proteções do painel, você controla ainda mais as configurações do painel e do bloco do painel. Nesta seção, é possível gerenciar o recurso de atualização automática para todos os painéis na instância. Também é possível gerenciar o número de guias e blocos que os usuários podem adicionar a qualquer painel na instância.

Limitar a atualização do painel

Você pode controlar a velocidade com que um painel é atualizado automaticamente ou desativar a opção para todos os usuários, exceto administradores.

Ative a opção Limitar a opção "Atualizar painel automaticamente" para que apenas os administradores do Looker possam configurar os dashboards para atualização automática.

Com a opção Limitar o intervalo mínimo de atualização automática global para os painéis e os blocos, é possível definir um intervalo mínimo para a atualização automática do painel. Essa configuração se aplica a todos os dashboards na instância do Looker.

Os dashboards configurados para atualização automática com mais frequência do que o intervalo de tempo neste campo não serão atualizados automaticamente com mais frequência do que o valor configurado neste campo.

Por exemplo, se você tiver um painel configurado para atualização automática com mais frequência do que o processo de ETL do banco de dados, sempre que o painel for atualizado antes da próxima ETL, ele não vai recuperar novos dados. Para evitar essas consultas desnecessárias, use esse campo para definir o tempo mínimo de atualização do painel de controle para corresponder ao tempo entre os processos de ETL do banco de dados. Assim, quando o painel for atualizado, ele vai recuperar novos dados.

Para definir um tempo mínimo para a atualização automática do painel, selecione um intervalo de tempo (Segundos, Minutos, Horas ou Dias). Em seguida, insira o número do intervalo de tempo selecionado que constitui o tempo mínimo entre as atualizações automáticas do painel. Depois de inserir o intervalo mínimo, clique em Salvar.

Defina esse campo como 0 ou deixe em branco para ativar a atualização automática ilimitada do painel.

Máximo de guias do dashboard

O campo Número máximo de guias do painel permite definir um número máximo de guias que os usuários podem adicionar aos painéis. É possível definir um limite de até 10 guias.

Saiba mais sobre os painéis com guias.

Máximo de blocos de consulta

O campo Número máximo de blocos de consulta por painel permite definir um número máximo de blocos de consulta que os usuários podem adicionar aos painéis. Recomendamos no máximo 25 blocos de consulta por painel.

O campo Máximo de blocos de consulta por guia permite definir o número máximo de blocos de consulta que os usuários podem adicionar às guias do painel. Recomendamos no máximo 20 blocos de consulta por guia.

Se os usuários tentarem adicionar mais blocos do que o máximo especificado no campo Número máximo de blocos de consulta por guia, o erro A guia tem muitos blocos de consulta vai aparecer.

Se você definir um número máximo menor do que a quantidade de blocos que os usuários já adicionaram a uma guia, esses blocos não serão afetados.

Limites de visualização

Os campos a seguir definem os limites de linhas das consultas de usuários para gráficos de mapa, gráficos de dispersão e gráficos de tabela. É possível definir o limite acima do máximo anterior de 5.000 linhas, até 50.000 linhas.

  • Limite de linhas da visualização de mapas: define a densidade de dados para até 50.000 pontos de dados em um mapa geográfico.
  • Limite de linhas da visualização de gráfico de dispersão: define a densidade de dados para gráficos de dispersão, até 50.000 pontos de dados.
  • Limite de linhas da visualização de tabela:define o número máximo de linhas retornadas e mostradas nos resultados, até 50.000 pontos de dados.

Há vários pontos importantes sobre os limites de visualização:

  • Os blocos do painel não vão refletir automaticamente os aumentos no limite de linhas. É necessário editar os blocos do painel para aumentar os limites de linhas.
  • Ao editar blocos de consulta em painéis ou consultas de origem de resultados combinados individuais, apenas 5.000 linhas de dados serão mostradas, mesmo que você aumente o limite de linhas. No entanto, se você definir um limite maior que 5.000 linhas, o bloco de consulta e a consulta de origem de resultados combinados serão salvos com o limite definido.
  • É possível enviar, programar ou baixar um painel com limites de linhas aumentados em formato PDF, com as seguintes ressalvas:
    • Os resultados da consulta para cada gráfico de tabela em um painel mostram até 50.000 linhas, com um limite máximo total de 200.000 células por painel.
    • Se o total combinado de células para gráficos de tabela em um painel for maior que 200.000, os resultados do gráfico de tabela poderão ser cortados. Se o máximo for atingido, os usuários vão receber um aviso que também será mostrado na parte de baixo do PDF renderizado.
    • Os gráficos de tabela em um PDF do painel mostram mais linhas do que a miniatura do bloco do painel apenas quando a opção Abrir tabelas para mostrar todas as linhas está selecionada.
    • Os gráficos de dispersão e do Google Maps aceitam até 50.000 pontos de dados (linhas) em downloads de PDF. Os gráficos serão renderizados como aparecem na miniatura do bloco ou falharão com base nas limitações padrão do renderizador.