Muitos recursos voltados ao usuário do Looker precisam ser ativados por um administrador do Looker ou ter pré-requisitos específicos do desenvolvedor ou do administrador do Looker implementados antes que esses recursos possam ser disponibilizados para os usuários do Looker. Esta página consolida esses recursos voltados ao usuário para facilitar a referência do administrador.
Como encontrar conteúdo
O menu Procurar do Looker inclui duas páginas específicas para administradores do Looker:
- Conteúdo não usado: mostra todos os painéis e aparências que não foram visualizados em um período selecionado.
- Lixeira: mostra as aparências e os painéis que os usuários excluíram e que podem ser recuperados.
Veja mais detalhes sobre as páginas de documentação Conteúdo excluído e não usado para administradores.
Criação de conteúdo
Esta seção inclui dicas e funcionalidades específicas para administradores ou desenvolvedores e como criar painéis, aparências e explorações.
Usar campos personalizados
Os campos personalizados são um recurso do Labs e podem mudar ou ser removidos do produto.
Além disso, o recurso Campos personalizados não é um recurso de segurança de dados. Os outros usuários podem ver os campos personalizados nas consultas compartilhadas, na aparência e nos blocos do painel. Também é possível usar Explorar daqui para criar novas consultas com esses campos.
Ative os campos personalizados se quiser permitir que alguns dos seus usuários comerciais:
- Visualizar dados não modelados usando o Instant Explore 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:
- Ative o laboratório de campos personalizados.
- Conceda a permissão
create_custom_fieldsa usuários ou grupos para conceder acesso ao recurso. A permissãocreate_custom_fieldsjá faz parte de vários conjuntos de permissões padrão que estão incluídos no Looker.
Campos personalizados e o modelo LookML
Embora os campos personalizados dependam do modelo 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 LookML.
Considere usar campos personalizados em vez de LookML para campos que são necessários apenas temporariamente ou apenas pelos seus usuários mais sofisticados.
Criar um campo personalizado no SQL Runner
É possível usar os campos personalizados para visualizar campos não modelados no SQL Runner, conforme descrito na página de documentação Como usar o SQL Runner para criar consultas e explorações.
Como alterar as opções do seletor de campo usando o LookML
Para saber várias maneiras de um desenvolvedor do Looker usar o LookML para criar e modificar os campos disponíveis no seletor de campo, consulte a página Como alterar o menu "Explorar" e o seletor de campo.
Compartilhar conteúdo
Esta seção inclui dicas e recursos específicos do administrador ou do desenvolvedor para enviar, fazer o download e compartilhar conteúdo.
Envio de conteúdo
Esta seção inclui dicas específicas do administrador ou do desenvolvedor e dicas para enviar.
Formatos de entrega e download em JSON
O Looker usa o formato JSON – Rótulo ao fazer o download de aparências, explorações e consultas de blocos em painéis.
O Looker usa os formatos JSON – Simples, JSON – Rótulo, JSON – Simples, in-line e JSON – Detalhado e in-line ao fornecer aparências e explorações. Os formatos JSON disponíveis dependem do destino selecionado. A opção de formato JSON – Rótulo usa um rótulo de 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 nomes de campo 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, in-line: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
JSON – Detalhado e in-line: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
Ao fornecer aparências e explorações, se a opção Aplicar opções de visualização estiver selecionada, o Looker renderizará os formatos JSON disponíveis na exibição 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 rótulo da visualização de dados)
JSON – Simples, in-line: {"rendered_label":"rendered_value"} (usa o rótulo da visualização)
JSON – Detalhado e in-line: {"view.field_name":"rendered_value"} (usa o nome do campo da tabela de dados)
Consulte este aviso do Looker para ver mais informações.
Como 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 devem ter o cuidado de excluir ou desativar um usuário que possa 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 envios de conteúdo para mais informações sobre como os administradores do Looker gerenciam usuários e acessam os recursos de entrega de conteúdo do Looker.
Executar programação como destinatário
Essa opção, disponível para envio de conteúdo por e-mail, exibe um comportamento único em relação ao tipo de conteúdo exibido. Para saber mais, consulte a documentação apropriada para cada tipo de conteúdo:
- Enviar painéis que usam a nova experiência do painel
- Como exibir painéis legados
- Ofereça visuais e explorações
Enviar e agendar dados para destinos compatíveis com os resultados transmitidos por meio do hub de ações
O Looker hospeda e fornece um servidor sem estado, o Looker Action Hub, que implementa a API Action do Looker e expõe integrações conhecidas, também chamadas de ações.
Com o Looker Action Hub, você pode enviar e agendar dados automaticamente no Looker para outras ferramentas SaaS. O envio ou a programação de dados para destinos que oferecem suporte a streaming ou que usam OAuth dependem de consultas síncronas entre o Looker Hub de ações do Looker e o servidor executável ou JAR. Para instâncias hospedadas pelo Looker, essas origens são configuradas para se comunicar.
Para usar as integrações do Looker, o hub de ações do Looker precisa se comunicar com a instância do Looker e atender a estes requisitos. Os administradores de instâncias hospedadas pelo cliente talvez precisem considerar outros fatores ao ativar as integrações do Looker no Hub de ações do Looker, especialmente integrações que oferecem suporte a resultados transmitidos ou que usam o OAuth.
Armazenamento de impressões digitais SFTP
Depois que você se conectar a um servidor SFTP pelo Looker pelo menos uma vez para fornecer ou fazer o download de dados, o Looker armazenará uma impressão digital desse servidor.
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 alterou a chave pública. Isso pode indicar que o servidor foi recriado ou está protegido por 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á interceptando ou redirecionando sua conexão SSH para se conectar a um host diferente, o que pode estar roubando suas credenciais.
Fazendo o download de conteúdo
Esta seção inclui dicas e recursos específicos para administradores ou desenvolvedores para fazer o download de conteúdo.
Download de conteúdo de blocos do painel sem fazer o download de permissões
Normalmente, um usuário exige um papel que inclui as permissões see_user_dashboards e download_with_limits ou download_without_limits para ver e fazer o download de dados dos blocos em um painel. No entanto, há uma condição em que um usuário pode ver e fazer o download de dados de um modelo ao qual ele não tem essas permissões. Ela ocorre quando o seguinte é verdadeiro:
- Um painel tem blocos baseados em consultas de mais de um modelo.
- Um usuário recebe um papel que inclui as permissões
see_user_dashboardsousee_lookml_dashboardsedownload_with_limitoudownload_without_limita um dos modelos em que o painel é baseado. - O usuário tem um segundo papel que tem apenas a permissão
access_datapara outro modelo em que o painel é baseado.
Nesse caso, o usuário pode ver e fazer o download de dados de todo o painel, incluindo blocos com base em modelos aos quais o usuário não tem permissões para ver ou fazer o download de dados.
Considerações sobre formatos ou destinos de dados
Alguns formatos de dados têm peculiaridades a serem consideradas ao usar o Looker para exibir 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 de imagem enviada ou programada para o corpo dos e-mails. Se as imagens aparecerem distorcidas quando entregues por e-mail, o cliente de e-mail dos seus usuários poderá ser incompatível com esse recurso.
Envio de arquivos grandes no formato Excel
Em downloads ou entregas de arquivos grandes do Excel (arquivos com mais de 5 GB), a tela de download ou entrega pode parecer congelada ou você pode não conseguir abrir o arquivo enviado. Veja algumas condições que podem causar esse comportamento e como você pode corrigi-lo:
- As entregas de dados grandes em arquivos do Excel podem 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, arquivos grandes do Excel são enviados, mas são muito grandes para serem abertos localmente. Nesse caso, divida a entrega de dados em arquivos CSV menores para que eles sejam carregados pelo cliente de destino.
Como evitar a injeção de código malicioso em arquivos CSV
Os arquivos CSV podem conter macros executadas no Microsoft Excel ou no Planilhas Google. É possível usá-las para injetar código malicioso em arquivos CSV, tornando os arquivos CSV um possível risco de segurança.
Para remover esse risco, os administradores do Looker podem solicitar uma atualização de licença que faça com que o Looker preencha qualquer valor em uma célula que possa ser código executável. Quando ativado, o Looker adicionará 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 a licença desse recurso, entre em contato com seu gerente de contas ou abra uma solicitação de suporte na Central de Ajuda do Looker e clique em Fale conosco.
Renderização de formatos de dados baseados em imagem para envio, programação ou download
O Looker usa o Chromium para renderizar estes formatos para seus envios e downloads:
- Para painéis: PDF, visualização (somente para envio e programação)
- Para aparência: visualização, HTML
- Para "explores" (somente envio e download): PNG (imagem de visualização), HTML.
Caso sua instância seja hospedada pelo Looker, o Chromium já estará instalado.
Caso sua instância seja hospedada pelo cliente, você precisará instalar a versão apropriada do renderizador do Chromium.
Não importa se a instância é hospedada pelo Looker ou pelo cliente, é possível reduzir o tempo de renderização de downloads ou entregas de PDF para painéis que contêm visualizações de tabela com muitas linhas. Basta ativar o recurso de laboratório Renderizar tabelas longas.
O download de conteúdo em um formato renderizado pode exigir considerações adicionais sobre permissões.
Fazer o download de conteúdo no formato 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 ver e fazer o download de dados em um painel inteiro, incluindo blocos com base em modelos que não concedem a esses usuários permissões para ver 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 a URLs de visualização, incluindo a possibilidade de incorporar uma aparência, você precisa ativar os URLs públicos na página Configurações gerais:
Considere as implicações de segurança desse recurso antes de ativá-lo. Embora os URLs que o Looker gera não possam ser adivinhados ou pesquisados, qualquer pessoa com o URL pode ver os dados. Qualquer pessoa que receber o URL poderá compartilhá-lo com outra pessoa que não teve 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 quanto ao compartilhamento e com quem.
Recuperar e gerar gráficos com dados
Esta seção inclui funcionalidades específicas do administrador ou do desenvolvedor e dicas para recuperar e gerar gráficos de dados.
Como melhorar as visualizações
Para ver 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 ser exibido em um Explore 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 considerações adicionais sobre implantações do Looker hospedadas pelo cliente, com links para as seções relevantes nesta página.
O envio e a programação de dados para destinos transmitidos podem exigir diferentes configurações do Hub de ação do Looker 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 outro software para renderizar esses formatos.