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

Essas práticas recomendadas refletem recomendações compartilhadas por uma equipe multidisciplinar de profissionais experientes do Looker. Esses insights vêm de anos de experiência trabalhando com clientes do Looker, desde a implementação até o sucesso a longo prazo. As práticas foram criadas para funcionar para a maioria dos usuários e situações, mas, como sempre, use seu melhor julgamento ao implementar qualquer uma das recomendações compartilhadas nesta página.

Fazer isso com o 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 mesclagem many_to_one para todas as mesclagens em que uma relação não está definida. Para mais informações sobre como definir o parâmetro relationship corretamente, consulte a página de práticas recomendadas sobre como definir o parâmetro relationship corretamente.
• O que fazer: defina uma chave primária em todas as visualizações, incluindo 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 que o Looker identifique de forma única qualquer registro. Essa chave primária pode ser uma única coluna ou uma concatenação de colunas. Ela simplesmente precisa ser um identificador exclusivo para a tabela ou tabela derivada.
• O que fazer: nomeie dimensões, medidas e outros objetos do LookML usando letras minúsculas e sublinhados em vez de espaços.
  O parâmetro label pode ser usado para formatar um campo de nome e personalizar a aparência de nomes de visualização, nomes de Explorar e nomes de modelos. Por exemplo, no LookML a seguir, 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 (PDTs, na sigla em inglês) e a análise de armazenamento em cache com os processos de ETL subjacentes. Os grupos de dados também podem ser usados para acionar as entregas de painéis ou Looks e garantir que os destinatários recebam dados atualizados.

Não faça isso com o LookML

• O que não fazer: use o parâmetro from para renomear visualizações em uma Análise detalhada.
  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 análises detalhadas). O parâmetro from deve ser usado principalmente nas seguintes situações:
  • Junções polimórficas (mesclagem da mesma tabela várias vezes)
  • Mesclagens automáticas (mesclar uma tabela com ela mesma)
  • Redefinir o escopo de uma visualização estendida para o nome original
• Não use: use a palavra "data" ou "hora" no nome de um grupo de dimensões.
  O Looker anexa cada período ao final do nome do grupo de dimensão, o que significa que um grupo de dimensão chamado created_date resulta em campos chamados, por exemplo, created_date_date e created_date_month. Basta usar created como o nome do grupo de dimensões, porque isso resulta em campos com nomes como created_date e created_month.
• Não: use carimbos de data/hora formatados nas mesclagens.
  Em vez disso, use a opção período bruto para mesclar em qualquer campo de data ou hora. Isso evita a inclusão de casting e conversão de fuso horário em predicados de mesclagem.