Elas refletem as sugestões que foram compartilhadas por uma equipe interfuncional de Lookers experientes. 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 elaboradas para a maioria dos usuários e situações, mas, como sempre, use o bom senso ao implementar as recomendações compartilhadas nesta página.
O que fazer no 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 usará uma relação de mesclagemmany_to_one
para todas as mesclagens em que uma relação não estiver definida. Para mais informações sobre como definir o parâmetrorelationship
corretamente, consulte a página "Práticas recomendadas" sobre como configurar o parâmetrorelationship
corretamente. - O que fazer: defina uma chave primária em cada visualização, incluindo tabelas derivadas. Todas as visualizações, derivadas ou vindas diretamente do banco de dados, precisam conter uma chave primária. Essa chave primária deve ser um valor exclusivo para permitir que o Looker identifique de forma exclusiva qualquer registro. Essa chave primária pode ser uma única coluna ou uma concatenação de colunas; ela só precisa ser um identificador exclusivo para a tabela ou tabela derivada.
-
O que fazer: nomear dimensões, medidas e outros objetos do LookML, usando letras minúsculas e sublinhados para espaços.
O parâmetro
label
pode ser usado para formatação adicional de um campo de nome, além de personalizar a aparência de nomes de visualizações, nomes de exploração e nomes de modelos. Por exemplo, no LookML a seguir, o parâmetrolabel
é usado para atribuir o rótulo Número de clientes à medidacustomer_count_distinct
.measure: customer_count_distinct { label: "Number of Customers" type: count_distinct sql: ${customer.id} ;; }
- O que fazer: use grupos de dados para alinhar a geração de tabelas derivadas persistentes (PDTs) e explorar o armazenamento em cache com processos ETL subjacentes. Os grupos de dados também podem ser usados para acionar entregas de painéis ou Looks para garantir que dados atualizados sejam enviados aos destinatários.
O que não fazer com o LookML
-
O que não fazer: use o parâmetro
from
para renomear visualizações em uma Análise. Use o parâmetroview_label
. Para saber mais sobre a diferença entrefrom
eview_label
, consulte a página de documentação do parâmetrofrom
(para Análises). O parâmetrofrom
deve ser usado principalmente nestas situações:- Mesclagens polimórficas (mesclar a mesma tabela várias vezes)
- Mesclagens automáticas (mesclar uma tabela com ela mesma)
- Redefinição do escopo de uma visualização estendida para o nome original dela
-
O que não fazer: usar a palavra "data" ou "tempo" em um nome de grupo de dimensões.
O Looker anexa cada período ao final do nome do grupo de dimensões. Isso significa que um grupo de dimensões chamado
created_date
resulta em campos chamadoscreated_date_date
,created_date_month
e assim por diante. Basta usarcreated
como o nome do grupo de dimensões, porque isso resulta em campos chamadoscreated_date
,created_month
e assim por diante. - O que não fazer: use carimbos de data/hora formatados em mesclagens. Em vez disso, use a opção prazo bruto para mesclar em qualquer campo de data ou hora. Isso evita a inclusão da conversão de transmissão e de fuso horário nos predicados de junção.