consulta

En esta página, se hace referencia al parámetro query que forma parte de una Exploración.

query también se puede usar como parte de una tabla agregada, como se describe en la página de documentación del parámetro aggregate_table.

Uso

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}

Jerarquía Archivo del modelo explore query

Valor predeterminado Ninguno Acepta El nombre de la consulta y los subparámetros para definirla

Definición

Puedes usar el parámetro query para crear análisis modelados para una exploración. Los análisis modelados se enumeran en la sección Inicio rápido de un Explorar en blanco o en la ventana emergente Inicio rápido después de que ya se haya ejecutado un Explorar. Consulta la sección Ejemplo en esta página para ver cómo funciona.

Los análisis modelados son útiles para los usuarios principiantes de Looker, ya que puedes especificar elementos como las dimensiones, las medidas, los filtros y los campos dinámicos que pueden ser los más relevantes y útiles.

Cómo definir una consulta en LookML

En lugar de crear el LookML de la consulta desde cero, puedes usar una función Explorar para que cree el LookML base de la consulta por ti. Para obtener más información, consulta la siguiente sección, Cómo obtener el LookML de una consulta desde un Explorar.

El parámetro query tiene los siguientes subparámetros:

Nombre del parámetro	Descripción	Ejemplo
label	De manera opcional, agrega una etiqueta para el query. La etiqueta es lo que se muestra en el selector de campos de Explorar para la consulta.	label: "Weekly Sales Totals"
description	De manera opcional, agrega una descripción sobre esta búsqueda para informar a los usuarios. En Explorar, las consultas con una descripción tendrán un ícono de información. El texto de la descripción se muestra cuando un usuario coloca el cursor sobre el ícono de información.	description: "Total value of all sales per day"
dimensions	Es una lista separada por comas de las dimensiones de Explorar que se incluirán en tu búsqueda. El campo dimensions usa esta sintaxis: dimensions: [dimension1, dimension2, ...]	dimensions:   [orders.created_month, orders.country]
measures	Es una lista separada por comas de las medidas de Explorar que se incluirán en tu consulta. El campo measures usa esta sintaxis: measures: [measure1, measure2, ...]	measures:   [orders.count]
filters	De manera opcional, agrega filtros a un query. Los filtros se agregan a la cláusula WHERE del SQL que genera la consulta. El campo filters usa esta sintaxis: filters: [field_name_1: "value1", field_name_2: "value2", ...]	filters: [orders.country: "United States", orders.state: "California"]
limit	De manera opcional, especifica el límite de filas de la consulta.	limit: 10
sorts	Opcionalmente, especifica los campos de ordenamiento y la dirección de ordenamiento (ascendente o descendente) para query. El campo sorts usa esta sintaxis: sorts: [field1: asc|desc, field2: asc|desc, ...]	sorts: [order_items.total_sales: asc]
pivots	De forma opcional, puedes generar una tabla dinámica con los resultados en función de las dimensiones especificadas de la consulta. El campo pivots usa esta sintaxis: pivots: [dimension1, dimension2, ...] NOTE: Los campos especificados en el parámetro pivots también deben especificarse en el parámetro dimensions de la consulta.	pivots: [created_quarter]
timezone	No compatible El parámetro timezone no es compatible con el parámetro query, que es un subparámetro de explore. Un query en explore usa la misma zona horaria que explore.

Cómo obtener LookML de consultas desde una exploración

Como atajo, los desarrolladores de Looker pueden tomar prestada la funcionalidad que se usa para generar LookML de aggregate_table desde una exploración y, luego, copiar la consulta de la tabla agregada de LookML y usarla como punto de partida para el LookML de análisis modelado.

Cuando copias el código de LookML de una tabla agregada, también copias algunos parámetros que no deseas para el LookML de tu consulta modelada. Específicamente, una vez que copies el código LookML de la tabla de datos agregados, deberás borrar los parámetros aggregate_table y materialization, ya que solo se aplican a las tablas de datos agregados. (Consulta la página de documentación del parámetro aggregate_table para obtener más información sobre esos parámetros).

Además, el parámetro de la tabla agregada query solo admite un subconjunto de los parámetros que admiten las consultas de Explorar modeladas. Esto significa que, una vez que copies el LookML de la tabla de datos agregados query, podrás usar parámetros adicionales para tu consulta modelada. Consulta la sección Cómo definir una consulta en LookML en esta página para obtener una lista completa de los parámetros admitidos para las consultas modeladas.

Para usar una exploración y obtener una base para el LookML de tu consulta modelada, haz lo siguiente:

1. En tu Explorar, selecciona todos los campos y filtros que deseas incluir en tu consulta modelada.
2. Selecciona Ejecutar para obtener los resultados.

3. Selecciona Visualizar LookML en el menú de ajustes de Acciones de Explorar. Esta opción solo está disponible para los desarrolladores de Looker.

4. Selecciona la pestaña Tabla de agregación.

5. Looker proporciona el LookML para un perfeccionamiento de Explorar para una tabla de datos agregados. Podemos usar el LookML de query de la tabla de datos agregados y modificarlo para una consulta de exploración modelada. Copia el código de LookML y pégalo en el archivo del modelo asociado, que se indica en el comentario que precede al perfeccionamiento de la exploración. Si la exploración se define en un archivo de exploración independiente y no en un archivo de modelo, puedes agregar el perfeccionamiento al archivo de la exploración en lugar de al archivo de modelo.

   Desde aquí, puedes modificar el LookML de la tabla de datos agregados para usarlo en una consulta modelada:

6. Conserva solo el parámetro query y sus subparámetros. Borra los parámetros aggregate_table y materialization, ya que solo se aplican a las tablas agregadas.

7. Agrega un nombre para la consulta. Como se muestra en la sección Ejemplo de esta página, la sintaxis es la siguiente:

   query: query_name

8. De manera opcional, completa los parámetros adicionales de la consulta modelada. Consulta la sección Cómo definir una consulta en LookML en esta página para obtener una lista completa de los parámetros admitidos para las consultas modeladas.

Ejemplo

En este ejemplo, se crea una consulta modelada order_count_by_month para la función Explorar order_items:

explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

Los usuarios pueden ejecutar el análisis de Inicio rápido desde la sección Inicio rápido de la exploración Elementos del pedido.