Parámetros del modelo

Un archivo de modelo especifica una conexión de base de datos, define el conjunto de Exploraciones que usan esa conexión y define las relaciones de las Exploraciones con otras vistas. A diferencia de otros elementos de LookML, un modelo no se declara con un parámetro "model" específico. En cambio, un desarrollador de LookML define un modelo creando un archivo de proyecto de LookML que tiene la extensión de archivo .model.lkml. El nombre del modelo se toma del nombre del archivo.

El nombre de un modelo debe ser único en todos los proyectos de tu instancia. Si tu instancia contiene dos archivos .model.lkml con el mismo nombre, es probable que encuentres errores, como errores de configuración del modelo en la página Proyectos de LookML y errores de renderización para los errores del panel de LookML, ya que los paneles de LookML usan el nombre del modelo en su formato de URL (<hostname>/dashboard/model_name::<dashboard_name>).

Puedes usar el validador de LookML para verificar si los nombres de los modelos están duplicados en tu instancia. Sin embargo, incluso si el validador de LookML detecta nombres de modelos duplicados en tu instancia, puedes enviar tu código a producción. Por lo tanto, asegúrate de corregir cualquier error de nombre de modelo duplicado antes de implementar tu proyecto de LookML en producción.

Por lo general, un archivo de modelo contiene cualquier declaración de explore, junto con una serie de parámetros de configuración a nivel del modelo.

En esta página, se vinculan los parámetros de LookML a nivel del modelo. Por lo general, se escriben en la parte superior del archivo del modelo y no deben anidarse dentro de otros parámetros.

Ejemplo de uso

Mantén el puntero 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

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

Definiciones de los parámetros

Nombre del parámetro	Descripción
Parámetros estructurales
access_grant	Crea un otorgamiento de acceso que limita el acceso a las estructuras de LookML solo a los usuarios a los que se les asigna un valor de atributo del usuario aprobado. Este parámetro tiene los subparámetros user_attribute y allowed_values.
explore	Expone una vista en el menú Explorar. Para obtener más información sobre las exploraciones y sus parámetros, consulta la página Referencia de parámetros de Explore.
include	Agrega archivos a un modelo
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.
Parámetros de visualización
label (para el modelo)	Cambia la forma en que aparece un modelo en el menú Explorar
Parámetros de filtro
case_sensitive (para el modelo)	Especifica si los filtros distinguen mayúsculas de minúsculas para un modelo.
Parámetros de búsqueda
connection	Cambia la conexión de la base de datos para un modelo
datagroup	Crea una política de almacenamiento en caché de grupos de datos para un modelo. Este parámetro tiene los subparámetros label, description, max_cache_age y sql_trigger.
fiscal_month_offset	Especifica el mes en que comienza tu año fiscal (si es diferente del año calendario).
persist_for (para el modelo)	Cambia la configuración de la caché de un modelo
persist_with (para el modelo)	Especifica el grupo de datos que se usará para la política de almacenamiento en caché del modelo.
week_start_day	Especifica el día de la semana en el que deben comenzar las dimensiones relacionadas con la semana.
Parámetros de visualización y formato
map_layer (para el modelo)	Crea mapas personalizados para usarlos con map_layer_name.
named_value_format	Crea un formato de valor personalizado para usar con value_format_name. Este parámetro tiene los subparámetros value_format y strict_value_format.
Parámetros que se deben evitar
scoping	Se quitó la versión 3.52 Ya no es obligatorio
template	Se quitó la versión 3.30 Ya no es obligatorio