Muitos recursos do Looker voltados ao usuário precisam ser ativados por um administrador do Looker ou ter pré-requisitos específicos do administrador ou do desenvolvedor implementados antes que esses recursos sejam disponibilizados aos usuários do Looker. Esta página consolida esses recursos voltados ao usuário para facilitar a referência do administrador.
Encontrar conteúdo
A seção Pastas do menu de navegação principal do Looker inclui duas pastas específicas para administradores:
- Conteúdo não usado: mostra todos os Looks e painéis que não foram visualizados em um período selecionado.
- Lixeira: mostra os Looks e painéis que os usuários excluíram e que você pode recuperar.
Para saber mais sobre essas páginas, consulte a página de documentação Conteúdo excluído e não utilizado para administradores.
Criação de conteúdo
Esta seção inclui funcionalidades e dicas específicas para administradores ou desenvolvedores sobre como criar painéis, Looks e Análises detalhadas.
Como usar campos personalizados
O recurso Campos personalizados não é um recurso de segurança de dados. Outros usuários podem ver os campos personalizados em consultas compartilhadas, Looks e blocos do painel. Eles também podem usar a opção Analisar a partir daqui para criar novas consultas com esses campos.
Conceda permissão para criar campos personalizados se quiser permitir que alguns usuários empresariais realizem estas tarefas:
- Visualizar dados não modelados usando a análise instantânea do SQL Runner
- Criar medidas e dimensões semipermanentes para uma análise única ou pouco frequente
- Criar medidas e dimensões semipermanentes sem a necessidade de um analista
Como ativar campos personalizados
Para ativar os campos personalizados, um administrador do Looker precisa conceder a permissão create_custom_fields a usuários ou grupos para permitir o acesso ao recurso. A permissão create_custom_fields já faz parte de vários conjuntos de permissões padrão incluídos no Looker.
Campos personalizados e o modelo do LookML
Embora os campos personalizados dependam do modelo do LookML, eles não fazem parte da camada de modelagem e não aparecem em nenhum arquivo de visualização. Não é possível salvar ou converter um campo personalizado em um campo do LookML.
Considere usar campos personalizados em vez de LookML para campos que são necessários apenas temporariamente ou apenas pelos usuários mais sofisticados.
É possível criar um campo personalizado no SQL Runner
É possível usar campos personalizados para visualizar campos não modelados no SQL Runner, conforme descrito na página de documentação Usar o SQL Runner para criar consultas e análises detalhadas.
Como mudar as opções do seletor de campos usando o LookML
Para saber como um desenvolvedor do Looker pode usar o LookML para criar e modificar os campos disponíveis no seletor de campos, consulte a página Como alterar o menu "Explorar" e o seletor de campos.
Compartilhamento de conteúdo
Esta seção inclui funcionalidades e dicas específicas para administradores ou desenvolvedores sobre como enviar, fazer o download e compartilhar conteúdo.
Envio de conteúdo
Esta seção inclui funcionalidades e dicas específicas para administradores ou desenvolvedores sobre como enviar dados.
Formatos de entrega e download de JSON
O Looker usa o formato JSON – Label ao fazer o download de blocos de visualizações, análises detalhadas e consultas nos painéis.
O Looker usa os formatos JSON – Simple, JSON – Label, JSON – Simple, Inline e JSON – Detailed, Inline ao exibir análises e análises detalhadas. Os formatos JSON disponíveis dependem do destino selecionado. A opção de formato JSON – Label usa o rótulo de uma dimensão ou medida da visualização de dados como valor renderizado na saída JSON. Por exemplo:
{"rendered_label":"rendered_value"}
Outras saídas de formato JSON renderizam os nomes dos campos da seguinte maneira:
JSON – Rótulo: {"rendered_label":"rendered_value"} (usa o rótulo da visualização de dados)
JSON – Simples: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
JSON: simples, inline: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
JSON – Detalhado, Inline: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
Ao enviar Looks e Análises, se a opção Aplicar opções de visualização estiver selecionada, o Looker vai renderizar todos os formatos JSON disponíveis da seguinte maneira:
JSON – Rótulo: {"rendered_label":"rendered_value"} (usa o rótulo da visualização de dados)
JSON – Simples: {"rendered_label":"rendered_value"} (usa o rótulo da visualização de dados)
JSON: simples, inline: {"rendered_label":"rendered_value"} (usa o rótulo da visualização)
JSON – Detalhado, Inline: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
Consulte este aviso do Looker para mais informações.
Gerenciar o envio e a programação
Na seção Administrador do Looker, os administradores podem usar as páginas Planos do Programador e Histórico do Programador para procurar e resolver problemas de programação. Os administradores precisam ter cuidado ao excluir ou desativar um usuário que pode ser o proprietário de entregas programadas importantes, porque as programações também são excluídas ou desativadas.
Consulte a página de documentação Como configurar as entregas de conteúdo para mais informações sobre como os administradores do Looker gerenciam o acesso e o uso dos recursos de entrega de conteúdo do Looker pelos usuários.
Executar programação como destinatário
Essa opção, disponível para envios de conteúdo por e-mail, apresenta um comportamento exclusivo para o tipo de conteúdo que está sendo enviado. Para saber mais, consulte a documentação adequada para cada tipo de conteúdo:
Enviar e programar dados para destinos compatíveis com resultados transmitidos pelo Action Hub
O Looker hospeda e fornece um servidor sem estado, a central de ações do Looker, que implementa a API Action do Looker e expõe integrações (também chamadas de ações) populares.
Com o hub de ações do Looker, você pode enviar e programar dados do Looker para outras ferramentas de SaaS automaticamente. O envio ou agendamento de dados para destinos compatíveis com streaming ou que usam OAuth depende de consultas síncronas executadas entre o hub de ações do Looker e o servidor executável ou arquivo JAR. Para instâncias hospedadas pelo Looker, essas origens são configuradas para se comunicar.
Como armazenar impressões digitais do SFTP
Depois de se conectar a um servidor SFTP do Looker pelo menos uma vez para enviar ou fazer o download de dados, o Looker armazena uma impressão digital desse servidor SFTP.
Todas as impressões digitais do SFTP são mantidas no arquivo ~/.ssh/known-hosts no servidor do Looker.
Se a impressão digital mudar, isso significa que o servidor ao qual você está se conectando mudou a chave pública. Isso pode indicar que o servidor foi recriado ou está por trás de um balanceador de carga. Isso também pode indicar que você está sendo alvo de um ataque man-in-the-middle (MitM), em que o invasor está de alguma forma interceptando ou redirecionando sua conexão SSH para se conectar a um host diferente, o que pode ser um roubo de credenciais.
Como fazer o download de conteúdo
Esta seção inclui funcionalidades e dicas específicas para administradores ou desenvolvedores sobre como fazer o download de conteúdo.
Como fazer o download de conteúdo dos blocos do painel sem ter permissão para isso
Normalmente, um usuário precisa de um papel que inclua as permissões see_user_dashboards e download_with_limits ou download_without_limits para visualizar e fazer o download de dados dos blocos em um painel. No entanto, há uma condição em que um usuário pode acessar e fazer o download de dados de um modelo para o qual não tem essas permissões. Isso ocorre quando o seguinte é verdadeiro:
- Um painel tem blocos com base em consultas de mais de um modelo.
- Um usuário recebe uma função que inclui as permissões
see_user_dashboardsousee_lookml_dashboardsedownload_with_limitoudownload_without_limitem um dos modelos que servem de base para o painel. - O usuário tem uma segunda função que tem apenas a permissão
access_datapara outro modelo em que o painel é baseado.
Nesse caso, o usuário pode acessar e fazer o download de dados de todo o painel, incluindo blocos com base em modelos para os quais o usuário não tem permissão para acessar ou fazer o download de dados.
Considerações sobre formatos ou destinos de dados
Alguns formatos de dados têm peculiaridades que precisam ser consideradas ao usar o Looker para enviar ou fazer o download de conteúdo.
Renderizar imagens enviadas por e-mail
O recurso Imagens de e-mail fáceis de ler permite que o cliente de e-mail determine o tamanho ideal das imagens enviadas ou programadas no corpo dos e-mails. Se as imagens aparecerem distorcidas quando enviadas por e-mail, o cliente de e-mail dos usuários pode ser incompatível com esse recurso.
Enviar arquivos grandes no formato Excel
Para downloads ou envios de arquivos grandes do Excel (com mais de 5 GB), a tela de download ou envio pode congelar ou não ser possível abrir o arquivo enviado. Confira algumas condições que podem causar esse comportamento e como corrigir:
- A entrega de dados de arquivos grandes do Excel pode expirar durante o streaming. Nesse caso, tente enviar ou fazer o download dos dados no formato CSV, que pode ser importado para o Excel.
- Às vezes, os arquivos grandes do Excel são enviados, mas são muito grandes para abrir localmente. Nesse caso, divida a entrega de dados em arquivos CSV menores para que eles sejam carregados com sucesso pelo cliente de destino.
Como impedir a injeção de código malicioso em arquivos CSV
Os arquivos CSV podem conter macros que podem ser executadas no Microsoft Excel ou nas Planilhas Google. As macros podem ser usadas para injetar códigos maliciosos em arquivos CSV, o que representa um possível risco de segurança.
Para eliminar esse risco, os administradores do Looker podem solicitar uma atualização de licença que faz com que o Looker preencha qualquer valor em uma célula que possa ser um código executável. Quando essa opção está ativada, o Looker adiciona um caractere ' a qualquer valor de célula que comece com um caractere especial (=, -, + ou @) ao gerar um arquivo CSV. Isso desativa todas as macros nos arquivos CSV gerados pelo Looker.
Para atualizar sua licença para esse recurso, entre em contato com um especialista em vendas do Google Cloud ou abra uma solicitação de suporte.
Renderizar formatos de dados baseados em imagens para envio, programação ou download
O Looker usa o Chromium para renderizar estes formatos para suas entregas e downloads:
- Para painéis: PDF, visualização (somente para envio e programação)
- Para os Looks: visualização, HTML
- Para análises detalhadas (somente envio e download): PNG (imagem da visualização), HTML
Se a instância for hospedada pelo Looker, o Chromium já estará instalado.
Se a instância for hospedada pelo cliente, você precisará instalar a versão adequada do renderizador do Chromium.
O download de conteúdo em um formato renderizado pode exigir outras considerações sobre permissões.
Fazer o download de conteúdo renderizado
A maioria dos tipos de download considera os modelos associados às permissões de download do usuário ao determinar se um usuário pode fazer o download de um conteúdo. Em algumas circunstâncias, os usuários podem acessar e fazer o download de dados de um painel inteiro, incluindo blocos com base em modelos que não concedem a eles permissões para acessar ou fazer o download de dados.
Os downloads em formatos renderizados exigem apenas uma permissão de download para qualquer modelo associado ao conteúdo.
Compartilhamento público, importação e incorporação
Para permitir o acesso público aos URLs do Look, incluindo a capacidade de incorporar um Look, ative a opção URLs públicos na página Configurações gerais na seção Administrador.
Considere as implicações de segurança desse recurso antes de ativá-lo. Embora os URLs gerados pelo Looker não possam ser adivinhados ou pesquisados, qualquer pessoa com o URL pode acessar os dados. Qualquer pessoa que receber o URL pode compartilhá-lo com outra pessoa que não deveria ter acesso aos seus dados. Você precisa determinar os requisitos de privacidade dos dados em questão, avaliar seu nível de confiança em qualquer pessoa que receba um URL público e estabelecer claramente suas expectativas sobre se ele será compartilhado e, em caso afirmativo, como e com quem.
Como recuperar e criar gráficos com os dados
Esta seção inclui funcionalidades e dicas específicas para administradores ou desenvolvedores sobre como recuperar e gerar gráficos de dados.
Como melhorar as visualizações
Para conferir uma lista dos tipos de visualização nativa do Looker, consulte a página de documentação Tipos de visualização. Também é possível instalar e administrar visualizações JavaScript personalizadas, adicionar um parâmetro de visualização ao LookML para exibir em uma Análise detalhada ou instalar visualizações do Looker Marketplace.
Considerações sobre implantações hospedadas pelo cliente
Esta seção apresenta uma lista rápida de recursos que têm outras considerações para implantações do Looker hospedadas pelo cliente, com links para as seções relevantes desta página.
O envio e a programação de dados para destinos transmitidos podem exigir uma configuração diferente do Looker Action Hub para instâncias hospedadas pelo cliente.
Para enviar, programar ou fazer o download de alguns formatos de dados, os administradores de implantações hospedadas pelo cliente precisam instalar outros softwares para renderizar esses formatos.