Parâmetros do modelo

Um arquivo de modelo especifica uma conexão de banco de dados, define o conjunto de Análises detalhadas que usam essa conexão e define as relações das Análises detalhadas com outras visualizações. Ao contrário de outros elementos da LookML, um modelo não é declarado com um parâmetro "model" específico. Em vez disso, um desenvolvedor do LookML define um modelo criando um arquivo de projeto do LookML com a extensão .model.lkml. O nome do modelo é retirado do nome do arquivo.

O nome de um modelo precisa ser exclusivo em todos os projetos na sua instância. Se a instância tiver dois arquivos .model.lkml com o mesmo nome, é provável que você encontre erros, como erros de configuração do modelo na página Projetos do LookML e erros de renderização para erros de painel do LookML, já que os painéis do LookML usam o nome do modelo no formato do URL (<hostname>/dashboard/model_name::<dashboard_name>).

Use o Validador do LookML para verificar se os nomes de modelos estão duplicados na sua instância. No entanto, mesmo que o validador do LookML detecte nomes de modelos duplicados na sua instância, você ainda poderá enviar o código para produção. Portanto, corrija todos os erros de nome de modelo duplicado antes de implantar o projeto do LookML em produção.

Um arquivo de modelo geralmente contém declarações explore, além de várias configurações no nível do modelo.

Esta página tem links para os parâmetros da LookML no nível do modelo. Normalmente, elas são escritas na parte de cima do arquivo de modelo e não podem ser aninhadas em outros parâmetros.

Exemplo de uso

Passe o cursor sobre o nome de um parâmetro para ver uma descrição rápida. Clique em um parâmetro para acessar a página de referência dele. Quando um parâmetro pode ser definido como uma de várias opções específicas, o valor padrão é listado primeiro.

## STRUCTURAL PARAMETERS
include:"filename_or_pattern"
## Possibly more include declarations

explore: explore_name {
  # Desired explore parameters (described on Explore Parameters page)
}
## Possibly more explore declarations

access_grant: access_grant_name{
  user_attribute: user_attribute_name
  allowed_values: ["value_1", "value_2", ...]
}
## Possibly more access_grant declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

## DISPLAY PARAMETERS
label: "desired label"

## FILTER PARAMETERS
case_sensitive: yes | no

## QUERY PARAMETERS
connection: "connection_name"
datagroup: datagroup_name{
  label: "desired label"
  description: "desired description"
  max_cache_age: "N (minutes | hours | days)"
  sql_trigger: SQL query ;;
}
## Possibly more datagroup declarations
fiscal_month_offset: N
persist_for: "N (seconds | minutes | hours)"
persist_with: datagroup_name
week_start_day: monday | tuesday | wednesday | thursday | friday | saturday | sunday

## VISUALIZATION AND FORMATTING PARAMETERS
map_layer: map_name{
  extents_json_url: "URL to JSON extents file"
  feature_key: "Name of TopoJSON object"
  file: "TopoJSON or GeoJSON filename" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "desired label"
  max_zoom_level: number indicating max zoom
  min_zoom_level: number indicating min zoom
  projection: Preferred geographic projection
  property_key: "TopoJSON property"
  property_label_key: "Label for TopoJSON property"
  url: "URL that contains map file" # or use the file subparameter
}
## Possibly more map layer declarations

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
 }
## Possibly more named value format declarations

Definições de parâmetro

Nome do parâmetro	Descrição
Parâmetros estruturais
access_grant	Cria uma concessão de acesso que limita o acesso das estruturas do LookML apenas aos usuários que têm um valor de atributo do usuário aprovado. Esse parâmetro tem os subparâmetros user_attribute e allowed_values.
explore	Expõe uma visualização no menu "Análise". Para mais informações sobre as análises detalhadas e os parâmetros delas, consulte a página Referência de parâmetros de análise detalhada.
include	Adiciona arquivos a um modelo.
test	Cria um teste de dados para verificar a lógica do modelo. As configurações do projeto incluem uma opção para exigir testes de dados. Quando essa opção está ativada em um projeto, os desenvolvedores precisam executar testes de dados antes de implantar as mudanças na produção. Esse parâmetro tem os subparâmetros explore_source e assert.
Parâmetros de exibição
label (para modelo)	Muda a forma como um modelo aparece no menu "Análise"
Parâmetros de filtro
case_sensitive (para modelo)	Especifica se os filtros diferenciam maiúsculas de minúsculas para um modelo.
Query Parameters
connection	Muda a conexão de banco de dados de um modelo
datagroup	Cria uma política de cache de grupo de dados para um modelo. Esse parâmetro tem os subparâmetros label, description, max_cache_age e sql_trigger.
fiscal_month_offset	Especifica o mês em que seu ano fiscal começa (se for diferente do ano civil)
persist_for (para modelo)	Muda as configurações de cache de um modelo.
persist_with (para modelo)	Especifica o grupo de dados a ser usado na política de armazenamento em cache do modelo.
week_start_day	Especifica o dia da semana em que as dimensões relacionadas à semana devem começar.
Parâmetros de visualização e formatação
map_layer (para modelo)	Cria mapas personalizados para serem usados com o map_layer_name.
named_value_format	Cria um formato de valor personalizado para ser usado com value_format_name. Esse parâmetro tem os subparâmetros value_format e strict_value_format.
Parâmetros a serem evitados
scoping	Removido 3.52 Não é mais necessário
template	Removido 3.30 Não é mais necessário