Referencia del parámetro de LookML por función

Descripción general

LookML es el lenguaje que usa Looker para describir las dimensiones, las agregaciones, los cálculos y las relaciones de datos en una base de datos SQL, y para crear consultas de SQL en esa base de datos. Si quieres conocer los pasos recomendados para aprender a usar LookML, consulta la página de documentación Pasos para aprender a LookML.

Puedes usar esta página de referencia para identificar cómo los parámetros de LookML pueden ayudarte a lograr los efectos del modelado de datos que deseas. Esta referencia también puede ser útil si estás viendo un modelo existente y deseas saber qué hace cada parámetro. También puede visitar las páginas de referencia individuales de las estructuras de LookML relevantes: model, view, Explore, join, manifest o fields.

Para obtener una introducción a estas estructuras de LookML y cómo se relacionan entre sí, consulta la página de documentación sobre términos y conceptos de LookML. Encontrará vínculos a recursos adicionales en la parte inferior de esta página para ayudarlo a identificar, comprender y también implementar elementos de LookML.

Cómo leer esta referencia

En esta página, los parámetros están organizados por las diferentes funciones que pueden lograr y los diferentes efectos que pueden lograr con ellos.

La entrada de la tabla en cada sección enumera lo siguiente:

Nombre del parámetro Nivel Descripción
Nombre y vínculo a la página de documentación principal del parámetro Nivel en el que se aplica el parámetro, con un vínculo a una lista de todos los demás parámetros disponibles en ese nivel: model, view, Explore, join, manifest o fields. Algunos parámetros se pueden usar en varios niveles en LookML. Descripción breve de la función del parámetro y si puede tener subparámetros

Algunos parámetros a nivel de campo se pueden usar con varios tipos de campo, por lo que en esta página marcamos cada parámetro a nivel de campo con íconos que indican los tipos de campo con los que se puede usar. Puede colocar el cursor sobre un ícono para ver su nombre o hacer clic en él para ver una página de referencia de ese tipo de campo.

D = Dimensión DG = Grupo de dimensiones F = Filtro M = Medir P = Parámetro


Parámetros estructurales

Estos parámetros de LookML afectan la estructura de un proyecto o sus archivos subyacentes.

Principales parámetros estructurales en un modelo o archivo Explorar

Como se muestra en la página de documentación Términos y conceptos de LookML, un proyecto contiene uno o más archivos de modelo, que usan parámetros para definir un modelo y sus Explorar y uniones.

En esta sección, se describen los principales parámetros estructurales que sueles poner en un archivo de modelo. Estos actúan como marco de trabajo para todos los demás parámetros. Por lo general, un parámetro explore se define en el nivel superior de un archivo de modelo, pero cuando se usa una tabla derivada nativa, se puede definir en un archivo Explorar.

Nombre del parámetro Nivel Descripción
explore Modelo Expone una vista en el menú Explorar. Para obtener más información sobre Explorar y sus parámetros, consulte la página de referencia Parámetros de Explorar. Afecta a Explorar el nombre y el menú. Este parámetro tiene muchos subparámetros enumerados en la página de referencia Explorar parámetros y en otra parte de esta página.
fields Explorar Limita los campos disponibles en Explorar desde su vista base y mediante las uniones de Explorar. Afecta los campos disponibles en el selector de campo.
include Modelo Agrega archivos a un modelo. Este parámetro también se puede usar en archivos de vista para tablas derivadas nativas.
join Unirse Une una vista adicional en Explorar. Consulta también la sección Unión de vistas a continuación.
test Modelo Crea una prueba de datos para verificar la lógica del modelo. La configuración del proyecto incluye una opción para exigir pruebas de datos. Cuando esto está habilitado para un proyecto, los desarrolladores deben ejecutar pruebas de datos antes de implementar los cambios en la producción. Este parámetro tiene los subparámetros explore_source y assert.

Parámetros estructurales principales en un archivo de vista

Como se muestra en la página de documentación Términos y conceptos de LookML, un proyecto contiene uno o más archivos de vista, que usan parámetros para definir esa vista, sus campos (incluidas las dimensiones y medidas) y sus conjuntos de campos.

En esta sección, se describen los principales parámetros estructurales que generalmente colocas en un archivo de vista.

Nombre del parámetro Nivel Descripción
dimension Vista (pero incluida en la página de referencia del campo) Crea un campo de dimensión. Afecta el comportamiento predeterminado del selector de campo.
dimension_group Vista (pero incluida en la página de referencia del campo) Crea varias dimensiones basadas en el tiempo al mismo tiempo. Afecta el comportamiento predeterminado del selector de campo.
fields Unirse Determina qué campos de una unión se incorporan a Explorar
measure Vista (pero incluida en la página de referencia del campo) Crea un campo de medición. Afecta el comportamiento predeterminado del selector de campo.
view Modelo (pero se usa en el archivo de vista) Crea una vista. Afecta el comportamiento predeterminado del selector de campo. Este parámetro tiene muchos subparámetros enumerados en la página de referencia de View Parameters y en otras partes de la página actual.

Parámetros estructurales auxiliares

Estos parámetros te ayudan a definir el comportamiento estructural que desees, como permitirte especificar conjuntos de campos, incluir ciertos archivos (y su contenido), reutilizar definiciones, etc.

Nombre del parámetro Nivel Descripción
+ (perfeccionamientos) Explorar y Ver Usa las mejoras de LookML para aprovechar las vistas y exploraciones de tus proyectos.
constant Manifiesto Define una constante de LookML que se puede usar en todo tu proyecto. Este parámetro tiene los subparámetros value y export.
extends Explorar y Ver Reutiliza la definición de otro objeto LookML, y agrega y anula subparámetros según lo desees. Este parámetro también se puede usar con los paneles de LookML.
extension Explorar y Ver Especifica que una pestaña Explorar, una vista o un panel no se puede usar directamente. En cambio, la definición está pensada como una plantilla para otros objetos, que usan extends según este objeto. Este parámetro también se puede usar con los paneles.
include Modelo Agrega archivos a un modelo. Este parámetro también se puede usar en archivos de vista para tablas derivadas nativas.
intervals Campos: DG Defina el conjunto de dimensiones de duración que desee en una dimension_group para los grupos de dimensiones configurados como type: duration. Afecta el comportamiento predeterminado del selector de campo.
local_dependency Manifiesto Especifica uno o más proyectos que contienen archivos que deseas incluir
parameter Vista (pero incluida en la página de referencia del campo) Crea un campo de solo filtro que los usuarios pueden usar para proporcionar una entrada a una etiqueta {% parameter %} líquida. Afecta el comportamiento predeterminado del selector de campo.
project_name Manifiesto Especifica el nombre del proyecto actual
remote_dependency Manifiesto Especifica uno o más repositorios remotos que contienen archivos que deseas incluir
set Ver Define un conjunto de dimensiones y medidas que se utilizarán en otros parámetros. Este parámetro se puede usar para limitar los campos disponibles a una unión y, por lo tanto, al selector de campos. Este parámetro también se puede usar para definir qué campos deben aparecer cuando un usuario analiza los datos. Este parámetro tiene un subparámetro fields.
timeframes Campos: DG Define el conjunto de dimensiones de período que desea en una dimension_group, para los grupos de dimensiones configurados como type: time. Afecta el comportamiento predeterminado del selector de campo.

Aplicaciones del framework de extensiones

Los desarrolladores de Looker pueden agregar una aplicación al framework de extensiones de Looker mediante el parámetro application en el archivo de manifiesto de un proyecto. Una vez que se agrega una extensión a un proyecto, los usuarios de Looker con los permisos adecuados pueden ver la extensión en el menú Explorar de Looker.

Si su administrador habilitó la función de Labs de Navegación mejorada, las extensiones aparecerán en la sección Aplicaciones del nuevo panel de navegación izquierdo mejorado.

Nombre del parámetro Nivel Descripción
application Manifiesto Agrega una aplicación al proyecto con el marco de extensión de Looker. Este parámetro tiene subparámetros que se describen en la página de documentación del parámetro application.

Explorar nombre y menú

El nombre de Explorar y su apariencia en el menú Explorar pueden ayudar a los usuarios a elegir la opción correcta según sus necesidades. Estos parámetros de LookML afectan el comportamiento predeterminado del nombre y la apariencia de Explorar en el menú Explorar.

Para obtener más información, consulta la sección Explora el nombre y el menú de la página de documentación Cambia el menú Explorar y el selector de campos.

Comportamiento predeterminado

El comportamiento predeterminado del nombre de Explorar y su apariencia en el menú Explorar se especifica con los parámetros que se detallan a continuación.

Nombre del parámetro Nivel Descripción
explore Modelo Expone una vista en el menú Explorar. Para obtener más información sobre Explorar y sus parámetros, consulte la página de referencia Parámetros de Explorar. Afecta a Explorar el nombre y el menú.

Cómo modificar el nombre y el menú Explorar

Los parámetros de la tabla que se muestra a continuación pueden modificar el nombre y la forma en que aparece en el menú Explorar.

Nombre del parámetro Nivel Descripción
description Explorar Agrega una descripción para una pestaña Explorar que aparece en la página Explorar y en el menú Explorar.
group_label Explorar Crea una etiqueta para usarla como encabezado en el menú Explorar
hidden Explorar Oculta una exploración del menú Explorar
label Explorar Cambia la forma en que aparece la pestaña Explorar en el menú Explorar
label Modelo Cambia la forma en que aparece un modelo en el menú Explorar

Selector de campos

La organización y los nombres visibles de las vistas y los campos del selector de campos pueden ayudar a los usuarios a comprender las visualizaciones y encontrar los campos que necesitan en Explorar. Estos parámetros de LookML afectan el comportamiento predeterminado del contenido, la apariencia y la organización del selector de campos.

Para obtener más información, consulta la sección Selector de campos de la página de documentación Cómo cambiar el menú Explorar y el Selector de campos.

Comportamiento predeterminado

La apariencia y el comportamiento predeterminados del selector de campos se especifican con los parámetros que se enumeran a continuación. Para obtener una explicación completa de este comportamiento predeterminado, consulta la sección Visualización del selector de campos de la página de documentación Cómo cambiar el menú Explorar y el Selector de campos.

Nombre del parámetro Nivel Descripción
dimension Vista (pero incluida en la página de referencia del campo) Crea un campo de dimensión.
dimension_group Vista (pero incluida en la página de referencia del campo) Crea varias dimensiones basadas en el tiempo al mismo tiempo
filter Vista (pero incluida en la página de referencia del campo) Crea un campo de solo filtro para usar en un filtro de plantilla o una unión condicional
measure Vista (pero incluida en la página de referencia del campo) Crea un campo de medición
parameter Vista (pero incluida en la página de referencia del campo) Crea un campo de filtro que los usuarios puedan usar para proporcionar entradas a una etiqueta de {% parameter %} líquida.
timeframes Campos: DG Define el conjunto de dimensiones de período que desea en una dimension_group, para los grupos de dimensiones configurados como type: time
intervals Campos: DG Define el conjunto de dimensiones de duración que desea en una dimension_group, para los grupos de dimensiones configurados como type: duration
view Modelo (pero que se encuentra en la página de referencia de la vista) Crea una vista

Cómo modificar los nombres de las vistas en el selector de campos

El nombre visible de una vista puede ayudar a los usuarios a comprender y encontrar los campos que necesitan en Explorar. Si una visualización muestra el nombre de la vista, entonces modificar la forma en que aparece el nombre puede ayudar a los usuarios a comprender la visualización. En esta sección, se describen los parámetros de LookML que afectan los nombres de las vistas en el selector de campos. Para obtener una explicación completa de este tema, consulta la sección Selector de campos de la página de documentación Cómo cambiar el menú Explorar y el Selector de campos.

Nombre del parámetro Nivel Descripción
label Ver Especifica cómo aparecerá el nombre de la vista en el selector de campo.
view_label Explorar Especifica cómo se etiquetará un grupo de campos de la vista base de Explorar en el selector de campo.
view_label Unirse Cambia la forma en que aparece el nombre de la vista en la combinación en el selector de campo

Modificación de las listas de campos en el selector de campos

Modificar la forma en que se enumeran los campos puede ayudar a tus usuarios a comprender las visualizaciones y encontrar los campos que necesitan en Explorar. La forma en que se enumeran los campos en el selector de campos puede modificarse con los parámetros de la siguiente tabla. Para obtener una explicación completa de este tema, consulta la sección Selector de campos de la página de documentación Cómo cambiar el menú Explorar y el Selector de campos.

Nombre del parámetro Nivel Descripción
description Campos: D DG M F P Agrega una descripción al campo que los usuarios pueden ver cuando se desplazan.
fields Explorar Limita los campos disponibles en Explorar desde su vista base y mediante las uniones de Explorar. Afecta los campos disponibles en el selector de campo.
fields Unirse Determina qué campos de una unión se incorporan a Explorar
hidden Campos: D DG M F P Oculta un campo de la IU de Explorar
label Campos: D DG M F P Cambia la forma en que aparece el nombre de un campo en el selector de campo
label_from_parameter Campos: D M Cambia la forma en que aparece el nombre de un campo en una visualización según la entrada a una parameter

Modifica la organización de los campos en el selector de campos

La organización de los campos puede ayudar a que los usuarios encuentren los campos que necesitan en Explorar. Los parámetros de la tabla a continuación pueden modificar la organización de los campos en el selector de campos. Para obtener una explicación completa de este tema, consulta la sección Selector de campos de la página de documentación Cómo cambiar el menú Explorar y el Selector de campos.

Nombre del parámetro Nivel Descripción
group_label Campos: D DG M F Agrupa los campos en una vista en el selector de campo
view_label Campos: D DG M F P Cambia los campos que aparecen en una vista en el selector de campo

Localización

Si localizas tu modelo, los parámetros de configuración de ubicación te permiten personalizar la visualización de las etiquetas y descripciones en la IU de Looker según la configuración regional del usuario. Consulta la página de documentación Localización del modelo para obtener información sobre la configuración del modelo para la localización.

Nombre del parámetro Nivel Descripción
localization_settings Manifiesto Especifica la información de localización para tu modelo. Este parámetro tiene los subparámetros default_locale y localization_level.
localization_level Manifiesto Especifica si tu modelo permite strings sin traducción
default_locale Manifiesto Especifica la configuración regional que se usará como la opción predeterminada del modelo para traducir strings

Valores y visualización de datos

Modificar los valores y la presentación de los datos en la sección Datos de Explorar puede ayudar a los usuarios a comprender sus resultados. Es posible que desees modificar o restringir los tipos de datos de tus dimensiones o medidas, cambiar el formato de los datos que ven los usuarios, completar los valores faltantes o cambiar otras opciones de visualización.

Los usuarios también pueden definir sus propios cálculos de tablas que se muestran en la sección Datos. Sin embargo, cuando sea posible, debes definir las dimensiones y medidas en LookML para que el cálculo correcto se realice una vez y, luego, se use de manera coherente en varias consultas.

Valores de datos para varios tipos de campo

Estos parámetros te permiten cambiar los valores de datos para varios tipos de campo.

Nombre del parámetro Nivel Descripción
case Campos: D M Crea un conjunto discreto de valores que una dimensión puede tener determinados por las condiciones de SQL. Este parámetro tiene los subparámetros when y else.
sql Campos: D DG M F Determina cómo se calculará un campo
type (para dimensión, filtro o parámetro) Campos: D F P Especifica el tipo de dimensión, filtro o parámetro
type (para grupo de dimensiones) Campos: DG Especifica el tipo de grupo de dimensiones
type (para medición) Campos: M Especifica el tipo de medida

Valores de datos para tipos de dimensiones específicos

Puedes modificar los valores de los datos para algunos tipos de dimensiones mediante parámetros de tipo específico.

Dimensiones de type: date o type: datetime

Nombre del parámetro Nivel Descripción
convert_tz Campos: D DG F M P Inhabilita la conversión automática de zona horaria para el campo
datatype Campos: D DG F M Especifica el tipo de datos de tiempo que proporcionas al campo.
fiscal_month_offset Modelo Especifica el mes en que comienza su año fiscal (si difiere del año calendario).
week_start_day Modelo Especifica el día de la semana en que deberían comenzar las dimensiones relacionadas con la semana.

Dimensiones de type: distance

Nombre del parámetro Nivel Descripción
end_location_field Campos: D Define el campo que contiene la ubicación final para un campo de type: distance. Este parámetro también se considera un parámetro estructural.
start_location_field Campos: D Define el campo que contiene la ubicación de inicio de un campo de type: distance
units Campos: D Especifica la unidad que se usará en los campos de type: distance.

Dimensiones de type: location

Nombre del parámetro Nivel Descripción
sql_latitude Campos: D Define la latitud de una dimensión de type: location
sql_longitude Campos: D Define la longitud de una dimensión de type: location

Dimensiones de type: string

Nombre del parámetro Nivel Descripción
string_datatype Campos: D Especifica el tipo de datos Unicode de una dimensión de type: string para SQL Server o MySQL

Dimensiones de type: tier

Nombre del parámetro Nivel Descripción
tiers Campos: D Define los niveles de una dimensión de type: tier

Grupos de dimensiones de type: duration o dimensiones de type: duration_x

Nombre del parámetro Nivel Descripción
sql_start Campos: D DG Define la hora de inicio de una duración para un grupo de dimensiones de type: duration o una dimensión de type: duration_x
sql_end Campos: D DG Define la hora de finalización de una duración para un grupo de dimensiones de type: duration o una dimensión de type: duration_x

Valores de datos para medidas

La mayoría de estos parámetros se limitan a tipos de mediciones específicos, como se especifica en la tabla. Para crear un recuento filtrado por un valor dimensional, consulte Cómo filtrar los recuentos por dimensión. Para crear una medida que calcule el porcentaje entre dos campos, consulte Porcentajes.

Nombre del parámetro Nivel Descripción
approximate Campos: M Realiza un recuento aproximado para medidas de type: count_distinct. Consulta la página de documentación de approximate para obtener una lista de dialectos que admiten este parámetro.
approximate_threshold Campos: M Establece el recuento en el que BigQuery cambia de un recuento exacto distinto a uno aproximado.
direction Campos: M Determina la dirección en que se calculan las mediciones de type: percent_of_total o de type: running_total cuando se usan pivotes.
list_field Campos: M Declara la dimensión desde la que se calculará una medida de type: list. Este parámetro también se considera un parámetro estructural.
percentile Campos: M Especifica el valor fraccionario (el percentil) para una medida de type: percentile o type: percentile_distinct
primary_key Campos: D Declara una dimensión como la clave primaria de una vista
sql_distinct_key Campos: M Define las entidades únicas sobre las que se calculará una medida distinta, como type: sum_distinct o type: average_distinct.
symmetric_aggregates Explorar Especifica si los agregados simétricos están habilitados para Explorar. Este parámetro también se enumera para los parámetros que afectan cómo se comporta una unión. Consulta también la sección Unión de vistas a continuación.

Formatos de datos

Para que los usuarios puedan leer los valores de datos con más facilidad, formatea los datos mediante los parámetros de la tabla siguiente.

Nombre del parámetro Nivel Descripción
html Campos: D DG M Modifica el resultado HTML de un campo mediante plantillas líquidas.
named_value_format Modelo 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.
style Campos: D Cambia la forma en que aparecen los niveles en la IU de Looker para una dimensión de type: tier.
value_format Campos: D M Aplica formato al resultado de un campo mediante las opciones de estilo Excel
value_format_name Campos: D M Da formato al resultado de un campo mediante un formato integrado o personalizado.

Orden y relleno de datos

Para la mayoría de los campos, el orden de clasificación es sencillo: solo una clasificación alfanumérica de los valores. En algunos casos, es posible que desees que los resultados de una nueva declaración de LookML case o de Old LookML sql_case ordenen un orden en particular. O tal vez desees ordenar los valores por el valor de otro campo. También puedes usar el parámetro allow_fill para habilitar o impedir que los usuarios le pidan a Looker que rellene las fechas y los valores faltantes de un campo.

Nombre del parámetro Nivel Descripción
allow_fill Campos: D DG Determina si se permite el relleno de dimensiones para una dimensión.
alpha_sort Campos: D Hace que un parámetro case ordene las condiciones alfabéticamente.
order_by_field Campos: D DG

Ordena un campo según los valores de otro campo.

Compatible con grupos de dimensiones

Visualiza datos de ubicación

Looker proporciona una variedad de mapas que puede poner a disposición para visualizar los valores de datos de ubicación en la sección Visualización. También puede crear y usar mapas personalizados para las visualizaciones.

Nombre del parámetro Nivel Descripción
map_layer Modelo Crea mapas personalizados para usarlos con map_layer_name. Este parámetro tiene muchos subparámetros enumerados en la página map_layer.
map_layer_name Campos: D Especifica una asignación desde un valor de datos a una región geográfica que definiste en un mapa integrado o personalizado.

Acciones en las que se puede hacer clic para valores de datos

Perforación

En Looker, cada resultado de consulta puede ser el punto de partida para otra consulta. Los usuarios pueden hacer clic en un valor de datos para analizar los datos. También puede usar LookML para especificar qué campos se mostrarán cuando el usuario explore los datos. Las dimensiones y medidas tienen diferentes comportamientos predeterminados para las perforaciones.

Para obtener información sobre las opciones avanzadas para crear una ruta de acceso de perforación personalizada, consulte el artículo Perforación de datos más potente del Centro de ayuda.

Nombre del parámetro Nivel Descripción
drill_fields Campos: D DG M Declara la lista de campos que se mostrarán cuando se realice un desglose de la medida o dimensión
set Ver Define un conjunto de dimensiones y medidas que se utilizarán en otros parámetros. Este parámetro se usa para limitar los campos disponibles para una unión y, por lo tanto, para el selector de campos. Este parámetro también se puede usar para definir qué campos deben aparecer cuando un usuario accede a los datos. Consulta también Cómo usar conjuntos para obtener detalles de desglose en la página de documentación Conceptos básicos de LookML adicionales.

Acciones de datos

En ocasiones, es posible que los usuarios deseen activar otros eventos después de ver los datos. Si usas el Centro de acciones de Looker, puedes especificar que los campos con ciertos tags puedan usar servicios integrados específicos. También puedes usar acciones de datos a fin de especificar qué opciones están disponibles para los usuarios en un campo.

Nombre del parámetro Nivel Descripción
action Campos: D M Crea una acción de datos en un campo que permite a los usuarios realizar tareas en otras herramientas, directamente desde Looker. Este parámetro tiene muchos subparámetros enumerados en la página action.
tags Campos: D DG M F P Agrega texto que se puede pasar a otras aplicaciones para proporcionar datos sobre un campo.

Vinculando

Puede permitir que sus usuarios hagan clic en un valor de datos para navegar a una URL relacionada. Con estos parámetros, puede especificar qué campos mostrar cuando el usuario accede a los datos, así como el texto que se mostrará, la URL de destino y un ícono de página para el sitio web de destino.

Nombre del parámetro Nivel Descripción
link Campos: D M Crea vínculos a otro Looker y contenido externo. Este parámetro tiene los subparámetros label, url y icon_url. Para ver las opciones avanzadas que usan link, consulta también el artículo Perforación de datos más potente en el Centro de ayuda.

Filtros

Los usuarios pueden aplicar filtros a sus consultas en Explorars, Apariencias y Paneles de control.

Puedes ayudar a seleccionar la experiencia del usuario si especificas el comportamiento del filtro directamente en LookML, como agregar filtros útiles o asegurarte de que no creen accidentalmente una consulta que genere demasiada demanda en los recursos de tu base de datos. Puedes especificar comportamientos de filtro, como distinción entre mayúsculas y minúsculas, valores predeterminados y sugerencias de filtro que Looker puede generar mientras el usuario escribe.

Si desea obtener un análisis más general del filtrado en LookML, consulte Cómo filtrar conjuntos de resultados en la página de documentación Conceptos básicos adicionales de LookML. Para conocer las opciones avanzadas con filtros de plantilla, consulte los artículos Filtros de plantilla y parámetros de líquido y Filtros de plantilla avanzados en el Centro de ayuda.

Puedes encontrar una lista completa de las expresiones de filtro y la sintaxis en la página de documentación Expresiones de filtro de Looker.

Filtros obligatorios con valores fijos

Estos parámetros le permiten especificar filtros que siempre se aplicarán.

Consulte también Cómo filtrar los recuentos por dimensión en la página de documentación Conceptos básicos de LookML adicionales.

Nombre del parámetro Nivel Descripción
access_filter Explorar Agrega filtros específicos del usuario a Explorar. Este parámetro tiene los subparámetros field y user_attribute.
sql_always_having Explorar Inserta condiciones en la cláusula HAVING de la consulta que un usuario no puede cambiar ni quitar para esta exploración
sql_always_where Explorar Inserta condiciones en la cláusula WHERE de la consulta que un usuario no puede cambiar ni quitar para esta exploración
sql_where Unirse Si esta unión se incluye en la consulta, inserta condiciones en la cláusula WHERE de la consulta que un usuario no puede cambiar ni quitar para esta exploración. Solo para BigQuery Este parámetro también se puede considerar un parámetro de filtro.

Filtros obligatorios con valores cambiables

Estos parámetros le permiten especificar los filtros que deben utilizarse, pero le permiten al usuario cambiar los valores de los filtros.

Nombre del parámetro Nivel Descripción
always_filter Explorar Agrega filtros que un usuario puede cambiar, pero no quitar, a Explorar. Este parámetro tiene un subparámetro filters.
filter Campos: F Crea un campo de solo filtro para usar en un filtro con plantilla
filters Campos: M Restringe el cálculo de una medida según las limitaciones de dimensión

Prevención de filtros

Estos parámetros le permiten evitar que un usuario utilice un campo como filtro, ya sea en todas las circunstancias o solo durante las perforaciones.

Nombre del parámetro Nivel Descripción
can_filter Campos: D DG M Determina si una dimensión o medida se puede usar como filtro
skip_drill_filter Campos: D Impide que se agreguen dimensiones a los filtros cuando se realiza un desglose de una medida

Filtros condicionales

En algunos casos, es posible que desees especificar que el usuario debe usar uno de varios filtros para limitar su consulta. Por ejemplo, el usuario debe limitar la consulta por fecha o por región.

Además del parámetro que aparece a continuación, también puede consultar Filtra conjuntos de resultados en la página de documentación Conceptos básicos de LookML adicionales.

Nombre del parámetro Nivel Descripción
conditionally_filter Explorar Agrega filtros a Explorar si un usuario no agrega sus propios filtros de una lista específica. Este parámetro tiene los subparámetros filters y unless.

Comportamiento de valor de filtro

A fin de facilitar el filtrado para sus usuarios, puede proporcionar un valor predeterminado para el filtro o tratar los valores de filtro como que no distinguen entre mayúsculas y minúsculas.

Nombre del parámetro Nivel Descripción
case_sensitive Explorar Especifica si los filtros distinguen mayúsculas de minúsculas para Explorar
case_sensitive Campos: D F Especifica si los filtros distinguen entre mayúsculas y minúsculas de una dimensión
case_sensitive Modelo Especifica si los filtros distinguen mayúsculas de minúsculas para un modelo
default_value Campos: F P Especifica un valor predeterminado para los campos de filtro.

Filtrar sugerencias

Las sugerencias de filtro son una excelente manera de ayudar a sus usuarios a filtrar datos correctamente. En algunos casos, puede ser útil inhabilitar las sugerencias o cambiar su comportamiento.

Estos parámetros de LookML afectan el comportamiento predeterminado de las sugerencias de filtros.

Comportamiento predeterminado

De forma predeterminada, las sugerencias de Looker para un campo de filtro determinado se basan en todos los valores únicos de los datos de ese campo.

Habilitar o inhabilitar las sugerencias

Si crees que un campo tiene una gran cantidad de valores únicos, podría tener sentido inhabilitar las sugerencias de filtros para ese campo. Esto evita que el usuario tenga que leer demasiadas sugerencias y que la base de datos no tenga que proporcionarlas. Puedes habilitar o inhabilitar las sugerencias de filtros en varios niveles.

Nombre del parámetro Nivel Descripción
suggestable Campos: D DG M F P Habilitar o inhabilitar las sugerencias para un campo
suggestions Ver Habilita o inhabilita las sugerencias para todas las dimensiones de esta vista

Valores de sugerencias

De forma predeterminada, Looker genera sugerencias de filtros basados en los valores únicos de un campo. En algunos casos, las sugerencias podrían ser más útiles si especificaste los valores que Looker debe sugerir, como los valores más probables. Además, si limita el acceso a algunos valores en los datos, puede optar por aplicar o no esos límites a las sugerencias.

Nombre del parámetro Nivel Descripción
allowed_value Campos: P Especifica las opciones para un parameter. Este parámetro tiene los subparámetros label y value.
bypass_suggest_restrictions Campos: 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 Campos: D DG F P Muestra sugerencias a los usuarios cuando se usa sql_always_where y aplica esos límites a las sugerencias
suggest_dimension Campos: D DG M F P Basa las sugerencias de un campo en los valores de una dimensión diferente
suggest_explore Campos: D DG M F P Basa las sugerencias de un campo en los valores de una exploración diferente
suggestions Campos: D F P Declara una lista de valores que se usarán para las sugerencias de un campo

Sugerencias de almacenamiento en caché

De forma predeterminada, Looker genera sugerencias de filtros basados en los valores únicos de un campo. Esos valores se almacenan en caché para ayudar a mejorar el rendimiento, pero puede cambiar el período durante el que se usarán. Si los datos son bastante estables, considera usar un tiempo más prolongado para mejorar el rendimiento de obtención de esos valores de sugerencias.

Nombre del parámetro Nivel Descripción
suggest_persist_for Campos: D F P Cambia la configuración de caché para las sugerencias de filtro de Looker

Unir vistas

Como se analizó en Cómo trabajar con uniones en LookML, las uniones habilitan la exploración de datos de más de una vista al mismo tiempo. Puede combinar distintas vistas para permitir que los usuarios vean cómo se relacionan las partes de sus datos entre sí.

Las uniones se definen en el archivo de modelo para establecer la relación entre una Explorar y una vista. Las uniones conectan una o más vistas en una sola exploración, ya sea directamente o a través de otra vista unida.

Estos parámetros de LookML te permiten crear uniones y especificar cómo funcionan.

A qué unirse

Existe una variedad de parámetros que especifican a qué vistas unirse, en situaciones generales y específicas. Además, puede especificar qué campos se incluirán en la combinación.

Nombre del parámetro Nivel Descripción
always_join Explorar Especifica qué combinaciones deben aplicarse siempre a una exploración
fields Unirse Determina qué campos de una unión se incorporan a Explorar
from Unirse Especifica la vista en la que se basará una unión
include Modelo Agrega archivos a un modelo. Solo las vistas de los archivos disponibles en el modelo se pueden usar para las uniones.
join Explorar Une una vista adicional en Explorar. Para obtener más información sobre las uniones y sus parámetros, consulta la página de referencia de los parámetros de unión. Este parámetro tiene muchos subparámetros enumerados en otra parte de la página actual.
required_joins Unirse Especifica qué uniones deben aplicarse a una exploración cuando se seleccionan campos de una combinación determinada
sql_table_name Unirse Especifica la tabla de la base de datos en la que se basará una unión

Cómo unirse

Puedes especificar cómo funcionan las uniones entre vistas y cuál será la condición de la unión. También debes especificar una clave primaria a fin de que Looker pueda usar agregaciones simétricas a fin de proporcionar resultados correctos para las funciones de agregación.

Para obtener más información sobre las agregaciones simétricas, también puedes consultar los artículos del Centro de ayuda Una explicación simple de las agregaciones simétricas o "¿Por qué en Google SQL tiene este aspecto?" y El problema de las distribuciones de SQL.

Nombre del parámetro Nivel Descripción
foreign_key Unirse Especifica una relación entre Explorar y una unión mediante la clave primaria de la vista unida
outer_only Unirse Especifica si todas las consultas deben usar una unión externa
primary_key Campos: D Declara una dimensión como la clave primaria de una vista
relationship Unirse Declara que una unión tiene una relación de uno a uno, varios a uno, uno a varios o varios a varios
sql_on Unirse Especifica una relación entre Explorar y una unión mediante la escritura de una cláusula ON de SQL
symmetric_aggregates Explorar Especifica si los agregados simétricos están habilitados para Explorar. Este parámetro también se muestra con los parámetros que afectan el valor de medición.
type Unirse Declara una unión como izquierda, completa, interna o en forma de cruz.

Almacenamiento en caché

Looker reduce la carga de su base de datos y mejora el rendimiento mediante el uso de los resultados almacenados en caché de consultas anteriores cuando están disponibles y permitidos por su política de almacenamiento en caché. Además, puede crear consultas complejas como tablas derivadas persistentes (PDT), que almacenan sus resultados para simplificar consultas posteriores. Cuando planifiques el almacenamiento en caché, debes tener en cuenta el rendimiento y la actualidad de los datos para tus usuarios.

Almacenar consultas en caché

Puede usar grupos de datos para integrar Looker de forma más estrecha con la fase de ETL (extracción, transformación y carga) de su canalización de datos. Por ejemplo, si carga datos por lotes a través de un trabajo de ETL nocturno, puede notar en Looker que ETL ha finalizado y borrar cualquier consulta en caché relacionada.

Para obtener más información, consulta la página de documentación Consultas en caché y vuelve a compilar los PDT con grupos de datos.

Nombre del parámetro Nivel Descripción
datagroup Modelo Crea una política de almacenamiento en caché de grupos de datos para el modelo. Este parámetro tiene los subparámetros max_cache_age, sql_trigger, label y description.
persist_for Explorar Cambia la configuración de caché para Explorar. En su lugar, considera usar la mayor funcionalidad de un parámetro de grupo de datos.
persist_for Modelo Cambia la configuración de la caché para un modelo. En su lugar, considera usar la mayor funcionalidad de un parámetro de grupo de datos.
persist_with Explorar Especifica el grupo de datos que se usará para la política de almacenamiento en caché de Explorar
persist_with Modelo Especifica el grupo de datos que se usará para la política de almacenamiento en caché del modelo

Almacenamiento en caché de sugerencias de filtros

De forma predeterminada, Looker genera sugerencias de filtros basados en los valores únicos de un campo. Esos valores se almacenan en caché para ayudar a mejorar el rendimiento, pero puede cambiar el período durante el que se usarán. Si los datos son bastante estables, considera usar un tiempo de caché más largo para mejorar el rendimiento de obtención de esos valores de sugerencias.

Nombre del parámetro Nivel Descripción
suggest_persist_for Campos: D F P Cambia la configuración de caché para las sugerencias de filtro de Looker

Almacenamiento en caché para tablas derivadas persistentes

Consulta los parámetros de regeneración y almacenamiento en caché de tablas derivadas persistentes a continuación para obtener información sobre los parámetros que afectan el almacenamiento en caché de tablas derivadas persistentes.

Tablas derivadas

Como se explicó en el instructivo Tablas derivadas en Looker, las tablas derivadas son herramientas importantes en Looker. Le permiten crear tablas nuevas que aún no existen en su base de datos, expandir la sofisticación de sus análisis y mejorar el rendimiento de las consultas.

Para obtener más información, consulta las tablas derivadas y tablas de hechos y las tablas derivadas persistentes en la página de documentación Términos y conceptos de LookML.

Parámetros estructurales para todas las tablas derivadas

Las tablas derivadas se pueden definir con SQL o LookML. Todas las tablas derivadas comienzan con este parámetro:

Nombre del parámetro Nivel Descripción
derived_table Ver Basa una vista en una tabla derivada. Este parámetro tiene muchos subparámetros enumerados en cualquier otra parte de la página actual y se muestra en la tabla de uso de ejemplo en la página de documentación Ver parámetros.

Parámetros estructurales para tablas derivadas nativas

Las tablas derivadas nativas son mucho más fáciles de leer, comprender y explicar mientras modela sus datos.

Los parámetros de la siguiente tabla se usan para definir los datos de origen de una tabla derivada nativa. Se describen con más detalle y se muestran en el ejemplo de uso en la página de documentación del parámetro explore_source.

Nombre del parámetro Nivel Descripción
bind_all_filters Ver Usa explore_source para pasar todos los filtros de la consulta Explorar a la subconsulta de la tabla derivada nativa. Consulta la página de documentación del parámetro explore_source para ver un ejemplo.
NOTA: El parámetro explore_source puede tener el subparámetro bind_all_filters o el subparámetro bind_filters, pero no ambos.
bind_filters Ver Usa explore_source para pasar un filtro de la consulta Explore a la subconsulta nativa de tabla derivada. Para configurar esta función, usa el subparámetro from_field a fin de especificar un campo definido en la vista de tabla derivada nativa o accesible en la pestaña Explorar a la que se une la tabla derivada nativa. En el entorno de ejecución, los filtros de from_field en Explorar se pasarán a to_field en la subconsulta nativa de tabla derivada. Consulta la página de documentación del parámetro explore_source para ver un ejemplo.
NOTA: El parámetro explore_source puede tener el subparámetro bind_all_filters o el subparámetro bind_filters, pero no ambos.
column Ver Úsala en explore_source a fin de especificar una columna para incluir en la tabla. Este parámetro tiene un subparámetro field.
derived_column Ver Especifica una columna en el explore_source con una expresión en el espacio de nombres de las columnas internas. Las expresiones de SQL agregadas no funcionarán aquí, ya que no hay agrupación de SQL en este paso. Esto es especialmente útil para definir funciones analíticas cuando corresponda. Este parámetro tiene un subparámetro sql.
explore_source Ver Genera SQL para una tabla derivada en función de su Explorar asociado. explore_source tiene varios subparámetros descritos en las otras filas de esta tabla y en su página de documentación principal.
expression_custom_filter Ver Especifica una expresión de filtro personalizado en una consulta explore_source. Opcional.
filters Ver Especifica una expresión de filtro personalizado en una consulta explore_source. Opcional.
include Modelo Incluye los archivos que contienen los campos a los que se hará referencia en la tabla, como se explica en la página de documentación de explore_source. Consulta la página de documentación principal del parámetro include para conocer otros usos, como agregar archivos a modelos y vistas, y consulta Vistas de unión con el fin de usar include para crear uniones.
limit Ver Especifica el límite de filas de la consulta. Opcional.
sorts Ver Opcional. Especifica un orden para este explore_source. Entre corchetes, incluye el nombre del campo para ordenar, seguido de : y, luego, indica si el campo debe ordenarse de forma ascendente o descendente con la palabra clave asc o desc.
timezone Ver Configura la zona horaria para la consulta explore_source. Para tablas derivadas efímeras (no persistentes), configura este parámetro en query_timezone para usar de forma automática la zona horaria de la consulta en ejecución. Si no se especifica una zona horaria, de forma predeterminada, la consulta explore_source no realizará ninguna conversión de zona horaria y funcionará en la zona horaria de la base de datos.

Parámetros estructurales para tablas derivadas de SQL

Para las tablas derivadas de SQL, usa el parámetro que se indica a continuación.

Nombre del parámetro Nivel Descripción
sql (para tabla_Derivada) Ver Declara la consulta de SQL para una tabla derivada

Parámetros estructurales para la definición de datos personalizados

Para los dialectos de bases de datos que requieren un lenguaje de definición de datos personalizado (DDL), usa los parámetros que se enumeran a continuación. Por ejemplo, si el dialecto de tu base de datos no admite CREATE TABLE as SELECT emitido como una sola instrucción de SQL, usa el parámetro create_process para compilar un PDT en varios pasos:

Nombre del parámetro Nivel Descripción
create_process Ver Especifica una serie de instrucciones de SQL que se ejecutarán de a una por vez, en el orden indicado. Cada instrucción de SQL individual se especifica con el subparámetro sql_step.
sql_create Ver Define una sentencia SQL CREATE para crear un PDT en un dialecto de base de datos que requiere comandos de DDL personalizados

Parámetros de regeneración y almacenamiento en caché para tablas derivadas persistentes

Como se explicó en la sección Almacenamiento en caché, puedes usar grupos de datos para administrar la caché y equilibrar la eficiencia con la actualización de datos.

Puede usar los grupos de datos para regenerar las tablas derivadas persistentes (PDT) cuando los datos nuevos estén disponibles. Como alternativa, puede especificar que los PDT se vuelvan a generar con poca frecuencia, aunque las tablas subyacentes se actualicen con frecuencia, de modo que las consultas en los PDT se puedan almacenar en caché por más tiempo.

Para obtener más información, consulta las estrategias de persistencia en la página de documentación Tablas derivadas de Looker y la página de documentación Almacena en caché las consultas y vuelve a compilar PDT con grupos de datos.

Nombre del parámetro Nivel Descripción
datagroup_trigger Ver Especifica el grupo de datos que se usará para la política de recompilación de PDT
persist_for (para tabla_Derivada) Ver Establece la antigüedad máxima de un PDT antes de que se vuelva a generar. Considera usar el parámetro datagroup_trigger más potente.
sql_trigger_value Ver Especifica la condición que genera la regeneración de un PDT. Considera usar el parámetro datagroup_trigger más potente.

Parámetros de eficiencia de consultas para tablas derivadas

Según el dialecto de tu base de datos, existen algunos parámetros que puedes usar para mejorar la eficiencia de tu tabla derivada.

Nombre del parámetro Nivel Descripción
cluster_keys Ver Especifica que un PDT o una tabla agregada se agrupan en clústeres en uno o más campos en BigQuery
Se agregó compatibilidad con cluster_keys en Snowflake
Se agregó compatibilidad con cluster_keys con tablas agregadas
distribution Ver Configura la clave de distribución de un PDT o una tabla agregada que se compila en Redshift o Aster
Se agregó compatibilidad para distribution con tablas agregadas
distribution_style Ver Configura el estilo de distribución de un PDT o una tabla agregada que se crea en Redshift
Se agregó compatibilidad con distribution_style con tablas agregadas
increment_key Ver ADDED 21.4 Convierte la tabla derivada en un PDT incremental. El increment_key especifica el incremento de tiempo para el cual se deben consultar los datos actualizados y se deben anexar al PDT.
increment_offset Ver ADDED 21.4 Se usa junto con el parámetro increment_key para PDT incrementales. El increment_offset especifica la cantidad de períodos anteriores (en el nivel de detalle de la clave de incremento) que se vuelven a compilar para incluir los datos tardíos.
indexes Ver Configura los índices de un PDT o una tabla agregada compilada en una base de datos tradicional (p.ej., MySQL, Postgres) o una clave de orden intercalada en Redshift
Se agregó compatibilidad con indexes con tablas agregadas
partition_keys Ver Especifica que uno o más campos de Presto particionan un PDT o una tabla agregada en un solo campo de fecha/hora en BigQuery.
Se agregó compatibilidad con partition_keys con tablas agregadas.
sortkeys Ver Configura las claves de ordenamiento de un PDT o una tabla agregada que se compila en Redshift
Se agregó compatibilidad con sortkeys con tablas agregadas
table_compression Ver Especifica la compresión de tabla que se usará para un PDT en Amazon Athena
table_format Ver Especifica el formato de tabla que se usará para un PDT en Amazon Athena

Agregar tablas

Como se analizó en la página de documentación Conocimiento total, las tablas conjuntas pueden ayudarte a optimizar las consultas en tus exploraciones. Las tablas agregadas se conservan en tu base de datos, de manera similar a las tablas derivadas persistentes (PDT).

Las tablas agregadas se definen en Explorar.

Nombre del parámetro Nivel Descripción
aggregate_table Explorar Crea una tabla agregada para Explorar. Este parámetro tiene subparámetros que se describen en la página de documentación del parámetro aggregate_table.

Parámetros de comportamiento de búsqueda adicionales

Hay varios parámetros que influyen en lo que consultas y cómo lo haces. Algunos se describen en otras secciones de esta página según lo que hacen. En esta sección, se describen los parámetros restantes de LookML que te permiten establecer el comportamiento de las consultas.

Qué buscar

Estos parámetros definen información específica sobre las conexiones, los archivos y los campos que se usarán en sus consultas.

Nombre del parámetro Nivel Descripción
access_grant Modelo Crea una concesión de acceso que limita el acceso a las estructuras de LookML solo a los usuarios que tengan valores de atributo de usuario aprobados. Este parámetro tiene los subparámetros user_attribute y allowed_values.
connection Modelo Cambia la conexión de la base de datos para un modelo
fanout_on Campos: D DG M Habilita el acceso a los campos repetidos de Google BigQuery
from Explorar Especifica la vista en la que se basará una exploración y hace referencia a los campos de esa vista según su nombre.
required_access_grants Explorar Limita el acceso a Explorar a solo aquellos usuarios cuyos valores de atributo de usuario coincidan con las concesiones de acceso.
required_access_grants Unirse Limita el acceso a una unión a aquellos usuarios cuyos valores de atributo de usuario coinciden con las concesiones de acceso.
required_access_grants Ver Limita el acceso a una vista solo a los usuarios cuyos valores de atributo del usuario coincidan con las concesiones de acceso.
required_access_grants Campos: D DG M F P Limita el acceso a un campo solo a aquellos usuarios cuyos valores de atributo del usuario coincidan con las concesiones de acceso
required_fields Campos: D M Requiere que se agreguen campos adicionales a una consulta cuando se elige un campo
sql_table_name Explorar Especifica la tabla de la base de datos en la que se basará una exploración
sql_table_name Ver Cambia la tabla de SQL en la que se basa una vista
view_name Explorar Especifica la vista en la que se basa una exploración, y hace referencia a los campos de esa vista por el nombre de la vista

Cómo realizar consultas

Estos parámetros afectan la forma en que Looker construye o maneja tus consultas.

Varios de estos parámetros se utilizan para garantizar que las agregaciones simétricas funcionen. Para obtener más información sobre las agregaciones simétricas, también puedes consultar el artículo Una explicación simple de las agregaciones simétricas o "¿Por qué en Google Earth se ve mi SQL así?" en el Centro de ayuda.

Nombre del parámetro Nivel Descripción
alias Campos: D DG M F P Permite que las URL guardadas con nombres de campos anteriores permanezcan funcionales después de cambiar el nombre de un campo
cancel_grouping_fields Explorar Cancela la cláusula GROUP BY cuando se eligen ciertos campos en Explorar
primary_key Campos: D Declara una dimensión como la clave primaria de una vista
sql_where Unirse Si esta unión se incluye en la consulta, inserta condiciones en la cláusula WHERE de la consulta que un usuario no puede cambiar ni quitar para esta exploración. Solo para BigQuery Este parámetro también se puede considerar un parámetro de filtro.
symmetric_aggregates Explorar Especifica si los agregados simétricos están habilitados para Explorar. Este parámetro también se muestra para los parámetros que afectan los valores de medición.

Parámetros que se deben evitar

Es posible que vea los siguientes parámetros en su modelo, por lo que hemos incluido aquí una lista de lo que hacen. Sin embargo, si agrega un nuevo modelo, evite estos parámetros.

Nombre del parámetro Nivel Descripción
access_filter_fields Explorar REMOVED 6.0 Reemplazado por access_filter
decimals Campos: D M REMOVED 5.4 Reemplazada por value_format
distkey Ver REMOVED 3.26 Reemplazado por distribution
format Campos: D M REMOVED 3.16 Reemplazada por value_format
scoping Modelo REMOVED 3.52 Ya no es necesaria
sql Unirse AVOID 3.10 Reemplazado por una combinación de sql_on, foreign_key, type o sql_table_name, como se describe en la página de documentación de parámetros sql (para uniones)
sql_foreign_key Unirse AVOID 3.16 Reemplazado por foreign_key
template Modelo REMOVED 3.30 Ya no es necesaria
view_label Ver AVOID 4.4 Reemplazado por label

Otros instructivos y recursos

En estas secciones, se ofrecen vínculos a recursos adicionales que pueden profundizar tus conocimientos de LookML y ayudarte con otras tareas de desarrolladores en Looker.

Comprende el proceso de desarrollo

La sección Modelado de datos del menú de documentación de Looker está diseñada para ayudarlo a comenzar en la sección de desarrollo de Looker.

Páginas específicas que pueden resultar útiles:

Información sobre LookML

La sección Pasos para el aprendizaje de LookML del menú de documentación de Looker está diseñada para presentar los conceptos básicos de LookML y sugerir una ruta de aprendizaje hacia su dominio en LookML.

Páginas específicas que pueden resultar útiles:

Crea paneles de LookML

Los archivos del panel de un proyecto contienen parámetros de LookML específicos del panel. La página actual incluye solo los parámetros de modelado de datos, no los parámetros del panel, pero la sección Crea y administra paneles de LookML en el menú de documentación de Looker está diseñada para presentarle el trabajo con los paneles de LookML.

Páginas específicas que pueden resultar útiles:

Opciones de incorporación, API y administrador

De incorporación

Las siguientes páginas pueden ser útiles para obtener más información sobre cómo incorporar vistas, exploraciones y paneles de control:

API

La sección de la API de Looker del menú de documentación de Looker está diseñada para ayudarlo a comenzar a usar la interfaz de programación de aplicaciones (API) segura y “RESTful” de Looker.

Opciones de administrador

La sección Primeros pasos con opciones de administrador del menú de documentación de Looker está diseñada para ayudarlo a comenzar en la sección Administrador de Looker.

Capacitación sobre Looker Connect

Regístrese en nuestro recorrido de aprendizaje para desarrolladores de LookML en Looker Connect.