Parámetros de campo

En esta página, se incluyen vínculos a todos los parámetros de LookML que definen campos.

Existen varios tipos de campos:

• Las dimensiones representan una columna en una tabla o un valor calculado basado en algún tipo de manipulación o combinación de columnas.
• Los grupos de dimensiones solo se usan con datos basados en el tiempo y te permiten crear muchas dimensiones basadas en el tiempo a la vez.
• Las medidas son similares a las funciones de agregación en SQL (por ejemplo, COUNT, SUM, AVG) y representan información sobre varias filas.
• Los filtros crean un campo solo de filtro que los usuarios pueden usar para proporcionar entrada a un filtro basado en plantillas o una unión condicional.
• Los parámetros crean un campo de solo filtro que los usuarios pueden usar para proporcionar entrada a una etiqueta {% parameter %} de Liquid.

Ejemplo de uso

Mantén el puntero sobre el nombre de un parámetro para ver una descripción rápida. Haz clic en el nombre de un parámetro para ir a 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
view: view_name {
  (dimension |dimension_group |measure |filter | parameter):field_name{
    intervals: [interval, interval, …]
    timeframes: [timeframe, timeframe, …]

    # ACTION AND LINKING PARAMETERS
    action: {
      label: "Label to Appear in Action Menu"
      url: "url"
      icon_url: "url"
      form_url: "url"
      param: {
        name:  "name string"
        value:  "value string"
      }
      # Possibly more param definitions
      form_param: {
        name:  "title"
        type: select | string | textarea
        label:  "desired label name"
        required:  yes | no
        default:  "value string"
        option: {
          name:  "name string"
          value:  "value string"
        }
        # Possibly more option definitions
      }
      # Possibly more form_param definitions
    }
    drill_fields: [field_or_set, field_or_set, ...]
    tags: ["string1", "string2", ...]
    link: {
      label: "desired label name;"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more link definitions
    # DISPLAY PARAMETERS
    alias: [old_field_name, old_field_name, ...]
    alpha_sort: yes | no
    description: "description string"
    group_label:  "desired group label name"
    group_item_label:  "label to use under the group label in the field picker"
    hidden: yes | no
    label: "desired label name"
    label_from_parameter: parameter_name
    order_by_field: dimension_name | dimension_group_name | measure_name 
    style: classic | interval | integer | relational
    view_label: "desired label name"

    # FILTER PARAMETERS
    can_filter: yes | no
    case_sensitive: yes | no
    filters: [dimension: "filter expression", dimension: "filter expression", ...]
    skip_drill_filter: yes | no

    # FILTER SUGGESTION PARAMETERS
    allowed_value: {
      label: "desired label name"
      value: "looker filter expression"
    }
    # Possibly more allowed_value definitions
    bypass_suggest_restrictions: yes | no
    full_suggestions: yes | no
    suggest_dimension: dimension_name
    suggest_explore: explore_name
    suggest_persist_for: "N (seconds | minutes | hours)"
    suggestable: yes | no
    suggestions: ["suggestion string", "suggestion string", "…"]<

    # QUERY PARAMETERS
    allow_approximate_optimization: yes | no
    approximate: yes | no
    approximate_threshold: N
    convert_tz: yes | no
    datatype: epoch | timestamp | datetime | date | yyyymmdd
    fanout_on: repeated_record_name
    precision: N
    primary_key: yes | no
    required_access_grants: [access_grant_name, access_grant_name, ...]
    required_fields: [field_name, field_name, ...]
    sql_distinct_key: SQL expression to define repeated entities ;;

    # VALUE AND FORMATTING PARAMETERS
    case: {
      when: {
        sql: SQL condition ;;
        label: "value"
      }
      # Possibly more when statements
    }
    default_value: "desired default value"
    direction: "row | column"
    end_location_field: dimension_name
    html: HTML expression using Liquid template elements ;;
    list_field: dimension_name

    percentile: Nth percentile
    sql: SQL expression to generate the field value ;;
    sql_end: SQL expression indicating the end time of a duration ;;
    sql_latitude: SQL expression to generate a latitude ;;
    sql_longitude: SQL expression to generate a longitude ;;
    sql_start: SQL expression indicating the start time of a duration ;;
    start_location_field: dimension_name
    synonyms: [synonym1, synonym2, ...]
    tiers: [N, N, ...]
    type: dimension_field_type # For a dimension field
    type: dimension_group_type
# For a dimension_group field
    type: measure_field_type   # For a measure field
    type: filter_field_type    # For a filter field
    type: parameter_field_type # For a parameter field
    string_datatype: unicode # For a dimension field
    units: feet | kilometers | meters | miles | nautical_miles | yards
    value_format: "excel-style formatting string"
    value_format_name: format_name

    # VISUALIZATION PARAMETERS
    allow_fill: yes | no
    map_layer_name: name_of_map_layer
  }
}

Definiciones de los parámetros

• D = Dimensión
• DG = Dimension Group
• M = Measure
• F = Filtro
• P = Parámetro

Nombre del parámetro	Tipos de campos válidos	Descripción
Parámetros estructurales
dimension	D	Crea un campo de dimensión
dimension_group	DG	Crea varias dimensiones basadas en el tiempo al mismo tiempo
filter	F	Crea un campo exclusivo para filtros para usar en un filtro basado en plantillas o una unión condicional
measure	M	Crea un campo de medición
parameter	P	Crea un campo de solo filtro que los usuarios pueden usar para proporcionar entrada a una etiqueta {% parameter %} de Liquid.
intervals	DG	Define el conjunto de dimensiones de duración que deseas incluir en un objeto dimension_group de type: duration.
timeframes	DG	Define el conjunto de dimensiones de período que deseas incluir en un dimension_group de type: time.
Parámetros de acción y vinculación
action	D M	Crea una acción de datos en un campo que permite a los usuarios realizar tareas en otras herramientas, directamente desde Looker.
drill_fields	D DG M	Declara la lista de campos que se mostrarán cuando se profundice en la medida o dimensión.
link	D M	Crea vínculos a otro contenido externo y de Looker
tags	D DG M F P	Agrega texto que se puede pasar a otras aplicaciones para proporcionar datos sobre un campo.
Parámetros de visualización
alias	D DG M F P	Permite que las URLs guardadas con nombres de campo antiguos sigan funcionando después de que se cambie el nombre de un campo
alpha_sort	D	Hace que un parámetro case ordene sus condiciones alfabéticamente.
description	D DG M F P	Agrega una descripción al campo que los usuarios pueden ver cuando colocan el cursor sobre él.
group_label	D DG M F	Agrupa los campos en una vista del selector de campos.
group_item_label	D DG M F	Especifica una etiqueta para usar en el campo debajo de la etiqueta de su grupo en el selector de campos.
hidden	D DG M F P	Oculta un campo de la IU de Explorar
label	D DG M F P	Cambia la forma en que aparece el nombre de un campo en el selector de campos.
label_from_parameter	D M	Cambia la forma en que aparece el nombre de un campo en una visualización según la entrada de un parameter.
order_by_field	D DG M	Ordena un campo según los valores de otro campo Se admite para dimensiones y grupos de dimensiones Compatible con las medidas
style	D	Cambia la forma en que aparecen los rangos en la IU de Looker para una dimensión de type: tier.
view_label	D DG M F P	Cambia los campos que aparecen en una vista en el selector de campos.
Parámetros de filtro
can_filter	D DG M	Determina si una dimensión o una métrica se pueden usar como filtro.
case_sensitive	D F	Determina si los filtros distinguen mayúsculas de minúsculas para una dimensión.
filter	F	Crea un campo de solo filtrado para usarlo en un filtro basado en plantillas
filters	M	Restringe el cálculo de una métrica según las limitaciones de la dimensión
skip_drill_filter	D	Evita que se agregue una dimensión a los filtros cuando se profundiza en una métrica.
Parámetros de sugerencia de filtros
allowed_value	P	Especifica las opciones para un parameter.
bypass_suggest_restrictions	D DG F P	Muestra sugerencias a los usuarios cuando se usa sql_always_where, pero no aplica esos límites a las sugerencias.
full_suggestions	D DG F P	Controla cómo Looker consulta tu base de datos para proporcionar sugerencias de los valores de un campo en el filtro de un Explorar. Looker puede usar una consulta SELECT DISTINCT básica o la lógica completa de la función Explorar, incluidos los parámetros de unión y sql_always_where y access_filter.
suggest_dimension	D DG M F P	Basa las sugerencias para un campo en los valores de una dimensión diferente
suggest_explore	D DG M F P	Basa las sugerencias para un campo en los valores de otra exploración
suggest_persist_for	D F P	Cambia la configuración de la caché para las sugerencias de filtros de Looker
suggestable	D DG M F P	Habilita o inhabilita las sugerencias para un campo
suggestions	D F P	Declara una lista de valores que se usarán para las sugerencias de un campo.
Parámetros de búsqueda
allow_approximate_optimization	M	Permite aproximaciones del recuento de valores distintos para las medidas de type: count o type: count_distinct, de modo que la medida se pueda usar para el reconocimiento agregado
approximate	M	Realiza un recuento aproximado para una medida de type: count_distinct. Consulta la página de documentación de approximate para obtener una lista de los dialectos que admiten este parámetro.
approximate_threshold	M	Establece el recuento en el que BigQuery cambia de un recuento exacto de valores distintos a un recuento aproximado de valores distintos.
convert_tz	D DG M F P	Inhabilita la conversión automática de zona horaria para un campo
datatype	D DG F M	Especifica el tipo de datos de tiempo que proporcionas a un campo.
fanout_on	D DG M	Permite el acceso a los campos repetidos de Google BigQuery
precision	M	Especifica la cantidad de posiciones decimales que se usarán cuando se realicen cálculos para los agregados simétricos de Looker.
primary_key	D	Declara una dimensión como la clave primaria de una vista.
required_access_grants	D DG F M P	Limita el acceso al campo solo a los usuarios cuyos valores de atributos de usuario coinciden con los permisos de acceso.
required_fields	D M	Requiere que se agreguen campos adicionales a una búsqueda cuando se elige un campo
sql_distinct_key	M	Define las entidades únicas para las que se calculará una medida de type: sum_distinct o type: average_distinct.
Parámetros de valor y formato
case	D	Crea un conjunto discreto de valores que puede tener una dimensión, determinados por condiciones de SQL
default_value	F P	Especifica un valor predeterminado para los campos de filtro
direction	M	Determina la dirección en la que se calcula una medida de type: percent_of_total o type: running_total cuando se usan tablas dinámicas.
end_location_field	D	Define el campo que contiene la ubicación final para un campo de type: distance.
html	D DG M	Modifica el resultado HTML de un campo con plantillas de Liquid
list_field	M	Declara la dimensión a partir de la cual se calculará una medida de type: list.
percentile	M	Especifica el valor fraccionario (el percentil N) para una métrica de type: percentile o type: percentile_distinct.
sql	D DG M F	Determina cómo se calculará un campo
sql_end	D DG	Define la hora de finalización de una duración para un grupo de dimensiones de tipo duración o una dimensión de tipo duración.
sql_latitude	D	Define la latitud de una dimensión de type: location.
sql_longitude	D	Define la longitud de una dimensión de type: location.
sql_start	D DG	Define la hora de inicio de una duración para un grupo de dimensiones de tipo duración o una dimensión de tipo duración.
start_location_field	D	Define el campo que contiene la ubicación de inicio para un campo de type: distance.
synonyms	D DG F M P	Especifica una lista de sinónimos de cadenas (palabras o frases) que se pueden usar para ayudar a los modelos de lenguaje grandes y a los desarrolladores de apps a comprender otras formas en que los usuarios pueden referirse a un campo.
tiers	D	Define los niveles para una dimensión de type: tier.
type (para dimensión, filtro o parámetro)	D F P	Especifica el tipo de dimensión, filtro o parámetro.
type (para el grupo de dimensiones)	DG	Especifica el tipo de grupo de dimensiones.
type (para la medida)	M	Especifica el tipo de medida.
string_datatype	D	Especifica el tipo de datos Unicode para un campo de type: string para SQL Server o MySQL
units	D	Especifica las unidades que se usarán para un campo de type: distance.
value_format	D M	Da formato al resultado de un campo con opciones de estilo de Excel
value_format_name	D M	Da formato al resultado de un campo con un formato integrado o personalizado
Parámetros de visualización
allow_fill	D DG	Determina si se permite el completado de dimensiones para una dimensión.
map_layer_name	D	Especifica una asignación de un valor de datos a una región geográfica que definiste en un mapa integrado o personalizado.
Parámetros que se deben evitar
decimals	D M	Se quitó la versión 5.4 Se reemplazó por value_format
format	D M	Se quitó 3.16 Se reemplazó por value_format