Definições de administrador – Definições gerais

A página Definições na secção Geral do painel Administração permite que os administradores do Looker configurem as definições ao nível da instância para o Looker. Algumas definições só estão disponíveis para instâncias do Looker (original) ou apenas para instâncias do Looker (Google Cloud core).

Definições

As seguintes definições estão disponíveis para instâncias do Looker.

Aplique a utilização do âmbito só de leitura do BigQuery

A ativação desta definição termina a sessão dos utilizadores que têm credenciais OAuth que permitem o âmbito de leitura e escrita em qualquer uma das ligações ao BigQuery. Quando os utilizadores se autenticam novamente, o Looker cria credenciais OAuth só de leitura para esses utilizadores. Consulte o artigo Restringir o âmbito do OAuth apenas para leitura para ligações do Google BigQuery para mais informações.

Chave da licença

A chave de licença é exclusiva da instância do Looker que está a usar. Ativa ou desativa determinadas funcionalidades do Looker com base no seu contrato de licenciamento.

Por predefinição, a chave de licença está oculta. Selecione o ícone de olho visibility para apresentar a chave de licença.

URL do anfitrião

O URL do anfitrião é a parte base do URL da sua instância do Looker. É usado especificamente quando são criados links para a sua instância em emails agendados e em todos os URLs absolutos que o Looker gera.

Certifique-se de que a definição URL do anfitrião usa http:// ou https:// adequadamente, com base na configuração do servidor da sua instância.

A alteração do URL do anfitrião pode afetar a funcionalidade de algumas funcionalidades do Looker. Consulte a secção O que acontece se o URL da minha instância do Looker mudar? Página de práticas recomendadas para mais informações sobre a alteração de URLs de instâncias.

Contactos técnicos

Os endereços de email adicionados a esta caixa recebem notificações de atualizações de segurança, correções de erros importantes e novas versões do Looker. O endereço de email tem de pertencer a um utilizador do Looker válido. Se adicionar um email que não pertença a um utilizador do Looker válido, por exemplo, um endereço de email para uma lista de distribuição, o endereço de email aparece no campo Contacto técnico, mas o Looker não consegue enviar notificações para este endereço.

O apoio técnico do Looker requer autorização de um contacto técnico para realizar qualquer uma das seguintes ações:

• Causar tempo de inatividade para a instância, o que pode dever-se a uma atualização da versão não agendada, a alterações de desempenho no seu servidor do Looker ou a outros motivos
• Alterar algo na sua licença do Looker, possivelmente para ativar novas funcionalidades.

Fuso horário da aplicação

Quando apresenta dados numa exploração, num Look ou num painel de controlo, o Looker pode converter dados de tempo do fuso horário da base de dados da ligação para o fuso horário adequado para esse utilizador.

Se a opção Fusos horários específicos do utilizador estiver ativada, um administrador pode definir o fuso horário predefinido do utilizador ou os utilizadores podem definir o respetivo fuso horário predefinido. Se o administrador ou o utilizador não tiver definido o fuso horário predefinido do utilizador, é usado o fuso horário da aplicação para esse utilizador, e todos os dados baseados em tempo consultados por esse utilizador são convertidos no fuso horário da aplicação.

A definição Fuso horário da aplicação também é usada como o fuso horário predefinido para envios de conteúdo. O fuso horário usado para agendamentos não afeta os dados de tempo devolvidos por uma consulta; afeta apenas a hora em que um fornecimento de dados é enviado.

Consulte a página de documentação Usar definições de fuso horário para mais informações.

Configuração de funcionalidades

As seguintes definições de configuração de funcionalidades estão disponíveis para instâncias do Looker.

Sistema fechado

A definição Sistema fechado é usada em conjunto com grupos para impedir que os utilizadores de um grupo saibam quem são os utilizadores de outro grupo. Isto é frequentemente útil para instalações multi-inquilino.

As localizações no Looker onde os utilizadores podem ver outros utilizadores incluem o seguinte:

• A página Utilizadores na secção Administração do Looker
• Pastas dos utilizadores na secção Pastas do menu principal do Looker, se lhes tiver sido concedido, pelo menos, acesso de visualização à pasta pessoal de outro utilizador
• O pop-up Gerir acesso, que faz parte da gestão de pastas

Quando a definição Sistema fechado está ativada, um utilizador não administrador sem a autorização see_users só pode ver os outros utilizadores com quem partilha um grupo e apenas os grupos dos quais é membro.

Os administradores e todos os utilizadores aos quais foi concedida a autorização see_users podem ver todos os utilizadores e grupos na instância.

Configuração do consentimento de início de sessão

Quando ativada, a configuração de consentimento de início de sessão faz com que seja apresentado um ecrã de consentimento a todos os utilizadores que tentem iniciar sessão na instância do Looker. O ecrã de consentimento apresenta a mensagem introduzida no campo Configuração da mensagem e exige que os utilizadores cliquem no botão Aceito no ecrã de consentimento antes de poderem iniciar sessão na instância. Depois de ativar a Configuração do consentimento de início de sessão, o campo Configuração da mensagem fica visível.

Configuração de mensagens

Se a opção Configuração de consentimento de início de sessão estiver ativada, no campo Configuração de mensagens, introduza a mensagem que vai ser apresentada a todos os utilizadores que tentarem iniciar sessão na instância do Looker. Este campo só fica visível depois de a configuração de consentimento de início de sessão estar ativada.

Pastas pessoais privadas predefinidas

Quando a opção Pastas pessoais privadas predefinidas está ativada, a pasta pessoal de um utilizador é, por predefinição, visível apenas para esse utilizador e para os administradores do Looker. Por predefinição, os outros utilizadores não veem a pasta na pasta Pessoas e o conteúdo na pasta não é visível nos painéis nem nas pesquisas de conteúdo.

Se quiser conceder acesso a uma pasta pessoal, pode adicionar acesso a outros utilizadores ou a grupos de utilizadores através da opção Gerir acesso no menu de roda dentada da pasta pessoal.

Se desativar a opção Pastas pessoais privadas predefinidas, a pasta pessoal de um utilizador pode ser vista por qualquer utilizador do Looker no grupo de utilizadores Todos os utilizadores.

Notificação de nova conta

A definição Notificação de nova conta pode ser ativada ou desativada. Quando está ativada, é enviado um email a todos os utilizadores administradores do Looker quando é criada uma nova conta do Looker. (Os utilizadores de incorporação assinada são uma exceção; os emails não são gerados quando um utilizador de incorporação assinada é criado.) O email vai conter o endereço de email do novo utilizador.

Guias na app

Os guias na app permitem que o Looker comunique com os utilizadores na aplicação através de tutoriais, faixas, alertas e inquéritos. Estas comunicações são usadas para ajudar os utilizadores a tirar maior partido da plataforma, alertá-los para novas funcionalidades, receber feedback dos utilizadores sobre a plataforma e convidá-los para formações e eventos onde podem aprender a usar melhor o Looker.

Os administradores podem optar por desativar os guias para a respetiva instância, o que desativa os guias para todos os utilizadores nessa instância. Não existe forma de desativar seletivamente os guias na app para determinados utilizadores. O Looker não apresenta guias na app a utilizadores incorporados nem a utilizadores que não sejam administradores em instâncias de marca privada.

Os guias são concebidos e implementados pela equipa de experiência do cliente do Looker e vão mudar ao longo do tempo. O Looker usa JavaScript de software de terceiros (Pendo) para publicar os guias. O Looker valida os guias individuais e adiciona-os à lista de autorizações. Ao obter um guia do Pendo, o Looker usa hashes de integridade SHA-256 para validar se o guia permanece inalterado. Se houver alterações ao guia após a revisão do Looker, o Looker impede a utilização do guia alterado. Se o navegador de um utilizador não conseguir aceder ao servidor do Pendo, o guia não é apresentado.

Admissão

Quando ativado, os administradores e os programadores do Looker que iniciam sessão numa nova instância do Looker veem o passo a passo de integração do Looker, que orienta os utilizadores através dos quatro passos principais para usar uma instância do Looker:

1. Adicionar uma associação
2. Criar um projeto
3. Editar ficheiros do projeto conforme necessário
4. Explorar dados

Quando qualquer combinação de administradores ou programadores conclui o guia completo, este deixa de ser apresentado.

A definição Guias na app tem de estar ativada para que a opção Integração esteja disponível.

Faixa de notificação de cookies

Quando ativada, esta definição apresenta uma faixa de notificação de cookies a todos os utilizadores na sua instância. Esta definição está desativada por predefinição.

Recomendamos que ative esta definição se a sua instância do Looker tiver de agir em conformidade com os regulamentos de proteção de dados da União Europeia.

Pesquisa organizada

Quando a Pesquisa organizada está ativada, um utilizador pode pesquisar conteúdo em pastas partilhadas, na respetiva pasta pessoal e em quadros. O conteúdo guardado nas pastas pessoais de outros utilizadores só é incluído nos resultados se também estiver fixado num painel. Os resultados da pesquisa excluem conteúdo que existe apenas nas pastas pessoais de outros utilizadores. Um utilizador tem a opção de excluir conteúdo em pastas pessoais selecionando o interruptor junto ao nome da funcionalidade Pesquisa organizada na caixa de diálogo modal de pesquisa.

Limite a opção de atualização automática do painel de controlo

Quando esta definição está ativada, apenas os administradores do Looker podem ativar a opção Atualizar automaticamente o painel de controlo em painéis de controlo definidos pelo utilizador. Isto impede que os utilizadores que não são administradores atualizem automaticamente os dados nos painéis de controlo e nos mosaicos dos painéis de controlo. A atualização automática dos dados do painel de controlo pode exercer uma pressão significativa em alguns sistemas de base de dados.

Número do projeto do Google Cloud

É necessário um Google Cloud número do projeto para ativar o apoio técnico na app. Este valor pode ser obtido na página de vista geral do Cloud na console_name_short.

Esta alteração pode demorar até duas horas a entrar em vigor. Para implementar a alteração imediatamente, clique no botão Atualizar junto à definição Chave de licença depois de introduzir o Google Cloud número do projeto.

Se ainda não tiver um Google Cloud projeto para o Looker, pode criar um seguindo o nosso guia de criação de Google Cloud projetos ou a nossa documentação mais detalhada sobre a criação e gestão de projetos.

Usar Gravatar

Quando ativada, esta definição apresenta a opção Imagem do perfil no menu do utilizador, permitindo que os utilizadores selecionem ou criem um avatar para a respetiva conta através da app Gravatar.

Fusos horários específicos do utilizador

Quando adiciona uma associação, especifica o fuso horário no qual a base de dados armazena informações de tempo como o fuso horário da base de dados.

Quando a opção Fusos horários específicos do utilizador está ativada, é atribuído um fuso horário a cada utilizador, e o Looker converte os dados baseados na hora do Fuso horário da base de dados no fuso horário de um utilizador quando este vê os resultados da consulta ou interpreta os filtros.

Quando a opção Fusos horários específicos do utilizador está desativada, o Looker converte os dados baseados na hora para todos os utilizadores no valor do Fuso horário da consulta.

Consulte a página de documentação Usar definições de fuso horário para mais informações.

Cores de visualização predefinidas

Cada instância do Looker tem de ter uma coleção de cores predefinida. A definição Cores de visualização predefinidas permite-lhe definir uma coleção de cores predefinida para visualizações e também criar novas coleções de cores para utilização nas suas instâncias. Pode selecionar uma coleção de cores existente ou criar uma coleção de cores personalizada.

Selecionar uma coleção de cores existente

Para definir uma coleção de cores existente como predefinição, escolha a coleção de cores no menu pendente e clique em Atualizar. Nota: a definição de uma nova coleção de cores predefinida atualiza todas as visualizações em Looks e painéis de controlo que usam a coleção de cores predefinida. As visualizações guardadas com uma coleção de cores diferente ou uma paleta personalizada não são afetadas.

Pode ver as primeiras paletas categóricas, sequenciais e divergentes de cada coleção diretamente no menu pendente. Estas são as paletas que vão ser usadas como predefinições de visualização. Para ver todas as paletas na coleção de cores, aceda à página de documentação Coleções de cores.

Criar uma coleção de cores personalizadas

Para criar uma coleção de cores personalizada, siga estes passos:

1. Selecione a última opção Nova coleção de cores no menu pendente da coleção Cores de visualização predefinidas.
2. Atribua um nome exclusivo à nova coleção no campo Nome.
3. Clique em cada paleta de cores para abrir o menu Cores na paleta.
4. 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.
5. Repita os passos 3 e 4 para cada paleta de cores.
6. Quando terminar de editar a nova coleção de cores, clique em Criar.

Os valores de cores podem ser formatados como strings hexadecimais, como #2ca6cd, ou como nomes de cores CSS, como mediumblue. Em alternativa, pode clicar no círculo cromático para abrir e selecionar um tom no seletor de cores. Se optar por editar todas as cores, use uma vírgula entre o nome de cada cor para as separar. Para adicionar ou remover uma cor, clique nos sinais + ou -.

A nova recolha torna-se automaticamente a predefinição da instância, mas pode escolher uma predefinição diferente, se quiser.

Os IDs das coleções e os IDs das paletas de quaisquer novas coleções de cores personalizadas baseiam-se no nome de cada coleção. Isto permite que os painéis de controlo do LookML que usam essas coleções sejam renderizados de forma consistente em todas as instâncias se ambas as instâncias tiverem as mesmas coleções personalizadas com nomes idênticos.

Eliminar uma coleção de cores personalizadas

Pode eliminar uma coleção de cores personalizadas selecionando a coleção no menu pendente e clicando no botão Eliminar apresentado. Não pode eliminar as coleções de cores incorporadas do Looker.

Carregue recursos da RFC

Esta opção só está disponível para instâncias alojadas pelo cliente. Uma vez que as instâncias alojadas no Looker carregam sempre recursos da RFC, não pode desativar esta definição para estas instâncias.

RFC significa rede de fornecimento de conteúdo. Uma RFC é uma rede de servidores que armazena conteúdo em várias localizações geográficas para reduzir o tempo de carregamento das páginas para os utilizadores. Os seus dados nunca são armazenados nestes servidores. Apenas os itens específicos do Looker (como imagens) são armazenados na RFC.

A definição Carregar recursos da RFC pode ser ativada ou desativada. Quando está ativada, as páginas do Looker devem ser carregadas mais rapidamente.

Manter recursos na cache do navegador

Quando esta definição está ativada, os recursos estáticos, como os ficheiros JavaScript e os tipos de letra, são colocados em cache no armazenamento do navegador de cada utilizador. Isto acelera as navegações subsequentes, porque o navegador não precisa de continuar a recarregar estes recursos a partir do servidor do Looker.

Acesso a aplicações para dispositivos móveis

Quando esta definição está ativada, os utilizadores podem iniciar sessão na respetiva conta do Looker na instância através da app Looker para dispositivos móveis e da app Looker (Legacy). Quando esta definição está desativada, todas as sessões para dispositivos móveis existentes são terminadas.

Forçar autenticação por dispositivo móvel

Quando esta definição está ativada, os utilizadores têm de iniciar sessão na app Looker para dispositivos móveis e na app Looker (Legacy) sempre que abrem a app no respetivo dispositivo móvel.

Além disso, os utilizadores terminam sessão na app para dispositivos móveis após 60 minutos de inatividade.

Política de Dados

As seguintes definições da política de dados estão disponíveis para instâncias do Looker.

URLs públicos

A definição URL público pode ser ativada ou desativada. Quando esta definição está ativada, os utilizadores do Looker com as autorizações adequadas podem gerar URLs públicos para aceder aos dados do Looker.

Lista de autorizações de domínios de email para conteúdo agendado

Esta definição permite que os administradores do Looker definam os domínios de email para os quais os utilizadores podem enviar conteúdo do Looker (aparências, painéis de controlo, consultas com visualizações) ou notificações de alertas por email.

Para limitar os envios de conteúdo e as notificações de alerta a endereços de email com um domínio específico, pode introduzir o domínio no formato domain.suffix. Por exemplo, para limitar as entregas de email apenas a emails com os domínios gmail.com e friendly_domain.org, pode especificar estes domínios no campo Lista de autorizações de domínios de email para conteúdo agendado e, em seguida, conceder aos utilizadores a autorização schedule_look_emails.

Consulte mais informações sobre como esta definição e as autorizações de um utilizador afetam a respetiva capacidade de fornecer conteúdo do Looker e notificações de alertas na secção Vista geral das autorizações nesta página.

Atributo do utilizador looker_internal_email_domain_allowlist

Além dos domínios de email incluídos no campo global Lista de autorizações de domínios de email para conteúdo agendado, também pode especificar domínios de email ao nível do grupo através do looker_internal_email_domain_allowlist atributo do utilizador. O atributo de utilizador aceita o mesmo formato de string que a definição de administrador Lista de autorizações de domínios de email para conteúdo agendado.

Se um grupo tiver vários conjuntos de domínios de email atribuídos, por exemplo, através da associação a vários grupos, os membros desse grupo vão poder enviar emails para todos os domínios atribuídos a cada um dos valores dos atributos do utilizador, bem como para os domínios listados na definição de administração da lista de autorizações de domínios de email para conteúdo agendado. Por outras palavras, o conjunto de domínios de email para os quais um grupo pode enviar emails é a união do conjunto de domínios de email que estão listados no campo Lista de autorizações de domínios de email para conteúdo agendado e todos os conjuntos de domínios de email que são atribuídos ao grupo pelo atributo de utilizador looker_internal_email_domain_allowlist.

Vista geral das autorizações

Os utilizadores incorporados e não incorporados têm de ter, pelo menos, a autorização schedule_look_emails para poderem enviar por email qualquer conteúdo do Looker. Para enviar notificações de alerta, um utilizador também tem de ter autorizações create_alerts.

Os utilizadores incorporados e não incorporados que tenham a autorização schedule_look_emails também podem receber a autorização schedule_external_look_emails (consulte mais informações sobre autorizações e dependências na página de documentação Funções).

Para uma vista geral de como as autorizações dos utilizadores afetam os domínios para os quais os utilizadores podem enviar entregas de conteúdo do Looker ou notificações de alertas, consulte a tabela seguinte:

O conteúdo do Looker incorporado é acedido através de uma conta de utilizador de incorporação dedicada e não através de contas de utilizador individuais. Quando uma pessoa acede ao conteúdo do Looker através de uma incorporação, não se espera que o Looker saiba o endereço de email do utilizador individual.

Uma exceção às regras estipuladas na tabela é a seguinte: pode fornecer ao Looker o endereço de email de um utilizador incorporado definindo-o no email atributo do utilizador no URL de incorporação assinado. Por exemplo:

...&user_attributes={"email":"joe@domain.com"}

Se definir o atributo de utilizador email no URL incorporado, o Looker permite que um utilizador incorporado que tenha apenas a autorização schedule_look_emails envie conteúdo do Looker por email para o seu próprio endereço de email, mesmo que o respetivo domínio de email não esteja no campo Lista de autorizações de domínios de email para conteúdo agendado ou se o campo Lista de autorizações de domínios de email para conteúdo agendado estiver em branco.

Lista de autorizações de URLs para ações de dados

Esta definição permite-lhe definir URLs (como https://looker.com) onde os utilizadores podem processar ações de dados.

Por exemplo, se adicionar o URL https://looker.com à lista de autorizações de URLs para ações de dados, as ações de dados só podem ser processadas em https://looker.com. As tentativas de processar ações de dados noutros URLs não são permitidas.

Se este campo for deixado em branco, não existem restrições de URL para ações de dados. No entanto, se tiver incluído um atributo do utilizador numa ação de dados, este campo é obrigatório. Nesse caso, tem de fornecer URLs válidos para processar ações de dados.

Bloquear imagens incorporadas inline nos resultados da consulta

Por predefinição, o Looker não apresenta imagens codificadas em Base64 nos resultados da consulta. Desative esta definição para apresentar imagens codificadas em base64 nos resultados da consulta.

Bloquear fórmulas e macros em ficheiros CSV e Excel

Quando esta definição está ativada, o Looker antepõe um caráter ' a todos os valores que podem ser interpretados como fórmulas ou macros em consultas transferidas nos formatos de folhas de cálculo CSV ou Excel.

Token de webhook de saída

Se um utilizador usar um webhook para fornecer conteúdo, como um painel de controlo ou um Look, o pedido vai incluir um token do Looker especial que pode ser definido aqui. Os servidores que recebem webhooks podem, em seguida, validar se os pedidos contêm este valor para validar a legitimidade dos pedidos de webhook. Para repor o token, clique em Repor.

Ativação e gestão de utilizadores automatizadas do Gemini no Looker

Foi criado automaticamente um novo grupo de utilizadores denominado Utilizadores predefinidos do Gemini para todas as instâncias do Looker (original) que usam uma configuração de sistema aberta. Os utilizadores neste grupo têm a Gemini atribuída, o que lhes concede a capacidade de usar as funcionalidades do Gemini no Looker.

O estado da definição Ativação automática do Gemini no Looker e gestão de utilizadores afeta o grupo da seguinte forma:

• Se ativar a definição:
  • Os novos utilizadores adicionados à instância são adicionados automaticamente ao grupo.
• Se desativar a definição:
  • Os novos utilizadores adicionados à instância têm de ser adicionados manualmente ao grupo.
  • Se quiser remover membros do grupo Utilizadores predefinidos do Gemini, tem de os remover manualmente.

O estado da definição a partir de 9 de junho de 2025 tem os seguintes efeitos:

• Se a definição foi ativada antes de 9 de junho de 2025, todos os utilizadores existentes foram adicionados ao grupo e todos os novos utilizadores vão ser adicionados ao grupo. O Gemini no Looker foi ativado automaticamente.
• Se a definição tiver sido desativada a 9 de junho de 2025, todos os utilizadores têm de ser adicionados manualmente ao grupo. 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 secção Plataforma do painel Administração. O respetivo estado não é afetado pelo estado da definição Ativação e gestão de utilizadores do Gemini automatizado no Looker.

Formato de exportação predefinido

A definição Formato de exportação predefinido permite-lhe escolher o formato de ficheiro predefinido que é usado quando os utilizadores optam por transferir dados. Os utilizadores podem continuar a escolher um formato de ficheiro diferente, se quiserem. Estão disponíveis os seguintes formatos: