Referência do parâmetro LookML por função

Visão geral

LookML é a linguagem que o Looker usa para descrever dimensões, agregações, cálculos e relações de dados em um banco de dados SQL, além de construir consultas SQL nele. Consulte a página de documentação Etapas para aprender o LookML.

Use esta página de referência para identificar como os parâmetros LookML podem ajudar você a alcançar os efeitos de modelagem de dados que quiser. Essa referência também pode ser útil se você estiver analisando um modelo atual e quiser saber o que cada parâmetro está fazendo. Você também pode acessar páginas de referência específicas das estruturas relevantes do LookML: modelo, visualização, Explorar, mesclar, manifesto ou campos.

Para ver uma introdução a essas estruturas LookML e como elas se relacionam, consulte a página de documentação Termos e conceitos da LookML. Na parte inferior desta página, você encontra links para recursos adicionais que ajudam a identificar, entender e implementar elementos LookML.

Como ler esta referência

Nesta página, os parâmetros são organizados pelas diferentes funções que podem desempenhar e os diferentes efeitos que podem ser obtidos com eles.

A entrada da tabela em cada seção lista:

Nome do parâmetro Nível Descrição
Nome e link para a página de documentação principal do parâmetro Nível no qual o parâmetro é aplicado, com um link para uma lista de todos os outros parâmetros disponíveis nesse nível: modelo, visualização, Explorar, mesclar, manifesto ou campos. Alguns parâmetros podem ser usados em vários níveis no LookML. Breve descrição da função do parâmetro e se ele pode ter subparâmetros

Alguns parâmetros no nível do campo podem ser usados com vários tipos. Portanto, nesta página, marcamos cada parâmetro no nível do campo com ícones que indicam os tipos com que ele pode ser usado. Passe o cursor sobre um ícone para ver o nome dele ou clique nele para ver uma página de referência para esse tipo de campo.

D = Dimensão DG = Grupo da dimensão F = Filtro M = Medir P = Parâmetro


Parâmetros estruturais

Esses parâmetros LookML afetam a estrutura de um projeto ou os arquivos subjacentes.

Principais parâmetros estruturais em um modelo ou um arquivo de exploração

Conforme mostrado na página de documentação de Termos e conceitos do LookML, um projeto contém um ou mais arquivos de modelo, que usam parâmetros para definir um modelo e as explorações e mesclagens dele.

Nesta seção, descrevemos os principais parâmetros estruturais que você normalmente coloca em um arquivo de modelo. Eles funcionam como a estrutura para todos os outros parâmetros. Um parâmetro explore geralmente é definido no nível superior de um arquivo de modelo, mas quando você usa uma tabela derivada nativa, ela pode ser definida em um arquivo de exploração.

Nome do parâmetro Nível Descrição
explore Modelo expõe uma visualização no menu "Explorar". Para mais informações sobre o recurso "Explorar" e os parâmetros deles, consulte a página de referência Parâmetros de exploração. Afeta o nome e o menu Explorar. Esse parâmetro tem muitos subparâmetros listados na página de referência Explorar parâmetros e em outras partes desta página.
fields Explorar Limita os campos disponíveis em uma exploração a partir da visualização base e das junções da exploração. Afeta os campos disponíveis no seletor de campo.
include Modelo Adiciona arquivos a um modelo. Esse parâmetro também pode ser usado em arquivos de visualização para tabelas derivadas nativas.
join Participar Mescla outra visualização em "Explorar". Consulte também a seção Como participar de visualizações abaixo.
test Modelo Cria um teste de dados para verificar a lógica do seu modelo. As configurações do projeto incluem uma opção para exigir testes de dados. Quando esse recurso está ativado em um projeto, os desenvolvedores precisam executar testes de dados antes de implantar as alterações na produção. Este parâmetro tem os subparâmetros explore_source e assert.

Principais parâmetros estruturais em um arquivo de visualização

Conforme mostrado na página de documentação de Termos e conceitos do LookML, um projeto contém um ou mais arquivos de visualização, que usam parâmetros para definir essa visualização, os campos (incluindo dimensões e medidas) e os conjuntos de campos dela.

Esta seção descreve os principais parâmetros estruturais que você normalmente coloca em um arquivo de visualização.

Nome do parâmetro Nível Descrição
dimension Visualizar (mas listado na página de referência do campo) Cria um campo de dimensão. Afeta o comportamento padrão do seletor de campo.
dimension_group Visualizar (mas listado na página de referência do campo) Cria várias dimensões com base no tempo ao mesmo tempo. Afeta o comportamento padrão do seletor de campo.
fields Participar Determina quais campos de uma mesclagem são trazidos para uma exploração
measure Visualizar (mas listado na página de referência do campo) Cria um campo de medida. Afeta o comportamento padrão do seletor de campo.
view Modelo (usado no arquivo de visualização) Cria uma visualização. Afeta o comportamento padrão do seletor de campo. Esse parâmetro tem muitos subparâmetros listados na página de referência Ver parâmetros e em outras partes da página atual.

Parâmetros estruturais auxiliares

Esses parâmetros ajudam você a definir o comportamento estrutural desejado, como permitir que você especifique conjuntos de campos, incluir determinados arquivos (e o conteúdo deles), definições de reutilização e assim por diante.

Nome do parâmetro Nível Descrição
+ (refinamentos) Explorar e Ver Use refinamentos do LookML para aproveitar o LookML de visualizações e explorações nos seus projetos.
constant Manifesto Define uma constante LookML que pode ser usada em todo o projeto. Este parâmetro tem os subparâmetros value e export.
extends Explorar e Ver Reutiliza a definição de outro objeto LookML, adicionando e modificando subparâmetros como você quiser. Esse parâmetro também pode ser usado com painéis LookML.
extension Explorar e Ver Especifica que um painel "Explorar", uma visualização ou um painel não pode ser usado diretamente. Em vez disso, a definição é destinada a um modelo para outros objetos, que usam extensões com base nesse objeto. Esse parâmetro também pode ser usado com painéis.
include Modelo Adiciona arquivos a um modelo. Esse parâmetro também pode ser usado em arquivos de visualização para tabelas derivadas nativas.
intervals Campos: DG Defina o conjunto de dimensões de duração que você quer em uma dimension_group para grupos de dimensões configurados como type: duration. Afeta o comportamento padrão do seletor de campo.
local_dependency Manifesto Especifica um ou mais projetos que contêm arquivos que você quer incluir
parameter Visualizar (mas listado na página de referência do campo) Cria um campo somente com filtro que os usuários podem usar para fornecer entradas a uma tag {% parameter %} líquida. Afeta o comportamento padrão do seletor de campo.
project_name Manifesto Especifica o nome do projeto atual
remote_dependency Manifesto Especifica um ou mais repositórios remotos que contêm os arquivos que você quer incluir
set Ver Define um conjunto de dimensões e medidas a serem usadas em outros parâmetros. Esse parâmetro pode ser usado para limitar os campos disponíveis a uma mesclagem e, portanto, ao seletor de campo. Esse parâmetro também pode ser usado para definir quais campos devem aparecer quando um usuário detalha os dados. Este parâmetro tem um subparâmetro fields.
timeframes Campos: DG Define o conjunto de dimensões de período que você quer em uma dimension_group para grupos de dimensões configurados como type: time. Afeta o comportamento padrão do seletor de campo.

Aplicativos do framework de extensão

Os desenvolvedores do Looker podem adicionar um aplicativo ao framework de extensão do Looker usando o parâmetro application no arquivo de manifesto de um projeto. Depois que uma extensão é adicionada a um projeto, os usuários do Looker com as permissões adequadas podem ver a extensão listada no menu Procurar do Looker.

Se o administrador tiver ativado o recurso Relatórios de navegação aprimorado, as extensões serão listadas na seção Aplicativos do novo painel de navegação avançado à esquerda.

Nome do parâmetro Nível Descrição
application Manifesto Adiciona um aplicativo ao projeto usando o framework de extensão do Looker. Esse parâmetro tem subparâmetros descritos na página de documentação do parâmetro application.

Confira o nome e o cardápio

O nome e a aparência do recurso Explorar no menu Explorar ajudam seus usuários a escolher a opção ideal. Esses parâmetros LookML afetam o comportamento padrão do nome e da aparência de um Explorar no menu Explorar.

Veja mais informações na seção Explorar nome e menu da página de documentação Como alterar o menu "Explorar" e o seletor de campo.

Comportamento padrão

O comportamento padrão do nome e a aparência dele em "Explorar" é especificado pelos parâmetros listados abaixo.

Nome do parâmetro Nível Descrição
explore Modelo expõe uma visualização no menu "Explorar". Para mais informações sobre o recurso "Explorar" e os parâmetros deles, consulte a página de referência Parâmetros de exploração. Afeta o nome e o menu Explorar.

Como modificar o nome e o menu "Explorar"

O nome e a forma como ele aparece no menu "Explorar" podem ser modificados pelos parâmetros na tabela abaixo.

Nome do parâmetro Nível Descrição
description Explorar Adiciona uma descrição para um recurso Explorar que aparece para os usuários na página Explorar e no menu Explorar
group_label Explorar Cria um rótulo para usar como título no menu "Explorar".
hidden Explorar Oculta uma exploração no menu Explorar
label Explorar Muda a forma como o recurso Explorar aparece no menu "Explorar"
label Modelo Muda a forma como um modelo aparece no menu "Explorar"

Seletor de campo

A organização e os nomes de exibição das visualizações e dos campos no seletor de campo podem ajudar os usuários a entender as visualizações e encontrar os campos necessários em "Explorar". Esses parâmetros LookML afetam o comportamento padrão do conteúdo, da aparência e da organização do seletor de campo.

Veja mais informações na seção Seletor de campo da página de documentação Como alterar o menu "Explorar" e o seletor de campo.

Comportamento padrão

A aparência e o comportamento padrão do seletor de campo são especificados pelos parâmetros listados abaixo. Para ver uma explicação completa desse comportamento padrão, consulte a seção Exibição do seletor de campo na página da documentação Alterar o menu "Explorar" e o seletor de campo.

Nome do parâmetro Nível Descrição
dimension Visualizar (mas listado na página de referência do campo) Cria um campo de dimensão.
dimension_group Visualizar (mas listado na página de referência do campo) Cria várias dimensões com base no tempo ao mesmo tempo.
filter Visualizar (mas listado na página de referência do campo) Cria um campo somente de filtro para ser usado em um filtro de modelo ou mesclagem condicional.
measure Visualizar (mas listado na página de referência do campo) Cria um campo de medida.
parameter Visualizar (mas listado na página de referência do campo) Cria um campo somente de filtro que os usuários podem usar para fornecer entradas a uma tag {% parameter %} líquida
timeframes Campos: DG Define o conjunto de dimensões de período que você quer em uma dimension_group para grupos de dimensões configurados como type: time.
intervals Campos: DG Define o conjunto de dimensões de duração que você quer em uma dimension_group para grupos de dimensões configurados como type: duration.
view Modelo (mas listado na página de referência de visualização) Cria uma visualização.

Como modificar os nomes de visualização no seletor de campo

O nome de exibição de uma visualização pode ajudar os usuários a entender e encontrar os campos necessários em "Explorar". Se uma visualização mostrar o nome dela, modifique a forma como ele aparece para ajudar os usuários a entendê-la. Esta seção descreve os parâmetros LookML que afetam os nomes de visualização no seletor de campo. Para ver uma explicação completa sobre esse tópico, consulte a seção Seletor de campo da página de documentação Alterar o menu "Explorar" e o seletor de campo.

Nome do parâmetro Nível Descrição
label Ver Especifica como o nome da visualização aparecerá no seletor de campo.
view_label Explorar Especifica como um grupo de campos da visualização base do Explorar será rotulado no seletor de campo.
view_label Participar Altera a forma como o nome da visualização da mesclagem aparece no seletor de campo.

Modificar as informações dos campos no seletor de campo

Quando você modifica a forma como os campos são listados, os usuários podem entender as visualizações e encontrar os campos necessários em "Explorar". A maneira como os campos são listados no seletor de campos pode ser modificada pelos parâmetros na tabela abaixo. Para ver uma explicação completa sobre esse tópico, consulte a seção Seletor de campo da página de documentação Alterar o menu "Explorar" e o seletor de campo.

Nome do parâmetro Nível Descrição
description Campos: D DG M F P Adiciona uma descrição ao campo que os usuários podem ver ao passar o cursor
fields Explorar Limita os campos disponíveis em uma exploração a partir da visualização base e das junções da exploração. Afeta os campos disponíveis no seletor de campo.
fields Participar Determina quais campos de uma mesclagem são trazidos para uma exploração
hidden Campos: D DG M F P Oculta um campo na IU Explorar
label Campos: D DG M F P Altera a forma como um nome de campo aparece no seletor de campo.
label_from_parameter Campos: D M Muda a forma como o nome de um campo aparece em uma visualização com base na entrada para um parameter.

Modificar a organização dos campos no seletor de campo

A organização de campos pode ajudar os usuários a encontrar os campos necessários em "Explorar". A organização de campos no seletor de campo pode ser modificada pelos parâmetros na tabela abaixo. Para ver uma explicação completa sobre esse tópico, consulte a seção Seletor de campo da página de documentação Alterar o menu "Explorar" e o seletor de campo.

Nome do parâmetro Nível Descrição
group_label Campos: D DG M F Agrupar campos em uma visualização no seletor de campos
view_label Campos: D DG M F P Altera os campos que aparecem em uma visualização no seletor de campo.

Localização

Ao localizar seu modelo, os parâmetros de configurações de localização permitem personalizar a exibição de rótulos e descrições na IU do Looker com base na configuração de localidade do usuário. Consulte a página de localização de modelos para ver informações sobre como configurar seu modelo para localização.

Nome do parâmetro Nível Descrição
localization_settings Manifesto Especifica as informações de localização para seu modelo. Este parâmetro tem os subparâmetros default_locale e localization_level.
localization_level Manifesto Especifica se strings sem tradução são permitidas no seu modelo
default_locale Manifesto Especifica a localidade que será usada como padrão do modelo para traduzir strings

Valores e exibição de dados

Modificar os valores e a apresentação dos dados na seção Dados de um recurso Explorar pode ajudar os usuários a entender os resultados deles. Você pode modificar ou restringir os tipos de dados das suas dimensões ou medidas, mudar o formato dos dados que os usuários veem, preencher valores ausentes ou alterar outras opções de visualização.

Os usuários também podem definir os próprios cálculos da tabela exibidos na seção "Dados". No entanto, quando possível, defina dimensões e medidas no LookML para que o cálculo correto seja feito uma vez e usado de forma consistente em várias consultas.

Valores de dados para vários tipos de campo

Com esses parâmetros, você pode mudar os valores dos dados de vários tipos de campo.

Nome do parâmetro Nível Descrição
case Campos: D M Cria um conjunto distinto de valores que podem ser determinados por uma dimensão pelas condições do SQL. Este parâmetro tem os subparâmetros when e else.
sql Campos: D DG M F Determina como um campo será calculado
type (para dimensão, filtro ou parâmetro) Campos: D F P Especifica o tipo de dimensão, filtro ou parâmetro
type (para o grupo de dimensões) Campos: DG Especifica o tipo de grupo de dimensões
type (para medir) Campos: M Especifica o tipo de medida

Valores de dados para tipos específicos de dimensão

É possível modificar os valores de dados de alguns tipos de dimensões usando parâmetros específicos de tipo.

Dimensões de type: date ou type: datetime

Nome do parâmetro Nível Descrição
convert_tz Campos: D DG F M P Desativa a conversão automática de fuso horário para o campo
datatype Campos: D DG F M Especifica o tipo de dados de tempo fornecidos ao campo
fiscal_month_offset Modelo Especifica o mês em que seu ano fiscal começa (se for diferente do ano civil)
week_start_day Modelo Especifica o dia da semana em que as dimensões relacionadas à semana começam.

Dimensões de type: distance

Nome do parâmetro Nível Descrição
end_location_field Campos: D Define o campo que contém o local final para um campo de type: distance. Esse parâmetro também é considerado um parâmetro estrutural.
start_location_field Campos: D Define o campo que contém o local de início para um campo de type: distance.
units Campos: D Especifica a unidade a ser usada nos campos de type: distance.

Dimensões de type: location

Nome do parâmetro Nível Descrição
sql_latitude Campos: D Define a latitude de uma dimensão de type: location.
sql_longitude Campos: D Define a longitude de uma dimensão de type: location.

Dimensões de type: string

Nome do parâmetro Nível Descrição
string_datatype Campos: D Especifica o tipo de dados unicode para uma dimensão de type: string para SQL Server ou MySQL.

Dimensões de type: tier

Nome do parâmetro Nível Descrição
tiers Campos: D Define os níveis para uma dimensão de type: tier.

Grupos de dimensões de type: duration ou dimensões de type: duration_x

Nome do parâmetro Nível Descrição
sql_start Campos: D DG Define o horário de início de uma duração de um grupo de dimensão de type: duration ou uma dimensão de type: duration_x.
sql_end Campos: D DG Define o horário de término de uma duração para um grupo de dimensões de type: duration ou uma dimensão de type: duration_x.

Valores de dados para medidas

A maioria desses parâmetros é limitada a determinados tipos de medição, conforme especificado na tabela. Para criar uma contagem filtrada por um valor dimensional, consulte Como filtrar contagens por uma dimensão. Para criar uma medida que calcule a porcentagem entre dois campos, consulte Porcentagens.

Nome do parâmetro Nível Descrição
approximate Campos: M Realiza uma contagem aproximada para medidas de type: count_distinct. Consulte a página de documentação approximate para ver uma lista de dialetos compatíveis com esse parâmetro.
approximate_threshold Campos: M Define a contagem em que o BigQuery alterna de uma contagem exata distinta para uma contagem aproximada diferente.
direction Campos: M Determina a direção em que as medidas de type: percent_of_total ou type: running_total são calculadas quando as tabelas dinâmicas são usadas.
list_field Campos: M Declara a dimensão a partir da qual uma medida de type: list será calculada. Esse parâmetro também é considerado um parâmetro estrutural.
percentile Campos: M Especifica o valor fracionário (9o percentil) para uma medida de type: percentile ou type: percentile_distinct
primary_key Campos: D Declara uma dimensão como a chave primária de uma visualização.
sql_distinct_key Campos: M Define as entidades únicas em que uma medida distinta, como type: sum_distinct ou type: average_distinct, será calculada.
symmetric_aggregates Explorar Especifica se os agregados simétricos estão ativados para uma exploração. Esse parâmetro também é listado para parâmetros que afetam o comportamento de uma mesclagem. Consulte também a seção Como participar de visualizações abaixo.

Formatos de dados

Os valores de dados podem ficar mais fáceis de ler para os usuários, porque eles precisam ser formatados usando os parâmetros na tabela a seguir.

Nome do parâmetro Nível Descrição
html Campos: D DG M Modifica a saída HTML de um campo usando modelos líquidos
named_value_format Modelo Cria um formato de valor personalizado para ser usado com value_format_name. Este parâmetro tem os subparâmetros value_format e strict_value_format.
style Campos: D Muda a forma como os níveis aparecem na IU do Looker para uma dimensão de type: tier.
value_format Campos: D M Formata a saída de um campo usando as opções no estilo Excel.
value_format_name Campos: D M Formata a saída de um campo usando um formato integrado ou personalizado.

Ordem e preenchimento de dados

Para a maioria dos campos, a ordem de classificação é direta, apenas uma classificação alfanumérica dos valores. Em alguns casos, os resultados de uma nova instrução Look ou casesql_case do novo LookML podem classificar em uma ordem específica. Outra opção é classificar os valores pelo valor de outro campo. Também é possível usar o parâmetro allow_fill para ativar ou impedir que os usuários peçam ao Looker para preencher datas e valores ausentes para um campo.

Nome do parâmetro Nível Descrição
allow_fill Campos: D DG Determina se o preenchimento da dimensão é permitido para uma dimensão.
alpha_sort Campos: D Faz com que um parâmetro case classifique as condições em ordem alfabética
order_by_field Campos: D DG

Classifica um campo pelos valores de outro

Compatível com grupos de dimensões

Como visualizar dados de local

O Looker oferece vários mapas que você pode disponibilizar para visualizar valores de dados de local na seção Visualização. Você também pode criar e usar mapas personalizados para as visualizações.

Nome do parâmetro Nível Descrição
map_layer Modelo Cria mapas personalizados para serem usados com map_layer_name. Esse parâmetro tem muitos subparâmetros listados na página map_layer.
map_layer_name Campos: D Especifica um mapeamento de um valor de dados para uma região geográfica que você definiu em um mapa integrado ou personalizado.

Ações clicáveis para valores de dados

Perfuração

No Looker, cada resultado de consulta pode ser o ponto de partida para outra consulta. Os usuários podem clicar em um valor de dados para detalhar os dados. Também é possível usar o LookML para especificar quais campos são exibidos quando o usuário faz o detalhamento dos dados. As dimensões e as medidas têm um comportamento padrão diferente para o detalhamento.

Para opções avançadas de criação de um caminho de detalhamento personalizado, consulte o artigo Busca de dados mais eficiente na Central de Ajuda.

Nome do parâmetro Nível Descrição
drill_fields Campos: D DG M Declara a lista de campos que serão exibidos quando a medida ou dimensão for analisada
set Ver Define um conjunto de dimensões e medidas a serem usadas em outros parâmetros. Esse parâmetro é usado para limitar os campos disponíveis a uma mesclagem e, portanto, ao seletor de campos. Também é possível usar esse parâmetro para definir quais campos devem aparecer quando um usuário detalhar os dados. Consulte também Como usar conjuntos para detalhes de detalhamento na página de documentação Princípios básicos do LookML.

Ações de dados

Às vezes, os usuários vão querer acionar outros eventos depois que visualizarem os dados. Se você estiver usando o Hub de ações do Looker, é possível definir que campos com determinados tags podem usar serviços integrados específicos. Também é possível usar ações de dados para especificar quais opções estão disponíveis para os usuários em um campo.

Nome do parâmetro Nível Descrição
action Campos: D M Cria uma ação de dados em um campo que permite aos usuários realizar tarefas em outras ferramentas diretamente do Looker. Esse parâmetro tem muitos subparâmetros listados na página action.
tags Campos: D DG M F P Adiciona texto que pode ser transmitido para outros aplicativos para fornecer dados sobre um campo.

Vinculando

Você pode permitir que os usuários cliquem em um valor de dados para acessar um URL relacionado. Com esses parâmetros, você pode especificar quais campos são exibidos quando o usuário faz o detalhamento dos dados, bem como o texto exibido, o URL de destino e um favicon do site de destino.

Nome do parâmetro Nível Descrição
link Campos: D M Cria links para outros conteúdos externos e do Looker. Esse parâmetro tem os subparâmetros label, url e icon_url. Para opções avançadas usando link, consulte também o artigo Mais detalhamento de dados na Central de Ajuda.

Filtro

Os usuários podem aplicar filtros às consultas em Explorars, Aparências e painéis.

É possível ajudar a selecionar a experiência do usuário especificando o comportamento do filtro diretamente no LookML, como adicionar filtros úteis ou garantir que eles não criem acidentalmente uma consulta que traga muita demanda para os recursos do banco de dados. Você pode especificar comportamentos de filtro, como diferenciação de maiúsculas e minúsculas, valores padrão e as sugestões de filtros que o Looker pode gerar enquanto o usuário digita.

Para uma discussão mais geral sobre como filtrar no LookML, consulte Como filtrar conjuntos de resultados na página de documentação Princípios básicos do LookML. Para opções avançadas que usam filtros de modelo, consulte os artigos Filtros de modelo e parâmetros de líquido e Filtros de modelo avançados na Central de Ajuda.

Veja uma lista completa de expressões de filtro e sintaxe na página de documentação Expressões de filtro do Looker.

Como exigir filtros com valores fixos

Com esses parâmetros, você pode especificar filtros que sempre serão aplicados.

Consulte também Como filtrar contagens por uma dimensão na página de documentação Princípios básicos do LookML.

Nome do parâmetro Nível Descrição
access_filter Explorar Adiciona filtros específicos do usuário a uma exploração. Esse parâmetro tem os subparâmetros field e user_attribute.
sql_always_having Explorar Insere condições na cláusula HAVING da consulta que um usuário não pode alterar ou remover na ação "Explorar"
sql_always_where Explorar Insere condições na cláusula WHERE da consulta que um usuário não pode alterar ou remover na ação "Explorar"
sql_where Participar Se essa mesclagem for incluída na consulta, serão inseridas condições na cláusula WHERE da consulta que um usuário não poderá alterar ou remover na exploração. Apenas para o BigQuery. Esse parâmetro também pode ser considerado um parâmetro de filtro.

Como exigir filtros com valores alteráveis

Esses parâmetros permitem especificar filtros que precisam ser usados, mas permitem que o usuário mude os valores dos filtros.

Nome do parâmetro Nível Descrição
always_filter Explorar Adiciona filtros que um usuário pode mudar, mas não remover, a uma exploração. Este parâmetro tem um subparâmetro filters.
filter Campos: F Cria um campo somente de filtro para ser usado em um modelo.
filters Campos: M Restringe o cálculo de uma medida com base em limitações de dimensão

Como impedir filtros

Com esses parâmetros, você impede que um usuário use um campo como filtro, em todas as circunstâncias ou apenas durante o detalhamento.

Nome do parâmetro Nível Descrição
can_filter Campos: D DG M Determina se uma dimensão ou medida pode ser usada como filtro
skip_drill_filter Campos: D impede que uma dimensão seja adicionada aos filtros quando uma medida é detalhada.

Filtros condicionais

Em alguns casos, pode ser necessário especificar que o usuário precise usar um dos vários filtros para restringir a consulta. Por exemplo, o usuário precisa limitar a consulta por data ou região.

Além do parâmetro abaixo, consulte também Como filtrar conjuntos de resultados na página de documentação Princípios básicos do LookML.

Nome do parâmetro Nível Descrição
conditionally_filter Explorar Adiciona filtros a uma exploração se um usuário não adicionar o próprio filtro de uma lista específica. Este parâmetro tem os subparâmetros filters e unless.

Comportamento do valor do filtro

Para facilitar a filtragem dos usuários, forneça um valor padrão para o filtro ou trate os valores do filtro como indiferentes a maiúsculas.

Nome do parâmetro Nível Descrição
case_sensitive Explorar Especifica se os filtros diferenciam maiúsculas de minúsculas de uma exploração
case_sensitive Campos: D F Especifica se os filtros diferenciam maiúsculas de minúsculas em uma dimensão
case_sensitive Modelo Especifica se os filtros diferenciam maiúsculas de minúsculas de um modelo
default_value Campos: F P Especifica um valor padrão para os campos de filtro.

Filtrar sugestões

As sugestões de filtro são uma ótima maneira de ajudar seus usuários a filtrar dados. Em alguns casos, pode ser útil desativar as sugestões ou mudar o comportamento da sugestão.

Esses parâmetros LookML afetam o comportamento padrão das sugestões de filtro.

Comportamento padrão

Por padrão, as sugestões do Looker para um determinado campo de filtro têm como base todos os valores exclusivos dos dados desse campo.

Ativar ou desativar as sugestões

Se você acha que um campo tem um número muito grande de valores exclusivos, faz sentido desativar as sugestões de filtro para esse campo. Isso evita que o usuário precise contornar muitas sugestões e o banco de dados não precise fornecer essas sugestões. Você pode ativar ou desativar as sugestões de filtro em vários níveis.

Nome do parâmetro Nível Descrição
suggestable Campos: D DG M F P Ativa ou desativa as sugestões para um campo
suggestions Ver Ativa ou desativa as sugestões para todas as dimensões nessa visualização

Valores de sugestão

Por padrão, o Looker gera sugestões de filtro com base nos valores exclusivos de um campo. Em alguns casos, as sugestões poderão ser mais úteis se você tiver especificado os valores sugeridos pelo Looker, como os valores mais prováveis. Além disso, se você estiver limitando o acesso a alguns valores nos dados, é possível aplicar ou não esses limites às sugestões.

Nome do parâmetro Nível Descrição
allowed_value Campos: P Especifica as opções de um parameter. Este parâmetro tem os subparâmetros label e value.
bypass_suggest_restrictions Campos: D DG F P Mostra sugestões aos usuários quando o sql_always_where está em uso, mas não aplica esses limites às sugestões
full_suggestions Campos: D DG F P Mostra sugestões quando o sql_always_where está em uso e aplica esses limites às sugestões
suggest_dimension Campos: D DG M F P Baseia as sugestões de um campo nos valores de uma dimensão diferente.
suggest_explore Campos: D DG M F P Baseia as sugestões de um campo nos valores de uma exploração diferente.
suggestions Campos: D F P Declara uma lista de valores que serão usados para as sugestões de um campo.

Sugestões de armazenamento em cache

Por padrão, o Looker gera sugestões de filtro com base nos valores exclusivos de um campo. Esses valores são armazenados em cache para melhorar o desempenho, mas é possível alterar o período de uso dos valores. Se os dados estiverem razoavelmente estáveis, considere usar um tempo mais longo para melhorar o desempenho para conseguir esses valores de sugestão.

Nome do parâmetro Nível Descrição
suggest_persist_for Campos: D F P Altera as configurações de cache para sugestões de filtro do Looker.

Como participar de visualizações

Conforme discutido em Como trabalhar com mesclagens no LookML, as junções permitem a exploração de dados de mais de uma visualização ao mesmo tempo. É possível mesclar diferentes visualizações para que os usuários possam ver como os dados se relacionam.

As junções são definidas no arquivo de modelo para estabelecer a relação entre uma exploração e uma visualização. As mesclagens conectam uma ou mais visualizações em uma única visualização, seja diretamente ou por outra visualização mesclada.

Com esses parâmetros do LookML, é possível criar mesclagens e especificar como elas funcionam.

Do que se inscrever

Há uma variedade de parâmetros que especificam em quais visualizações mesclar, em geral e em situações específicas. Além disso, você pode especificar quais campos serão trazidos para a mesclagem.

Nome do parâmetro Nível Descrição
always_join Explorar Especifica quais mesclagens precisam ser sempre aplicadas a uma operação Explorar
fields Participar Determina quais campos de uma mesclagem são trazidos para uma exploração
from Participar Especifica a visualização em que uma mesclagem será baseada
include Modelo Adiciona arquivos a um modelo. Somente visualizações em arquivos disponíveis no modelo podem ser usadas para mesclagens
join Explorar Mescla outra visualização em "Explorar". Para mais informações sobre mesclagens e os parâmetros delas, consulte a página de referência Parâmetros de mesclagem. Esse parâmetro tem muitos subparâmetros listados em outra parte da página atual.
required_joins Participar Especifica quais mesclagens precisam ser aplicadas a um recurso Explorar quando campos de uma determinada mesclagem são escolhidos
sql_table_name Participar Especifica a tabela de banco de dados em que uma mesclagem será baseada

Como participar

Você pode especificar como as mesclagens funcionam e quais serão as condições da mesclagem. Também é necessário especificar uma chave primária para que o Looker possa usar agregações simétricas a fim de fornecer resultados corretos para funções de agregação.

Para mais detalhes sobre agregações simétricas, consulte também os artigos Uma explicação simples dos dados agregados ou "Por que na Terra meu SQL é assim?" e O problema dos fanouts do SQL Central de Ajuda.

Nome do parâmetro Nível Descrição
foreign_key Participar Especifica uma relação entre uma exploração e uma mesclagem usando a chave primária da visualização mesclada
outer_only Participar Especifica se todas as consultas precisam usar uma mesclagem externa.
primary_key Campos: D Declara uma dimensão como a chave primária de uma visualização.
relationship Participar Declara uma mesclagem como tendo um relacionamento de um para um, de muitos para um, de um para muitos ou de muitos para muitos
sql_on Participar Especifica uma relação entre uma exploração e uma mesclagem programando uma cláusula ON do SQL
symmetric_aggregates Explorar Especifica se os agregados simétricos estão ativados para uma exploração. Esse parâmetro também é listado com parâmetros que afetam o valor da medida.
type Participar Declara uma mesclagem como da esquerda, total, interna ou cruzada

Armazenamento em cache

O Looker reduz a carga no seu banco de dados e melhora o desempenho usando resultados armazenados em cache de consultas anteriores, quando disponíveis e permitidos pela política de armazenamento em cache. Além disso, é possível criar consultas complexas como tabelas derivadas permanentes (PDTs, na sigla em inglês), que armazenam os resultados para simplificar as consultas posteriores. Ao planejar o armazenamento em cache, considere o desempenho e a qualidade dos dados dos usuários.

Consultas de armazenamento em cache

É possível usar grupos de dados para integrar o Looker de forma mais precisa à fase ETL (extração, transformação e carregamento) do pipeline de dados. Por exemplo, se você carregar dados em lote em um job de ETL noturno, o Looker vai perceber que o ETL foi concluído e limpar todas as consultas em cache relacionadas.

Para mais informações, veja a página de documentação Consultas de armazenamento em cache e recriação de PDTs com grupos de dados.

Nome do parâmetro Nível Descrição
datagroup Modelo Cria uma política de armazenamento em cache de grupo de dados para o modelo. Esse parâmetro tem os subparâmetros max_cache_age, sql_trigger, label e description.
persist_for Explorar Altera as configurações de cache para uma exploração. Considere usar a funcionalidade maior de um parâmetro de grupo de dados.
persist_for Modelo Altera as configurações de cache de um modelo. Considere usar a funcionalidade maior de um parâmetro de grupo de dados.
persist_with Explorar Especifica o grupo de dados a ser usado para a política de armazenamento em cache do Explorar
persist_with Modelo Especifica o grupo de dados a ser usado para a política de armazenamento em cache do modelo

Sugestões de filtros em cache

Por padrão, o Looker gera sugestões de filtro com base nos valores exclusivos de um campo. Esses valores são armazenados em cache para melhorar o desempenho, mas é possível alterar o período de uso dos valores. Se os dados estiverem razoavelmente estáveis, use um tempo de cache mais longo para melhorar o desempenho para conseguir esses valores de sugestão.

Nome do parâmetro Nível Descrição
suggest_persist_for Campos: D F P Altera as configurações de cache para sugestões de filtro do Looker.

Armazenamento em cache de tabelas derivadas permanentes

Consulte Gerar novamente e armazenar em cache os parâmetros de tabelas derivadas permanentes abaixo para saber os parâmetros que afetam o armazenamento em cache de tabelas derivadas permanentes.

Tabelas derivadas

Conforme discutido no tutorial Tabelas derivadas no Looker, essas tabelas são ferramentas importantes no Looker. Eles permitem criar novas tabelas que ainda não existem no banco de dados, expandir a sofisticação das análises e melhorar o desempenho da consulta.

Veja mais informações em Tabelas derivadas e tabelas de fatos e Tabelas derivadas permanentes na página de documentação de Termos e conceitos do LookML.

Parâmetros estruturais para todas as tabelas derivadas

As tabelas derivadas podem ser definidas usando SQL ou LookML. Todas as tabelas derivadas começam com este parâmetro:

Nome do parâmetro Nível Descrição
derived_table Ver Baseia uma visualização em uma tabela derivada. Esse parâmetro tem muitos subparâmetros listados em outra parte da página atual e mostrados no exemplo da tabela de uso na página de documentação Ver parâmetros.

Parâmetros estruturais para tabelas derivadas nativas

As tabelas nativas nativas são muito mais fáceis de ler, entender e entender ao modelar seus dados.

Os parâmetros da tabela abaixo são usados para definir os dados de origem de uma tabela derivada nativa. Eles são descritos em mais detalhes e mostrados em um exemplo de uso na página de documentação do parâmetro explore_source.

Nome do parâmetro Nível Descrição
bind_all_filters Ver Use em explore_source para transmitir todos os filtros da consulta "Explorar" para a subconsulta da tabela derivada nativa. Consulte a página de documentação do parâmetro explore_source para ver um exemplo.
OBSERVAÇÃO:o parâmetro explore_source pode ter o subparâmetro bind_all_filters ou o bind_filters, mas não ambos.
bind_filters Ver Use em explore_source para transmitir um filtro da consulta "Explorar" para a subconsulta da tabela derivada nativa. Para configurar isso, use o subparâmetro from_field para especificar um campo definido na visualização da tabela derivada nativa ou acessível em "Explorar" a que a tabela derivada nativa é mesclada. Durante a execução, todos os filtros em from_field na guia "Explorar" serão transmitidos para o to_field na subconsulta da tabela derivada nativa. Consulte a página de documentação do parâmetro explore_source para ver um exemplo.
OBSERVAÇÃO: o parâmetro explore_source pode ter o subparâmetro bind_all_filters ou o bind_filters, mas não ambos.
column Ver Use em explore_source para especificar uma coluna a ser incluída na tabela. Este parâmetro tem um subparâmetro field.
derived_column Ver Especifica uma coluna no explore_source com uma expressão no namespace das colunas internas. As expressões SQL agregadas não funcionam aqui porque não há agrupamento SQL nesta etapa. Isso é especialmente útil para definir funções de janela, quando aplicável. Este parâmetro tem um subparâmetro sql.
explore_source Ver Gera o SQL para uma tabela derivada com base no recurso Explorar associado. O explore_source tem vários subparâmetros descritos nas outras linhas da tabela e na página de documentação principal.
expression_custom_filter Ver Especifica uma expressão de filtro personalizada em uma consulta explore_source. Opcional.
filters Ver Especifica uma expressão de filtro personalizada em uma consulta explore_source. Opcional.
include Modelo Inclui os arquivos que contêm os campos a serem referenciados na tabela, conforme explicado na página de documentação explore_source. Consulte a página de documentação principal do parâmetro include para outros usos, como adicionar arquivos a modelos e visualizações. Consulte Visualizações de mesclagem acima, sobre como usar include para criar mesclagens.
limit Ver Especifica o limite de linhas da consulta. Opcional.
sorts Ver Opcional. Especifica uma classificação para esse explore_source. Entre colchetes, inclua o nome do campo a ser classificado, seguido de :, e indique se o campo precisa ser classificado em ordem crescente ou decrescente usando a palavra-chave asc ou desc.
timezone Ver Define o fuso horário da consulta explore_source. Para tabelas derivadas efêmeras (não persistentes), defina este parâmetro como query_timezone para usar automaticamente o fuso horário da consulta em execução no momento. Se um fuso horário não for especificado, por padrão, a consulta explore_source não realizará a conversão e funcionará no fuso horário do banco de dados.

Parâmetros estruturais para tabelas derivadas de SQL

Para tabelas derivadas de SQL, use o parâmetro listado abaixo.

Nome do parâmetro Nível Descrição
sql (para derivada_table) Ver Declara a consulta SQL para uma tabela derivada

Parâmetros estruturais para a definição de dados personalizados

Para dialetos de bancos de dados que exigem uma linguagem de definição de dados (DDL) personalizada, use os parâmetros listados abaixo. Por exemplo, se o dialeto do banco de dados não for compatível com CREATE TABLE as SELECT emitido como uma única instrução SQL, use o parâmetro create_process para criar um PDT em várias etapas:

Nome do parâmetro Nível Descrição
create_process Ver Especifica uma série de instruções SQL que serão executadas uma de cada vez, na ordem listada. Cada instrução SQL individual é especificada usando o subparâmetro sql_step.
sql_create Ver Define uma instrução SQL CREATE para criar um PDT em um dialeto de banco de dados que requer comandos DDL personalizados.

Parâmetros de regeneração e armazenamento em cache para tabelas derivadas permanentes

Como discutido na seção Armazenamento em cache acima, é possível usar grupos de dados para gerenciar o armazenamento em cache e equilibrar a eficiência com a atualização de dados.

É possível usar grupos de dados para gerar novamente tabelas derivadas permanentes (PDTs, na sigla em inglês) quando dados novos estiverem disponíveis. Como alternativa, você pode especificar que os PDTs sejam gerados novamente com pouca frequência, mesmo que as tabelas subjacentes sejam atualizadas com frequência. Dessa forma, as consultas dos PDTs podem ser armazenadas em cache por mais tempo.

Para mais informações, veja Estratégias de persistência nas páginas Documentação derivada no Looker e Como armazenar em cache consultas e recriar PDTs com grupos de dados.

Nome do parâmetro Nível Descrição
datagroup_trigger Ver Especifica o grupo de dados a ser usado para a política de recriação de PDT
persist_for (para derivada_table) Ver Define a idade máxima de um PDT antes que ele seja gerado novamente. Considere usar o parâmetro datagroup_trigger mais eficiente.
sql_trigger_value Ver Especifica a condição que faz com que um PDT seja gerado novamente. Considere usar o parâmetro datagroup_trigger mais eficiente.

Parâmetros de eficiência da consulta para tabelas derivadas

Dependendo do dialeto do banco de dados, você pode usar alguns parâmetros para melhorar a eficiência da tabela derivada.

Nome do parâmetro Nível Descrição
cluster_keys Ver Especifica um PDT ou uma tabela agregada em cluster por um ou mais campos no BigQuery
Suporte adicionado para cluster_keys no Snowflake
Suporte adicionado para cluster_keys com tabelas agregadas
distribution Ver Define a chave de distribuição de um PDT ou de uma tabela agregada criada no Redshift ou no Aster
Suporte adicionado para distribution com tabelas de agregação
distribution_style Ver Define o estilo de distribuição de uma PDT ou uma tabela agregada criada no Redshift.
Suporte adicionado para distribution_style com tabelas agregadas.
increment_key Ver ADDED 21.4 Transforma a tabela derivada em um PDT incremental. O increment_key especifica o incremento de tempo em que os dados atualizados devem ser consultados e anexados ao PDT.
increment_offset Ver ADDED 21.4 Usado em conjunto com o parâmetro increment_key para PDTs incrementais. O increment_offset especifica o número de períodos anteriores (com granularidade da chave de incremento) que são recriados para considerar os dados que chegam atrasados.
indexes Ver Define os índices de um PDT ou de uma tabela agregada criada em um banco de dados tradicional (por exemplo, MySQL, Postgres) ou uma chave de classificação intercalada no Redshift
Suporte adicionado para indexes com tabelas de agregação
partition_keys Ver Especifica que um PDT ou uma tabela agregada é particionado por um ou mais campos no Presto ou por um único campo de data/hora no BigQuery
Suporte adicionado para partition_keys com tabelas de agregação
sortkeys Ver Define as chaves de classificação de um PDT ou uma tabela agregada criada no Redshift.
Suporte adicionado para sortkeys com tabelas de agregação.
table_compression Ver Especifica a compactação de tabela a ser usada para um PDT no Amazon Athena
table_format Ver Especifica o formato da tabela a ser usado para um PDT no Amazon Athena

Tabelas de agregação

Como falamos na página Documentação sobre reconhecimento agregado, as tabelas agregadas podem otimizar as consultas nos seus explorações. As tabelas agregadas são mantidas no seu banco de dados, da mesma forma que as tabelas derivadas permanentes (PDTs, na sigla em inglês).

As tabelas de agregação são definidas em "Explorar".

Nome do parâmetro Nível Descrição
aggregate_table Explorar Cria uma tabela agregada para uma exploração. Esse parâmetro tem subparâmetros descritos na página de documentação do parâmetro aggregate_table.

Outros parâmetros de comportamento da consulta

Existem vários parâmetros que afetam o que e como você consulta. Alguns deles foram descritos em outras seções desta página de acordo com o que fazem. Esta seção descreve os parâmetros LookML restantes que permitem estabelecer o comportamento da consulta.

O que consultar

Esses parâmetros definem informações específicas sobre as conexões, os arquivos e os campos que serão usados nas consultas.

Nome do parâmetro Nível Descrição
access_grant Modelo Cria uma concessão de acesso que limita o acesso a estruturas LookML apenas a usuários com valores aprovados de atributo de usuário. Este parâmetro tem os subparâmetros user_attribute e allowed_values.
connection Modelo Muda a conexão do banco de dados para um modelo
fanout_on Campos: D DG M Permite acesso aos campos repetidos do Google BigQuery
from Explorar Especifica a visualização em que uma exploração será baseada e se refere aos campos dessa visualização pelo nome da exploração
required_access_grants Explorar Limita o acesso a um recurso Explorar apenas aos usuários com valores de atributos que correspondem às concessões de acesso.
required_access_grants Participar Limita o acesso a uma mesclagem apenas aos usuários cujos valores de atributo de usuário correspondam às concessões de acesso
required_access_grants Ver Limita o acesso a uma visualização apenas aos usuários com valores de atributos que correspondam às concessões de acesso.
required_access_grants Campos: D DG M F P Limita o acesso a um campo apenas aos usuários com valores de atributos que correspondam às concessões de acesso.
required_fields Campos: D M Requer que campos adicionais sejam adicionados a uma consulta quando um campo é escolhido
sql_table_name Explorar Especifica a tabela do banco de dados em que uma exploração será baseada
sql_table_name Ver Muda a tabela SQL em que uma visualização se baseia
view_name Explorar Especifica a visualização em que uma exploração se baseia e referencia os campos por nome da visualização.

Como consultar

Esses parâmetros afetam como o Looker constrói ou processa suas consultas.

Vários desses parâmetros são envolvidos para garantir que agregações simétricas funcionem. Para mais detalhes sobre agregações simétricas, consulte também o artigo Uma explicação simples sobre isso.

Nome do parâmetro Nível Descrição
alias Campos: D DG M F P Permite que os URLs salvos com nomes de campo antigos continuem funcionais após a renomeação de um campo.
cancel_grouping_fields Explorar Cancela a cláusula GROUP BY quando determinados campos são escolhidos em um Explore
primary_key Campos: D Declara uma dimensão como a chave primária de uma visualização.
sql_where Participar Se essa mesclagem for incluída na consulta, serão inseridas condições na cláusula WHERE da consulta que um usuário não pode mudar ou remover para essa exploração. Apenas para o BigQuery. Esse parâmetro também pode ser considerado um parâmetro de filtro.
symmetric_aggregates Explorar Especifica se os agregados simétricos estão ativados para uma exploração. Esse parâmetro também é listado para parâmetros que afetam os valores de medida.

Parâmetros a serem evitados

Talvez você veja os seguintes parâmetros no seu modelo, então incluímos uma lista aqui sobre o que eles fazem. No entanto, se você estiver adicionando nova modelagem, evite esses parâmetros.

Nome do parâmetro Nível Descrição
access_filter_fields Explorar REMOVED 6.0 Substituído por access_filter
decimals Campos: D M REMOVED 5.4 Substituído por value_format
distkey Ver REMOVED 3.26 Substituído por distribution
format Campos: D M REMOVED 3.16 Substituído por value_format
scoping Modelo REMOVED 3.52 Não é mais necessário
sql Participar EVITAR 3.10 Substituído por uma combinação de sql_on, foreign_key, type e/ou sql_table_name, conforme descrito na página de documentação de parâmetros sql (para mesclagens)
sql_foreign_key Participar EVITAR 3.16 Substituído por foreign_key
template Modelo REMOVED 3.30 Não é mais necessário
view_label Ver EVITAR 4.4 Substituído por label

Outros tutoriais e recursos

Essas seções oferecem links para recursos adicionais que podem aprofundar sua compreensão do LookML e apoiar você em outras tarefas de desenvolvedor no Looker.

Entender o processo de desenvolvimento

A seção Modelagem de dados do menu de documentação do Looker foi projetada para que você comece a usar a seção "Desenvolver".

Páginas específicas que podem ser úteis:

Noções básicas sobre LookML

A seção Etapas para aprender a usar o LookML do menu de documentação do Looker foi apresentada para apresentar conceitos básicos desse recurso e sugerir um programa de aprendizado sobre a proficiência nesse recurso.

Páginas específicas que podem ser úteis:

Como criar painéis do LookML

Todos os arquivos do painel em um projeto contêm parâmetros LookML específicos do painel. A página atual inclui apenas parâmetros de modelagem de dados, não parâmetros de painel, mas a seção Como criar e gerenciar painéis do LookML no menu de documentação do Looker foi criada para apresentar o trabalho com painéis do LookML.

Páginas específicas que podem ser úteis:

Opções de incorporação, API e administrador

Embedding

As páginas a seguir podem ser úteis para saber mais sobre a incorporação de visuais, explorações e painéis:

API

A seção API Looker do menu de documentação do Looker é projetada para ajudar você a começar a usar a interface de programação do aplicativo (API) segura e "RESTful" do Looker.

Opções do administrador

A seção Introdução às opções de administrador do menu de documentação do Looker foi criada para que você comece com a seção "Administrador" do Looker.

Treinamento no Looker Connect

Inscreva-se no nosso jornada de aprendizado para LookML Developer no Looker Connect.