Parâmetros do modelo

Um arquivo modelo especifica uma conexão de banco de dados, define o conjunto de Análises que usam essa conexão e define os relacionamentos das Análises com outras visualizações. Ao contrário de outros elementos do 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 é extraído do nome do arquivo.

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

Você pode usar o Validador do LookML para verificar se os nomes dos 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, ainda é possível enviar o código para produção. Portanto, corrija todos os erros de nome de modelo duplicado antes de implantar o projeto do LookML na produção.

Um arquivo modelo normalmente 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 do LookML no nível do modelo. Eles geralmente são gravados na parte de cima do arquivo modelo e não devem ser aninhados em outros parâmetros.

Exemplo de uso

Passe o cursor sobre um nome de 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 de estruturas do LookML apenas aos usuários que têm um valor de atributo de usuário aprovado atribuído a eles. 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 e os parâmetros delas, consulte a página Referência de parâmetros de análise.
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 para 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 armazenamento em 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 o 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 para a 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 map_layer_name
named_value_format	Cria um formato de valor personalizado para ser usado com value_format_name. Esse parâmetro tem os value_format e strict_value_format subparâmetros.
Parâmetros a serem evitados
scoping	Removido na versão 3.52 Não é mais necessário
template	Removido na versão 3.30 Não é mais necessário