Ver parámetros

Una vista representa una tabla de datos en Looker, ya sea que esté integrada en tu base de datos o que se haya creado con la funcionalidad de tabla derivada de Looker. Por lo general, las vistas se declaran en archivos de vista, con una vista por archivo.

Dentro de cada vista, hay definiciones de campos, cada una de las cuales suele corresponder a una columna de la tabla subyacente o a un cálculo en Looker. Estos campos se describen en la referencia de campos, la referencia de tipo de dimensión y la referencia de tipo de medida.

También hay una serie de parámetros de configuración a nivel de la vista, que se describen en esta página.

Ejemplo de uso

Coloca el puntero sobre un nombre de parámetro para ver una descripción rápida. Haz clic en un parámetro para visitar su página de referencia. Cuando un parámetro se puede establecer en una de varias opciones específicas, el valor predeterminado aparece primero.

## 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_analytic_model: {
    sql: analytic_model_definition ;;
  }
  sql_analytic_model_name: analytic_model_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
}

Definiciones de los parámetros

Nombre del parámetro	Descripción
Parámetros estructurales
drill_fields (para la vista)	Especifica la lista predeterminada de campos que se muestran cuando se profundiza en las medidas definidas en la vista.
extends (para la vista)	Especifica las vistas que se extenderán con esta vista.
extension (para la vista)	Especifica que la vista requiere extensión y no se puede exponer a los usuarios.
include	Agrega archivos a una vista.
test	Crea una prueba de datos para verificar la lógica de tu modelo. La configuración del proyecto incluye una opción para requerir pruebas de datos. Cuando esta opción está habilitada para un proyecto, los desarrolladores del proyecto deben ejecutar pruebas de datos antes de implementar sus cambios en producción. Este parámetro tiene los subparámetros explore_source y assert.
set	Define un conjunto de dimensiones y medidas que se usarán en otros parámetros.
view	Crea una vista.
Parámetros de visualización
label (para la vista)	Especifica cómo aparecerá el nombre de la vista en el selector de campos.
fields_hidden_by_default	Se agregó en la versión 21.12 Cuando se establece en yes, se ocultan todos los campos de la vista de forma predeterminada. Usa el hidden: no parámetro en un campo para mostrarlo.
Parámetros de filtro
suggestions (para la vista)	Habilita o inhabilita las sugerencias para todas las dimensiones de esta vista.
Parámetros de búsqueda
autogenerate_primary_keys (para la vista)	Habilita o inhabilita la generación automática de clave primaria.
required_access_grants (para la vista)	Limita el acceso a la vista solo a los usuarios cuyos valores de atributos de usuario coinciden con las concesiones de acceso.
sql_table_name (para la vista)	Cambia la tabla de SQL en la que se basa una vista.
Parámetros de tabla derivada
cluster_keys	Especifica que una PDT se agrupe por uno o más campos en BigQuery. Se agregó compatibilidad con cluster_keys en Snowflake.
create_process	Especifica una secuencia ordenada de pasos para crear una PDT en un dialecto de base de datos que requiere comandos DDL personalizados. Este parámetro tiene el subparámetro sql_step.
datagroup_trigger	Especifica el grupo de datos que se usará para la política de reconstrucción de PDT.
derived_table	Basa una vista en una tabla derivada.
distribution	Establece la clave de distribución de una PDT que se compila en Redshift o Aster.
distribution_style	Establece el estilo de distribución de una PDT que se compila en Redshift.
explore_source	Define una tabla derivada nativa que se basa en una exploración.
increment_key	Se agregó en la versión 21.4 Convierte la tabla derivada en una PDT incremental. La increment_key especifica el incremento de tiempo para el que se deben consultar los datos recientes y agregarlos a la PDT.
increment_offset	Se agregó en la versión 21.4 Se usa junto con el parámetro increment_key para las PDT incrementales. El increment_offset especifica la cantidad de períodos anteriores (en la granularidad de la clave de incremento) que se reconstruyen para tener en cuenta los datos que llegan tarde.
interval_trigger	Se agregó en la versión 21.20 El interval_trigger especifica un programa de reconstrucción para una tabla derivada persistente, en el formato "N (seconds | minutes | hours)"
materialized_view	Se agregó en la versión 21.10 La instrucción materialized_view: yes crea una vista materializada en tu base de datos para una tabla derivada.
indexes	Establece los índices de una PDT compilada en una base de datos tradicional (por ejemplo, MySQL, Postgres) o una clave de orden intercalada en Redshift.
partition_keys	Especifica que una PDT se particione por uno o más campos en Presto, o por un solo campo de fecha y hora en BigQuery.
persist_for (para derived_table)	Establece la antigüedad máxima de una PDT antes de que se vuelva a generar.
publish_as_db_view	La instrucción publish_as_db_view: yes crea una vista de base de datos estable para la PDT para permitir la consulta de la tabla fuera de Looker.
sortkeys	Establece las claves de orden de una PDT que se compila en Redshift.
sql (para derived_table)	Declara la consulta en SQL para una tabla derivada.
sql_create	Define una instrucción SQL CREATE para crear una PDT en un dialecto de base de datos que requiere comandos DDL personalizados.
sql_trigger_value	Especifica la condición que hace que se vuelva a generar una PDT.
table_compression	Especifica la compresión de tabla que se usará para una PDT en Amazon Athena.
table_format	Especifica el formato de tabla que se usará para una PDT en Amazon Athena.
Parámetros de refinamiento
view: +view_name	Agrega un signo más (+) delante de un nombre de vista existente para agregar un refinamiento a la vista existente. Consulta la página de documentación de refinamientos de LookML para obtener más información y casos de uso.
final	Indica que el refinamiento actual es el refinamiento final permitido para la vista. Consulta la página de documentación de refinamientos de LookML para obtener más información y casos de uso.
Parámetros que se deben evitar
distkey	Se quitó en la versión 3.26 Se reemplazó por distribution
view_label	Se evitó en la versión 4.4 Se reemplazó por label