Na página Configurações da seção Geral do painel Administrador, os administradores do Looker podem configurar as configurações de toda a instância do Looker. Algumas configurações estão disponíveis apenas para instâncias do Looker (original) ou do Looker (Google Cloud Core).
Configurações
As seguintes configurações estão disponíveis para instâncias do Looker.
Forçar o uso do escopo somente leitura do BigQuery
Ao ativar essa configuração, os usuários com credenciais OAuth que permitem o escopo de leitura e gravação em qualquer conexão do BigQuery são desconectados. Quando os usuários se autenticarem novamente, o Looker vai criar credenciais OAuth somente leitura para eles. Consulte Restringir o escopo do OAuth ao modo somente leitura para conexões do Google BigQuery para mais informações.
Chave de licença
A chave de licença é exclusiva da instância do Looker que você está usando. Ele ativa ou desativa determinados recursos do Looker com base no seu contrato de licenciamento.
A chave de licença fica oculta por padrão. Selecione o ícone de olho para mostrar a chave de licença.
URL do host
O URL do host é a parte base do URL da sua instância do Looker. Ele é usado especificamente quando links para sua instância são criados em e-mails programados e em todos os URLs absolutos gerados pelo Looker.
Verifique se a configuração URL do host usa http:// ou https:// adequadamente, com base na configuração do servidor da sua instância.
Mudar o URL do host pode afetar a funcionalidade de alguns recursos do Looker. Consulte O que acontece se o URL da minha instância do Looker mudar? Página de práticas recomendadas para mais informações sobre como mudar os URLs da instância.
Contatos técnicos
Os endereços de e-mail adicionados a essa caixa vão receber notificações sobre atualizações de segurança, correções de bugs importantes e novas versões do Looker. O endereço de e-mail precisa pertencer a um usuário válido do Looker. Se você adicionar um e-mail que não pertence a um usuário válido do Looker, por exemplo, um endereço de e-mail de uma lista de distribuição, ele vai aparecer no campo Contato técnico, mas o Looker não poderá enviar notificações para esse endereço.
O suporte do Looker precisa da permissão de um contato técnico para fazer qualquer uma das seguintes ações:
- Causar inatividade na instância, o que pode acontecer devido a uma atualização de versão não programada, mudanças de desempenho no servidor do Looker ou outros motivos
- Mudar algo na sua licença do Looker, talvez para ativar novos recursos.
fuso horário do aplicativo
Ao mostrar dados em uma Análise, um Look ou um painel, o Looker pode converter dados de tempo do fuso horário do banco de dados da conexão para o fuso horário apropriado para esse usuário.
Se a opção Fusos horários específicos do usuário estiver ativada, um administrador poderá definir o fuso horário padrão do usuário ou os usuários poderão definir o próprio fuso horário padrão. Se o administrador ou usuário não tiver definido o fuso horário padrão, o fuso horário do aplicativo será usado para esse usuário, e todos os dados com base em tempo consultados por ele serão convertidos para o fuso horário do aplicativo.
A configuração Fuso horário do aplicativo também é usada como o fuso horário padrão para entregas de conteúdo. O fuso horário usado para programações não afeta os dados de tempo retornados por uma consulta. Ele afeta apenas o horário em que uma entrega de dados é enviada.
Consulte a página de documentação Como usar as configurações de fuso horário para mais informações.
Configuração de recursos
As seguintes configurações de recursos estão disponíveis para instâncias do Looker.
Sistema fechado
A configuração Sistema fechado é usada com grupos para impedir que os usuários de um grupo saibam sobre os usuários de outro. Isso geralmente é útil para instalações multitenant.
Os locais no Looker em que os usuários podem ver outros usuários incluem:
- A página "Usuários" na seção Administrador do Looker
- Pastas dos usuários na seção Pastas do menu principal do Looker, se eles tiverem recebido pelo menos acesso de visualização à pasta pessoal de outro usuário.
- O pop-up "Gerenciar acesso", que faz parte do gerenciamento de pastas
Quando a configuração Sistema fechado está ativada, um usuário sem permissão de administrador e sem a permissão see_users só pode ver os outros usuários com quem compartilha um grupo e os grupos de que faz parte.
Os administradores e os usuários que receberam a permissão see_users podem ver todos os usuários e grupos na instância.
Configuração de consentimento de login
Quando ativada, a Configuração de consentimento de login faz com que uma tela de consentimento seja exibida para todos os usuários que tentarem fazer login na instância do Looker. A tela de consentimento vai mostrar a mensagem inserida no campo Configuração da mensagem e vai exigir que os usuários cliquem no botão Concordo na tela de consentimento antes de fazer login na instância. Depois de ativar a Configuração de consentimento de login, o campo Configuração de mensagem fica visível.
Configuração da mensagem
Se a opção Configuração de consentimento de login estiver ativada, no campo Configuração de mensagem, insira a mensagem que será mostrada a todos os usuários que tentarem fazer login na instância do Looker. Esse campo só fica visível depois que a Configuração de consentimento de login é ativada.
Pastas pessoais particulares padrão
Quando a opção Pastas pessoais particulares padrão está ativada, a pasta pessoal de um usuário fica visível apenas para ele e para os administradores do Looker. Por padrão, outros usuários não veem a pasta na pasta "Pessoas", e o conteúdo dela não fica visível nos quadros nem nas pesquisas de conteúdo.
Se quiser dar acesso a uma pasta pessoal, adicione outros usuários ou grupos de usuários com a opção Gerenciar acesso no menu de engrenagem da pasta pessoal.
Se você desativar a opção Pastas pessoais particulares padrão, a pasta pessoal de um usuário poderá ser exibida para qualquer usuário do Looker no grupo de usuários Todos os usuários.
Notificação de nova conta
A configuração Notificação de nova conta pode ser ativada ou desativada. Quando ativado, qualquer usuário administrador do Looker recebe um e-mail quando uma nova conta do Looker é criada. (Os usuários de incorporação assinada são uma exceção. Os e-mails não são gerados quando um usuário de incorporação assinada é criado.) O e-mail vai conter o endereço de e-mail do novo usuário.
Guias no app
Com os guias no app, o Looker pode se comunicar com os usuários no aplicativo por tutoriais, banners, alertas e pesquisas. Essas comunicações são usadas para ajudar os usuários a aproveitar melhor a plataforma, alertar sobre novos recursos, receber feedback dos usuários sobre a plataforma e convidar para treinamentos e eventos em que eles podem aprender a usar melhor o Looker.
Os administradores podem desativar os guias para a instância, o que vai desativar os guias para todos os usuários dela. Não é possível desativar seletivamente os guias no app para determinados usuários. O Looker não mostra guias no app para usuários incorporados ou usuários que não são administradores em instâncias de marca própria.
Os guias são projetados e implantados pela equipe de experiência do cliente do Looker e mudam com o tempo. O Looker usa JavaScript de software de terceiros (Pendo) para veicular os guias. O Looker verifica os guias individuais e os adiciona à lista de permissões. Ao buscar um guia do Pendo, o Looker usa hashes de integridade SHA-256 para validar se o guia não foi alterado. Se houver mudanças no guia após a revisão do Looker, o uso dele será impedido. Se o navegador de um usuário não conseguir acessar o servidor do Pendo, o guia não será exibido.
Integração
Quando ativado, os administradores e desenvolvedores do Looker que fizerem login em uma nova instância do Looker vão acessar o tutorial de integração do Looker, que orienta os usuários nas quatro principais etapas para usar uma instância do Looker:
- Como adicionar uma conexão
- Como criar um projeto
- Editar arquivos do projeto conforme necessário
- Análise detalhada de dados
Quando qualquer combinação de administradores ou desenvolvedores concluir o guia completo, ele deixará de ser exibido.
A configuração Guias no app precisa estar ativada para que a opção Integração fique disponível.
Banner de notificação de cookies
Quando ativada, essa configuração mostra um banner de notificação de cookies para todos os usuários na sua instância. Esta configuração fica desativada por padrão.
Recomendamos que você ative essa configuração se a sua instância do Looker precisar obedecer aos regulamentos de proteção de dados da União Europeia.
Pesquisa selecionada
Quando a Pesquisa selecionada está ativada, um usuário pode pesquisar conteúdo em pastas compartilhadas, na pasta pessoal e nos quadros. O conteúdo salvo nas pastas pessoais de outros usuários só será incluído nos resultados se também estiver fixado em um painel. Os resultados da pesquisa vão excluir o conteúdo que existe apenas nas pastas pessoais de outros usuários. Um usuário pode excluir conteúdo em pastas pessoais selecionando a chave ao lado do nome do recurso Pesquisa selecionada na caixa de diálogo modal de pesquisa.
Limitar a opção "Atualizar painel automaticamente"
Quando essa configuração está ativada, apenas os administradores do Looker podem ativar a opção Atualizar painel automaticamente nos dashboards definidos pelo usuário. Isso impede que usuários sem privilégios de administrador atualizem automaticamente os dados em dashboards e blocos de dashboards. A atualização automática dos dados do painel pode sobrecarregar alguns sistemas de banco de dados.
Visualizações em tela cheia
Quando ativado, esse recurso permite visualizações em tela cheia e expandidas para visualizações nos blocos do painel. Consulte a página de documentação Visualizar painéis para mais informações sobre as opções de visualização.
A funcionalidade de tela cheia e expandida pode ser desativada em um painel no menu Configurações do painel.
Número do projeto do Google Cloud
Um número de projeto Google Cloud é necessário para ativar o suporte no app. Esse valor pode ser encontrado na página de visão geral do Cloud no console_name_short.
Essa mudança pode levar até duas horas para entrar em vigor. Para implementar a mudança imediatamente, clique no botão Atualizar ao lado da configuração Chave de licença depois de inserir o número do seu projeto Google Cloud .
Se você ainda não tiver um projeto do Google Cloud para o Looker, crie um seguindo nosso guia de criação de projetos do Google Cloud ou nossa documentação mais detalhada sobre como criar e gerenciar projetos.
Usar o Gravatar
Quando ativada, essa configuração mostra a opção Foto do perfil no menu do usuário, permitindo que os usuários selecionem ou criem um avatar para a conta usando o app Gravatar.
fusos horários específicos dos usuários
Ao adicionar uma conexão, especifique o fuso horário em que o banco de dados armazena informações de hora como o fuso horário do banco de dados.
Quando a opção Fusos horários específicos do usuário está ativada, cada usuário recebe um fuso horário, e o Looker converte os dados baseados em tempo do Fuso horário do banco de dados para o fuso horário de um usuário quando ele visualiza os resultados da consulta ou interpreta os filtros.
Quando a opção Fusos horários específicos do usuário está desativada, o Looker converte os dados baseados em tempo de todos os usuários para o valor Fuso horário da consulta.
Consulte a página de documentação Como usar as configurações de fuso horário para mais informações.
Cores de visualização padrão
Cada instância do Looker precisa ter uma coleção de cores padrão. Com a configuração Cores de visualização padrão, você pode definir uma coleção de cores padrão para visualizações e criar novas coleções para usar nas suas instâncias. Você pode selecionar uma coleção de cores atual ou criar uma coleção personalizada.
Selecionar uma coleção de cores
Para definir uma coleção de cores como padrão, escolha uma no menu suspenso e clique em Atualizar. Observação: definir uma nova coleção de cores padrão atualiza todas as visualizações em Looks e painéis que usam a coleção de cores padrão. As visualizações salvas com uma coleção de cores diferente ou uma paleta personalizada não serão afetadas.
As primeiras paletas categóricas, sequenciais e divergentes de cada coleção aparecem diretamente abaixo do menu suspenso. Essas são as paletas que serão usadas como padrões de visualização. Para ver todas as paletas na coleção de cores, acesse a página de documentação Coleções de cores.
Como criar uma coleção de cores personalizadas
Para criar uma coleção de cores personalizada, siga estas etapas:
- Selecione a última opção Nova coleção de cores no menu suspenso Cores padrão da visualização.
- Dê um nome exclusivo à nova coleção no campo Nome.
- Clique em cada paleta de cores para abrir o menu Cores na paleta.
- Selecione cores individuais no menu Cores na paleta para editar uma de cada vez ou selecione Editar tudo para editar todas as cores de uma só vez.
- Repita as etapas 3 e 4 para cada paleta de cores.
- Quando terminar de editar sua nova coleção de cores, clique em Criar.
Os valores de cor podem ser formatados como strings hexadecimais, como #2ca6cd, ou como nomes de cores CSS, como mediumblue. Ou clique na roda de cores para abrir e selecionar uma tonalidade no seletor de cores. Se você escolher editar todas as cores, use uma vírgula entre cada nome para separá-las. Para adicionar ou remover uma cor, clique nos sinais + ou -.
A nova coleção se tornará automaticamente o padrão da instância, mas você pode escolher um padrão diferente se quiser.
Os IDs de coleção e de paleta para novas coleções de cores personalizadas são baseados no nome de cada coleção. Isso permite que os painéis do LookML que usam essas coleções sejam renderizados de forma consistente em todas as instâncias se ambas tiverem as mesmas coleções personalizadas com nomes idênticos.
Como excluir uma coleção de cores personalizadas
Para excluir uma coleção de cores personalizadas, selecione a coleção no menu suspenso e clique no botão Excluir que aparece. Não é possível excluir as coleções de cores integradas do Looker.
Carregar recursos da CDN
Essa opção está disponível apenas para instâncias hospedadas pelo cliente. Como as instâncias hospedadas pelo Looker sempre carregam recursos da CDN, não é possível desativar essa configuração para elas.
CDN significa rede de fornecimento de conteúdo. Uma CDN é uma rede de servidores que armazena conteúdo em vários locais geográficos para reduzir o tempo de carregamento da página para os usuários. Seus dados nunca são armazenados nesses servidores. Apenas itens específicos do Looker, como imagens, são armazenados na CDN.
A configuração Carregar recursos da CDN pode ser ativada ou desativada. Quando ativada, as páginas do Looker carregam mais rápido.
Manter recursos no cache do navegador
Quando essa configuração está ativada, os recursos estáticos, como arquivos JavaScript e fontes, são armazenados em cache no armazenamento do navegador de cada usuário. Isso acelera as navegações subsequentes, porque o navegador não precisa continuar recarregando esses recursos do servidor do Looker.
Acesso no aplicativo para dispositivos móveis
Quando essa configuração está ativada, os usuários podem fazer login na conta do Looker na instância usando o app Looker para dispositivos móveis e o app Looker (legado). Quando ela está desativada, todas as sessões móveis são encerradas.
Forçar autenticação por dispositivo móvel
Quando essa configuração está ativada, os usuários precisam fazer login no app Looker para dispositivos móveis e no app Looker (legado) sempre que abrem o app no dispositivo móvel.
Além disso, os usuários vão sair do app para dispositivos móveis após 60 minutos de inatividade.
Política de dados
As seguintes configurações de política de dados estão disponíveis para instâncias do Looker.
URLs públicos
A configuração URL público pode ser ativada ou desativada. Quando essa configuração está ativada, os usuários do Looker com as permissões adequadas podem gerar URLs públicos para acessar os dados do Looker.
Lista de permissões de domínios de e-mail para conteúdo programado
Com essa configuração, os administradores do Looker podem definir os domínios de e-mail em que os usuários podem enviar conteúdo do Looker (Looks, painéis, consultas com visualizações) ou notificações de alerta por e-mail.
Para limitar envios de conteúdo e notificações de alerta para endereços de e-mail com um domínio específico, insira o domínio no formato domain.suffix. Por exemplo, para limitar o envio de e-mails apenas aos domínios gmail.com e friendly_domain.org, especifique esses domínios no campo Lista de permissões de domínio de e-mail para conteúdo programado e conceda aos usuários a permissão schedule_look_emails.
Saiba mais sobre como essa configuração e as permissões de um usuário afetam a capacidade de entregar conteúdo do Looker e notificações de alerta na seção Visão geral das permissões desta página.
Atributo do usuário looker_internal_email_domain_allowlist
Além dos domínios de e-mail incluídos no campo global Lista de permissões de domínios de e-mail para conteúdo programado, você também pode especificar domínios de e-mail por grupo usando o looker_internal_email_domain_allowlist atributo do usuário. O atributo de usuário aceita o mesmo formato de string da configuração de administrador Lista de permissão de domínio de e-mail para conteúdo programado.
Se um grupo for atribuído a vários conjuntos de domínios de e-mail, por exemplo, por participação em vários grupos, os membros desse grupo poderão enviar e-mails para todos os domínios atribuídos a cada um dos valores de atributo do usuário, bem como para os domínios listados na configuração de administrador Lista de permissão de domínios de e-mail para conteúdo programado. Em outras palavras, o conjunto de domínios de e-mail para os quais um grupo pode enviar e-mails é a união do conjunto de domínios de e-mail listados no campo Lista de permissões de domínios de e-mail para conteúdo programado e de todos os conjuntos de domínios de e-mail atribuídos ao grupo pelo atributo de usuário looker_internal_email_domain_allowlist.
Visão geral das permissões
Os usuários incorporados e não incorporados precisam ter pelo menos a permissão schedule_look_emails para enviar qualquer conteúdo do Looker por e-mail. Para enviar notificações de alerta, um usuário também precisa ter permissões create_alerts.
Usuários incorporados e não incorporados com a permissão schedule_look_emails também podem receber a permissão schedule_external_look_emails. Saiba mais sobre permissões e dependências na página de documentação Funções.
Para uma visão geral de como as permissões de usuário afetam os domínios para os quais os usuários podem enviar alertas ou entregas de conteúdo do Looker, consulte a tabela a seguir:
| Tipo de usuário | Permissões | A lista de permissões de domínios de e-mail para conteúdo programado contém o domínio friendly_domain.org |
A lista de permissões de domínios de e-mail para conteúdo programado não contém domínios |
|---|---|---|---|
| Não incorporado | Apenas o schedule_look_emails |
Podem enviar conteúdo por e-mail para o próprio endereço, para o endereço de outro usuário do Looker na mesma instância ou para um endereço com o domínio friendly_domain.org. |
Pode enviar conteúdo por e-mail para qualquer endereço de e-mail |
schedule_look_emails e create_alerts |
Podem enviar conteúdo por e-mail e notificações de alerta para o próprio endereço de e-mail, para o endereço de e-mail de outro usuário do Looker na mesma instância ou para um endereço de e-mail com o domínio friendly_domain.org. |
Pode enviar conteúdo e notificações de alerta por e-mail para qualquer endereço | |
Apenas o schedule_external_look_emails |
Pode enviar conteúdo por e-mail para qualquer endereço de e-mail | Pode enviar conteúdo por e-mail para qualquer endereço de e-mail | |
schedule_external_look_emails e create_alerts |
Pode enviar conteúdo e notificações de alerta por e-mail para qualquer endereço | Pode enviar conteúdo e notificações de alerta por e-mail para qualquer endereço | |
| Incorporação assinada | Apenas o schedule_look_emails |
Pode enviar conteúdo de e-mail para um endereço com o domínio friendly_domain.org |
Não é possível enviar conteúdo do Looker por e-mail |
schedule_look_emails e create_alerts |
Pode enviar conteúdo e notificações de alerta por e-mail para um endereço com o domínio friendly_domain.org |
Não é possível enviar por e-mail conteúdo do Looker ou notificações de alerta | |
schedule_external_look_emails |
Pode enviar conteúdo por e-mail para qualquer endereço de e-mail | Pode enviar conteúdo por e-mail para qualquer endereço de e-mail | |
schedule_external_look_emails e create_alerts |
Pode enviar conteúdo e notificações de alerta por e-mail para qualquer endereço | Pode enviar conteúdo e notificações de alerta por e-mail para qualquer endereço |
O conteúdo incorporado do Looker é acessado por uma conta de usuário incorporada dedicada, não por contas de usuários individuais. Quando uma pessoa acessa o conteúdo do Looker por uma incorporação, não se espera que o Looker saiba o endereço de e-mail do usuário individual.
Uma exceção às regras estipuladas na tabela é a seguinte: você pode fornecer ao Looker o endereço de e-mail de um usuário incorporado definindo-o no atributo de usuário email no URL de incorporação assinado. Exemplo:
...&user_attributes={"email":"joe@domain.com"}
Se você definir o atributo de usuário email no URL de incorporação, o Looker vai permitir que um usuário incorporado que tenha apenas a permissão schedule_look_emails envie conteúdo do Looker para o próprio endereço de e-mail, mesmo que o domínio de e-mail não esteja no campo Lista de permissões de domínio de e-mail para conteúdo programado ou se esse campo estiver em branco.
Lista de permissões de URL para ações de dados
Essa configuração permite definir URLs (como https://looker.com) em que os usuários podem processar ações de dados.
Por exemplo, se você adicionar o URL https://looker.com à lista de permissões de URL para ações de dados, elas só poderão ser processadas em https://looker.com. Não será possível processar ações de dados em outros URLs.
Se esse campo for deixado em branco, não haverá restrições de URL para ações de dados. No entanto, se você incluiu um atributo do usuário em uma ação de dados, esse campo é obrigatório. Nesse caso, você precisa fornecer URLs válidos para processar ações de dados.
Bloquear imagens incorporadas inline nos resultados da consulta
Por padrão, o Looker não mostra imagens codificadas em Base64 nos resultados da consulta. Desative essa configuração para mostrar imagens codificadas em Base64 nos resultados da consulta.
Bloquear fórmulas e macros em arquivos CSV e Excel
Quando essa configuração está ativada, o Looker adiciona um caractere ' a todos os valores que podem ser interpretados como fórmulas ou macros em consultas baixadas nos formatos de planilha CSV ou Excel.
Token de webhook de saída
Se um usuário usar um webhook para entregar conteúdo, como um painel ou um Look, a solicitação vai incluir um token especial do Looker que pode ser definido aqui. Os servidores que recebem webhooks podem verificar se as solicitações contêm esse valor para confirmar a legitimidade delas. Para redefinir o token, clique em Redefinir.
Ativação e gerenciamento de usuários automatizados do Gemini no Looker
Um novo grupo de usuários chamado Usuários padrão do Gemini foi criado automaticamente para todas as instâncias do Looker (original) que usam uma configuração de sistema aberto. Os usuários desse grupo recebem a função Gemini, que permite usar os recursos do Gemini no Looker.
O status da configuração Ativação e gerenciamento de usuários automatizados do Gemini no Looker afeta o grupo da seguinte maneira:
- Se você ativar a configuração:
- Os novos usuários adicionados à instância são incluídos automaticamente no grupo.
- Se você desativar a configuração:
- Os novos usuários adicionados à instância precisam ser incluídos no grupo manualmente.
- Se você quiser remover membros do grupo Usuários padrão do Gemini, faça isso manualmente.
O status da configuração em 9 de junho de 2025 tem os seguintes efeitos:
- Se a configuração foi ativada antes de 9 de junho de 2025, todos os usuários atuais foram adicionados ao grupo, e todos os novos usuários serão adicionados a ele. O Gemini no Looker foi ativado automaticamente.
- Se a configuração for desativada em 9 de junho de 2025, todos os usuários precisarão ser adicionados ao grupo manualmente. O Gemini no Looker não foi ativado automaticamente.
O Gemini no Looker pode ser ativado ou desativado manualmente na página Gemini no Looker, na seção Plataforma do painel Administrador. O status dele não é afetado pelo status da configuração Ativação e gerenciamento de usuários automatizados do Gemini no Looker.
Formato de exportação padrão
Com a configuração Formato de exportação padrão, você escolhe o formato de arquivo padrão usado quando os usuários baixam dados. Os usuários ainda podem escolher um formato de arquivo diferente, se quiserem. Os seguintes formatos estão disponíveis:
| Formato | Extensão do arquivo | Descrição |
|---|---|---|
| TXT | .txt |
Gera um arquivo de texto delimitado por tabulações. |
| Planilha do Excel | .xlsx |
Gera um arquivo de planilha usando o formato do Microsoft Excel 2007 e versões mais recentes. |
| CSV | .csv |
Gera um arquivo de texto delimitado por vírgulas. |
| JSON | .json |
Gera um arquivo JSON com um registro por linha. |
| HTML | .html |
Gera HTML básico para mostrar os dados de maneira semelhante à exibida no navegador do usuário. No entanto, a formatação não é exatamente a mesma porque o CSS do Looker não será incluído. |
| Markdown | .md |
Gera um arquivo Markdown padrão com uma tabela delimitada por |. |