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 .model.lkml archivos 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 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 explore declaraciones, junto con una serie de parámetros de configuración a nivel del modelo.

Esta página contiene vínculos a los parámetros de LookML a nivel del modelo. Por lo general, se escriben en la parte superior del archivo de modelo y no deben anidarse dentro de otros parámetros.

Ejemplo de uso

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

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 una concesión de acceso que limita el acceso de las estructuras de LookML solo a los usuarios a los que se les asigna un valor de atributo de 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 exploración.
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 base de datos para un modelo.
datagroup Crea una política de almacenamiento en caché de grupo 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 difiere del año calendario).
persist_for (para el modelo) Cambia la configuración de caché para 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 usarlo 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ó en la versión 3.52. Ya no es necesario.
template Se quitó en la versión 3.30 Ya no es necesario.