Prática recomendada: o que fazer e o que não fazer no LookML

Essas práticas recomendadas refletem as sugestões que foram compartilhadas por uma equipe multifuncional de Lookers experientes. Esses insights são provenientes de anos de experiência trabalhando com clientes do Looker, desde a implementação até o sucesso em longo prazo. As práticas foram elaboradas para funcionar na maioria dos usuários e situações, mas, como sempre, use o bom senso ao implementar as recomendações compartilhadas nesta página.

dos do LookML

• O que fazer: defina o parâmetro relationship para todas as mesclagens.
  Isso garante que as métricas sejam agregadas corretamente no Looker. Por padrão, o Looker usa uma relação de agrupamento many_to_one para todas as mesclagens sem uma relação definida. Para mais informações sobre como definir o parâmetro relationship corretamente, consulte a página de práticas recomendadas sobre como usar o parâmetro relationship corretamente.
• O que fazer: defina uma chave primária em cada visualização, incluindo as tabelas derivadas.
  Todas as visualizações, sejam derivadas ou provenientes diretamente do banco de dados, precisam conter uma chave primária. Essa chave primária precisa ser um valor exclusivo para permitir que o Looker identifique de forma exclusiva qualquer registro. Essa chave primária pode ser uma coluna única ou uma concatenação de colunas; basta ser um identificador exclusivo da tabela ou da tabela derivada.
• O que fazer: nomeie dimensões, medidas e outros objetos LookML usando somente letras minúsculas e sublinhados para os espaços.
  O parâmetro label pode ser usado para formatação extra de um campo de nome e para personalizar a aparência dos nomes de visualizações, nomes das Análises e nomes dos modelos. Por exemplo, no LookML abaixo, o parâmetro label é usado para atribuir o rótulo Número de clientes à medida customer_count_distinct.

        measure: customer_count_distinct {
          label: "Number of Customers"
          type: count_distinct
          sql: ${customer.id} ;;
        }

• O que fazer: use datagroups para alinhar a geração de tabelas derivadas persistentes (TDPs) e explorar o armazenamento em cache com processos de ETL subjacentes. Os datagroups também podem ser usados para acionar envios de painéis ou Looks para garantir que dados atualizados sejam enviados aos destinatários.

O que não fazer no LookML

• Restrição: não use o parâmetro from para renomear visualizações em uma Análise.
  Em vez disso, use o parâmetro view_label. Para saber mais sobre a diferença entre from e view_label, consulte a página de documentação do parâmetro from (para Explores). O parâmetro from precisa ser usado principalmente nas seguintes situações:
  • Mesclagens polimórficas (entrar na mesma tabela várias vezes)
  • Mesclagens automáticas (como mesclar uma tabela a si mesma)
  • Redefinir o escopo de uma visualização estendida de volta ao nome original da visualização
• Restrição: não use a palavra "data" ou "hora" no nome de um grupo de dimensão.
  O Looker anexa cada período ao final do nome do grupo de dimensões. Isso significa que um grupo de dimensões com o nome created_date resulta em campos com os nomes created_date_date, created_date_month e assim por diante. Basta usar created como o nome do grupo de dimensões, porque isso resulta em campos chamados created_date, created_month e assim por diante.
• Restrição: não use carimbos de data/hora formatados em mesclagens.
  Em vez disso, use a opção prazo bruto para ingressar em qualquer campo de data ou hora. Isso evita a inclusão de conversão de fuso horário e transmissão nos predicados de mesclagem.