búsqueda

En esta página, se hace referencia al parámetro query que forma parte de Explorar.

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

.

Jerarquía Archivo del modelo explore query

Valor predeterminado Ninguna Acepta El nombre de la consulta y los subparámetros para definir la consulta

Definición

Puedes usar el parámetro query a fin de crear análisis modelados para Explorar. Los análisis modelados se enumeran en la sección Inicio rápido de una exploración en blanco o en la ventana emergente de inicio rápido después de que se haya explorado. Consulta la sección Ejemplo de esta página para saber 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 reorientamientos, que podrían ser los más relevantes y valiosos.

Define una consulta en LookML

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

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

Nombre del parámetro	Descripción	Ejemplo
label	De forma opcional, agrega una etiqueta para query. La etiqueta es lo que se muestra en el selector de campos de Explorar para la consulta.	label: "Weekly Sales Totals"
description	De forma opcional, agrega una descripción sobre esta consulta para informar a los usuarios sobre ella. En Explorar, todas las consultas con descripción tendrán un ícono de información. El texto descriptivo se muestra cuando un usuario se desplaza sobre el ícono de la información.	description: "Total value of all sales per day"
dimensions	Una lista separada por comas de las dimensiones de Explorar que se incluirán en tu consulta. El campo dimensions usa esta sintaxis: dimensions: [dimension1, dimension2, ...]	dimensions:   [orders.created_month, orders.country]
measures	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 forma opcional, agrega filtros a una 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	De manera opcional, especifica los campos de orden y la dirección de clasificación (ascendente o descendente) para el query. El campo sorts usa esta sintaxis: sorts: [field1: asc|desc, field2: asc|desc, ...]	sorts: [order_items.total_sales: asc]
pivots	De manera opcional, cambia los resultados a las dimensiones especificadas de la consulta. El campo pivots usa esta sintaxis: pivots: [dimension1, dimension2, ...] NOTA: 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: No se admite el parámetro timezone para el parámetro query, que es un subparámetro de explore. Un objeto query en explore usa la misma zona horaria que utiliza el objeto explore.

Obtén LookML de consulta desde Explorar

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

Cuando copie el LookML para una tabla agregada, también copiará algunos parámetros que no desea para su LookML modelado. En particular, una vez que copies el LookML de la tabla agregada, debes borrar los parámetros aggregate_table y materialization, ya que solo se aplican a las tablas agregadas. (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 query de la tabla agregada solo admite un subconjunto de los parámetros que son compatibles con las búsquedas modeladas de Explorar. Esto significa que, una vez que copies la tabla agregada query LookML, puedes usar parámetros adicionales para tu consulta modelada. Consulta la sección Define una consulta en LookML en esta página para obtener una lista completa de los parámetros admitidos.

Si deseas usar Explorar a fin de obtener una base para tu consulta modelada, LookML:

1. En Explorar, seleccione todos los campos y filtros que desea incluir en su consulta modelada.
2. Haga clic en Ejecutar para obtener los resultados.

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

   

4. Haga clic en la pestaña Aggregate Table.

5. Looker proporciona el LookML para un perfeccionamiento de Explorar para una tabla agregada. Podemos usar la LookML query de la tabla agregada y modificarla para una consulta de Explorar modelada. Copia el LookML y pégalo en el archivo del modelo asociado, que se indica en el comentario sobre la mejora de Explorar. Si la función Explorar se define en un archivo de Explorar aparte y no en un archivo de modelo, puedes agregar el perfeccionamiento al archivo de Explorar en lugar del archivo de modelo.

   Desde aquí, puedes modificar la tabla agregada de LookML para usarla 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 en esta página, la sintaxis es:
   query: query_name

8. De forma opcional, completa cualquier parámetro adicional para tu consulta modelada. Consulta la sección Define una consulta en LookML en esta página para obtener una lista completa de los parámetros admitidos en las consultas modeladas.

Ejemplo

En este ejemplo, se crea una consulta modelada order_count_by_month para la exploración 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"]
    }
  }

Luego, el análisis se mostrará en la sección Guía de inicio rápido, en el campo Explorar elementos del pedido. Seleccione el análisis de la sección Guía de inicio rápido para ejecutar el análisis en Explorar:

Una vez que el análisis modelado se ejecuta en Explorar, puede examinar los datos tal como están o puede usarlos como punto de partida para agregar otros campos y medidas, cambiar los filtros, crear visualizaciones o realizar cualquier otra acción a fin de explorar sus datos en Looker. También puedes hacer clic en el ícono del rayo junto al nombre de Explorar:

Esta acción abrirá la ventana emergente Inicio rápido, en la que podrá seleccionar un nuevo análisis:

Seleccione un análisis de inicio rápido para ejecutarlo y reemplazar los resultados anteriores de Explorar sin perder los filtros existentes. Para obtener más detalles sobre el comportamiento del filtro con los análisis de inicio rápido, consulta la sección Comportamiento del filtro de inicio rápido en la página de documentación Explora los datos en Looker.