Ver parámetros

Una vista representa una tabla de datos en Looker, ya sea que esa tabla sea nativa de tu base de datos o se haya creado con la función 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 en la tabla subyacente o a un cálculo en Looker. Estos campos se describen en la referencia de campos, la referencia de tipos de dimensiones y la referencia de tipos de mediciones.

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

Ejemplo de uso

Coloca el cursor sobre el nombre de un 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, ...]

  # 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
}

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 métricas 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 una extensión y no se puede exponer a los usuarios por sí sola.
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 parámetro hidden: no 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 los permisos de acceso.
sql_table_name (para la vista)	Cambia la tabla de SQL en la que se basa una vista
Parámetros de tablas derivadas
cluster_keys	Especifica que un 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 recompilación de la 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 un PDT compilado en Redshift
explore_source	Define una tabla derivada nativa basada en una exploración.
increment_key	Se agregó en la versión 21.4 Convierte la tabla derivada en una PDT incremental. El parámetro 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 los PDT incrementales. El increment_offset especifica la cantidad de períodos anteriores (en la granularidad de la clave de incremento) que se vuelven a generar para tener en cuenta los datos que llegan tarde.
interval_trigger	Se agregó la versión 21.20 El parámetro interval_trigger especifica un programa de recompilación para una tabla derivada persistente, en el formato "N (seconds | minutes | hours)"
materialized_view	Se agregó el 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 un PDT compilado en una base de datos tradicional (por ejemplo, MySQL o PostgreSQL) o una clave de ordenamiento intercalada en Redshift.
partition_keys	Especifica que una PDT se particione según uno o más campos en Presto, o bien según un solo campo de fecha y hora en BigQuery.
persist_for (para derived_table)	Establece la antigüedad máxima de un PDT antes de que se vuelva a generar.
publish_as_db_view	La instrucción publish_as_db_view: yes crea una vista estable de la base de datos para que la PDT pueda consultar la tabla fuera de Looker.
sortkeys	Establece las claves de ordenamiento de un PDT compilado 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 provoca que se regenere un PDT.
table_compression	Especifica la compresión de la tabla que se usará para un PDT en Amazon Athena
table_format	Especifica el formato de tabla que se usará para un PDT en Amazon Athena
Parámetros de refinamiento
view: +view_name	Agrega un signo más (+) delante del nombre de una vista existente para agregar un refinamiento a la vista existente. Consulta la página de documentación sobre 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 sobre refinamientos de LookML para obtener más información y casos de uso.
Parámetros que se deben evitar
distkey	Se quitó 3.26 Se reemplazó por distribution
view_label	Evita 4.4 Se reemplazó por label