Exibir parâmetros

Uma visualização representa uma tabela de dados no Looker, seja ela nativa do seu banco de dados ou criada usando a funcionalidade de tabela derivada do Looker. As visualizações geralmente são declaradas em arquivos de visualização, com uma visualização por arquivo.

Dentro de cada visualização, há definições de campo, cada uma delas correspondendo a uma coluna na tabela subjacente ou a um cálculo no Looker. Esses campos são descritos na referência de campo, na referência de tipo de dimensão e na referência de tipo de medida.

Há também várias configurações no nível da visualização, que são descritas nesta página.

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

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

view: view_name {
  extension: required
  extends: [view_name, view_name, ...]

  (dimension | dimension_group | measure | filter):field_name{
    # Desired field parameters (described on Field Parameters page)
  }
  # Possibly more field declarations

  set: set_name{
    fields:[field_or_set, field_or_set, ...]
  }
  # Possibly more set declarations

  drill_fields: [field_or_set, field_or_set, ...]

  # CUSTOM CALENDAR PARAMETERS

    calendar_definition: {
      Custom calendar mapping parameters ;;
    }

  # DISPLAY PARAMETERS

  label: "desired label"
  fields_hidden_by_default: yes | no

  # FILTER PARAMETERS

  suggestions: yes | no

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;

  # DERIVED TABLE PARAMETERS

  derived_table: {
    cluster_keys: ["column_name", "column_name", ...]
    create_process: {
      sql_step:SQL query ;;
    }
    datagroup_trigger: datagroup_name
    distribution: "column_name"
    distribution_style: all | even
    explore_source: explore_name {
      # Desired subparameters (described on explore_source page)
    }
    increment_key: "column_name"
    increment_offset: N
    indexes: ["column_name", "column_name", ...]
    interval_trigger: "N (seconds | minutes | hours)"
    materialized_view: yes | no
    partition_keys: ["column_name", "column_name", ...]
    persist_for: "N (seconds | minutes | hours)"
    publish_as_db_view: yes | no
    sortkeys: ["column_name","column_name", ...]
    sql: SQL query ;;
    sql_create: {
      SQL query ;;
    }
    sql_trigger_value: SQL query ;;
    table_compression: GZIP | SNAPPY
    table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE
  }
}

## REFINEMENT PARAMETERS
view: +view_name {
  final: yes
}

Definições de parâmetro

Nome do parâmetro	Descrição
Parâmetros estruturais
drill_fields (para visualização)	Especifica a lista padrão de campos mostrados ao detalhar as medidas definidas na visualização
extends (para visualização)	Especifica as visualizações que serão estendidas por essa visualização
extension (para visualização)	Especifica que a visualização exige extensão e não pode ser exposta aos usuários
include	Adiciona arquivos a uma visualização
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.
set	Define um conjunto de dimensões e medidas a serem usadas em outros parâmetros
view	Cria uma visualização
Parâmetros de exibição
label (para visualização)	Especifica como o nome da visualização vai aparecer no seletor de campos
fields_hidden_by_default	Adicionado na versão 21.12 Quando definido como yes, oculta todos os campos na visualização por padrão. Use o hidden: no parâmetro em um campo para mostrar o campo.
Parâmetros de filtro
suggestions (para visualização)	Ativa ou desativa sugestões para todas as dimensões nessa visualização
Query Parameters
autogenerate_primary_keys (para visualização)	Ativa ou desativa a geração automática de chave primária
required_access_grants (para visualização)	Limita o acesso à visualização apenas aos usuários cujos valores de atributo de usuário correspondam às concessões de acesso
sql_table_name (para visualização)	Muda a tabela SQL em que uma visualização é baseada
Parâmetros de tabela derivada
cluster_keys	Especifica que uma PDT seja agrupada por um ou mais campos no BigQuery Suporte adicionado para cluster_keys no Snowflake
create_process	Especifica uma sequência ordenada de etapas para criar uma PDT em um dialeto de banco de dados que exige comandos DDL personalizados. Esse parâmetro tem o subparâmetro sql_step.
datagroup_trigger	Especifica o datagroup a ser usado para a política de recriação da PDT
derived_table	Baseia uma visualização em uma tabela derivada
distribution	Define a chave de distribuição de uma PDT criada no Redshift ou no Aster
distribution_style	Define o estilo de distribuição de uma PDT criada no Redshift
explore_source	Define uma tabela derivada nativa com base em uma análise
increment_key	Adicionado na versão 21.4 Transforma a tabela derivada em uma PDT incremental. A increment_key especifica o incremento de tempo para o qual os dados novos precisam ser consultados e anexados à PDT.
increment_offset	Adicionado na versão 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 (na granularidade da chave de incremento) que são recriados para contabilizar dados recebidos com atraso.
interval_trigger	Adicionado na versão 21.20 O interval_trigger especifica uma programação de recriação para uma tabela derivada persistente, no formato "N (seconds | minutes | hours)"
materialized_view	Adicionado na versão 21.10 A instrução materialized_view: yes cria uma visualização materializada no banco de dados para uma tabela derivada.
indexes	Define os índices de uma PDT criada em um banco de dados tradicional (por exemplo, MySQL, Postgres) ou uma chave de classificação intercalada no Redshift
partition_keys	Especifica que uma PDT seja particionada por um ou mais campos no Presto ou por um único campo de data/hora no BigQuery
persist_for (para derived_table)	Define a idade máxima de uma PDT antes de ela ser regenerada
publish_as_db_view	A instrução publish_as_db_view: yes cria uma visualização de banco de dados estável para a PDT, permitindo consultar a tabela fora do Looker
sortkeys	Define as chaves de classificação de uma PDT criada no Redshift
sql (para derived_table)	Declara a consulta SQL para uma tabela derivada
sql_create	Define uma instrução SQL CREATE para criar uma PDT em um dialeto de banco de dados que exige comandos DDL personalizados
sql_trigger_value	Especifica a condição que faz com que uma PDT seja regenerada
table_compression	Especifica a compactação de tabela a ser usada para uma PDT no Amazon Athena
table_format	Especifica o formato de tabela a ser usado para uma PDT no Amazon Athena
Parâmetros de refinamento
view: +view_name	Adiciona um sinal de mais (+) na frente de um nome de visualização para adicionar um refinamento à visualização. Consulte a página de documentação de refinamentos do LookML para mais informações e casos de uso.
final	Indica que o refinamento atual é o refinamento final permitido para a visualização. Consulte a página de documentação de refinamentos do LookML para mais informações e casos de uso.
Parâmetros a serem evitados
distkey	Removido na versão 3.26 Substituído por distribution
view_label	Evite a versão 4.4 Substituído por label