Parámetros de campo

En esta página, se vinculan 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 mediciones 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 de solo filtro que los usuarios pueden usar para proporcionar entradas 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 entradas a una etiqueta de Liquid {% parameter %}.

Ejemplo de uso

Mantén el cursor 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 se indica 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 = Grupo de dimensiones
  • M = Medir
  • 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 de forma simultánea
filter F Crea un campo solo de filtro para usarlo en un filtro basado en plantillas o una unión condicional
measure M Crea un campo de medición
parameter P Crea un campo solo de filtro que los usuarios pueden usar para proporcionar entradas a una etiqueta {% parameter %} de Liquid.
intervals DG Define el conjunto de dimensiones de duración que deseas en un dimension_group de type: duration.
timeframes DG Define el conjunto de dimensiones de período que deseas 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 desglose la medición o dimensión.
link D M Crea vínculos a otro contenido de Looker y externo
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 campos en una vista en el selector de campos.
group_item_label D DG M F Especifica una etiqueta que se usará para el campo debajo de su etiqueta de 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 mediciones

style D Cambia la forma en que aparecen los niveles 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 medición se puede 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 solo de filtro para usarlo en un filtro basado en plantillas.
filters M Restringe el cálculo de una medición según las limitaciones de la dimensión
skip_drill_filter D Impide que se agregue una dimensión a los filtros cuando se desglosa una medición.
Parámetros de sugerencias 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 una exploración. Looker puede usar una consulta básica de SELECT DISTINCT o la lógica completa de la exploración, incluidas las uniones y los parámetros sql_always_where y access_filter.
suggest_dimension D DG M F P Basa las sugerencias de un campo en los valores de una dimensión diferente.
suggest_explore D DG M F P Basa las sugerencias de un campo en los valores de una exploración diferente
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 de recuentos distintos para mediciones de type: count o type: count_distinct, de modo que la medición se pueda usar para el reconocimiento de agregaciones
approximate M Realiza un recuento aproximado para una medición de type: count_distinct. Consulta la página de documentación de approximate para ver 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 Habilita el acceso a los campos repetidos de Google BigQuery.
precision M Especifica la cantidad de decimales que se usarán cuando se realicen cálculos para las agregaciones simétricas 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 coincidan con los otorgamientos de acceso.
required_fields D M Requiere que se agreguen campos adicionales a una consulta cuando se elige un campo.
sql_distinct_key M Define las entidades únicas sobre las que se calculará una medición 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 medición 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 de 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 medición de type: list.
percentile M Especifica el valor fraccionario (el percentil N) para una medición 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 de duración o una dimensión de tipo de 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 de duración o una dimensión de tipo de duración
start_location_field D Define el campo que contiene la ubicación de inicio de 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 dimensiones, filtros o parámetros) 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 medición) M Especifica el tipo de medición
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 Asigna un formato al resultado de un campo con las opciones de estilo de Excel
value_format_name D M Aplica un formato integrado o personalizado al resultado de un campo
Parámetros de visualización
allow_fill D DG Determina si se permite el relleno 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ó en la versión 3.16 Se reemplazó por value_format