allow_fill

Uso

view: view_name {
  dimension: field_name {
    allow_fill: yes 
  }
}
Hierarquia
allow_fill
Tipos de campo possíveis
Dimensão, grupo de dimensões

Valor padrão
yes

Aceita
Um booleano (sim ou não)

Definição

Alguns conjuntos de dados têm valores, como datas, que seguem um padrão previsível. Um usuário pode extrair dados por um período e descobrir que algumas datas, semanas, meses ou outros tipos de data não têm um valor correspondente. Por padrão, a tabela de dados e a visualização mostram as datas retornadas pela consulta e ignoram as datas ausentes.

Para esses casos, a opção preenchimento de dimensão do Looker permite que o usuário preencha datas e valores ausentes na tabela de dados e no eixo da visualização da consulta. Essa opção está no menu de engrenagem da dimensão, na seção Dados de uma análise detalhada.

O parâmetro allow_fill de uma dimensão é usado para ativar ou desativar a opção de preencher os valores ausentes na tabela de dados e no eixo da visualização. Por padrão, se o tipo de dimensão for compatível com o preenchimento de valores ausentes, a opção vai aparecer no menu de engrenagem da dimensão. Para desativar a opção de preencher valores ausentes em uma dimensão, defina allow_fill como no.

A opção allow_fill está disponível para grupos e dimensões que têm um número fixo de valores, como sim/não e valores hierárquicos, além de tipos de data, como day_of_week ou hour_of_day.

Também é possível usar o parâmetro case ou tier para aplicar a opção allow_fill a qualquer opção de dimensão baseada em uma lista de valores. Os valores ausentes são preenchidos automaticamente para consultas executadas com uma única dimensão e/ou um único indicador, desde que o usuário não tenha aplicado filtros a nenhuma métrica.

O preenchimento de dimensão pode ser aplicado a várias dimensões de uma só vez em uma consulta, incluindo dimensões dinâmicas. No entanto, o Looker pode desativar automaticamente o preenchimento de dimensão para otimizar a performance da consulta se detectar que muitos campos serão gerados com valores preenchidos.

Exemplos

Impedir que um usuário preencha os valores ausentes da dimensão Data de criação:

dimension: created_date {
  type: date
  sql: ${TABLE}.created_date ;;
  allow_fill: no
}

Informações importantes

Há alguns outros casos em que o usuário não poderá fazer o preenchimento de dimensão:

  • Quando as dimensões usam o parâmetro order_by_field.

  • Quando as dimensões têm um filtro aplicado e também um número fixo de valores, como sim/não, dias da semana, dias do mês etc. A filtragem desses tipos de campo elimina o número fixo de valores que o Looker precisa para preencher com precisão os valores ausentes.

  • Quando o usuário está detalhando uma dimensão dinâmica.

  • Quando o Looker detecta que muitas linhas ou colunas serão geradas com valores preenchidos e desativa automaticamente o preenchimento de dimensões para otimizar a performance da consulta.