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.

Em cada visualização, há definições de campo, cada uma delas geralmente 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 métrica.

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, ...]

  # 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 esta 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 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.
set	Define um conjunto de dimensões e métricas 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 parâmetro hidden: no em um campo para mostrar o campo.
Parâmetros de filtro
suggestions (para visualização)	Ativa ou desativa as 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 correspondem às concessões de acesso.
sql_table_name (para visualização)	Muda a tabela SQL em que uma visualização se baseia.
Parâmetros de tabela derivada
cluster_keys	Especifica que uma PDT seja agrupada por cluster 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 de 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 TDP incremental. O increment_key especifica o incremento de tempo para o qual os dados atualizados devem ser consultados e anexados à TDP.
increment_offset	Adicionado na versão 21.4 Usado 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 considerar os dados que chegam atrasados.
interval_trigger	Adicionado 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 seu 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 que ela seja regenerada.
publish_as_db_view	A instrução publish_as_db_view: yes cria uma visualização de banco de dados estável para que a PDT possa 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 adição (+) na frente de um nome de visualização para adicionar um refinamento a ela. Consulte a página de documentação Refinamentos da LookML para mais informações e casos de uso.
final	Indica que o refinamento atual é o último permitido para a visualização. Consulte a página de documentação Refinamentos da LookML para mais informações e casos de uso.
Parâmetros a serem evitados
distkey	Removido 3.26 Substituído por distribution
view_label	Evite 4.4 Substituído por label