Configuración del administrador: Consultas

En la página Consultas (Queries) de la sección Administrador (Admin) del menú Administrador (Admin), se muestra información sobre las últimas 50 consultas que Looker envió a tu base de datos. Si deseas obtener información sobre las consultas que son más antiguas que las 50 más recientes, consulta la sección Uso (Usage) de Looker.

Información básica de la consulta

Columna Definición
Hora Es la hora de inicio de la consulta, que se muestra en la zona horaria de tu aplicación.
Estado Es el estado de la consulta, que puede incluir lo siguiente:
  • Caché: Looker mostró los resultados de su caché en lugar de ejecutar una consulta duplicada en la base de datos.
  • Completado: La consulta se completó correctamente.
  • Error: La consulta no se completó correctamente porque se produjo un error. Para obtener más detalles, haz clic en el botón Detalles.
  • Cancelado: Looker o el usuario cancelaron la consulta.
  • Esperando PDT: La consulta debe esperar a que se cree una tabla derivada persistente antes de que se pueda ejecutar.
  • Creando PDT: Se está creando una tabla derivada persistente.
  • En cola: La consulta está esperando a que se ejecute porque ya hay demasiadas consultas en curso (Looker puede limitar las consultas en la configuración de tu conexión o en tu base de datos).
  • En ejecución: La consulta se está ejecutando.
  • Desconocido: Looker no pudo determinar qué sucedió con esta consulta.
Conexión Es la conexión de Looker en la que se ejecutó esta consulta.
Usuario Es el usuario que ejecutó esta consulta, si se puede determinar. Algunas consultas no son ejecutadas por un usuario específico, como cuando Looker crea una tabla derivada persistente o cuando un usuario desconocido accede a un Look público.
Fuente Es la fuente de la consulta en Looker, como la página Explorar o el Ejecutor de SQL. Si es posible, también se muestra un vínculo al Look guardado o el ID de la consulta junto con el nombre del modelo y Explorar. Algunas consultas no tienen información adicional, como las que se ejecutan en el Ejecutor de SQL. Las consultas que se emiten desde la interfaz de SQL abierta tienen un valor de Fuente de Sql_interface.
Entorno de ejecución Es el tiempo que tardó en ejecutarse la consulta. Esto incluye la construcción de la consulta, cualquier tiempo que la consulta pasó en la cola, el tránsito hacia y desde la base de datos, y la ejecución de la consulta en la base de datos.

Si la consulta se está ejecutando, el entorno de ejecución mostrará cuánto tiempo lleva ejecutándose. En el caso de las consultas que se ejecutaron anteriormente, el entorno de ejecución también mostrará una estimación de cuánto tiempo tardará en finalizar la consulta. La estimación se basa en la duración de la última ejecución de la consulta y dirá algo como "de aproximadamente 2 s".
Botón Detalles Consulta la subsección Botón Detalles en esta página para obtener más detalles.

El botón Detalles

Si haces clic en el botón Detalles que se encuentra a la derecha de cualquier consulta, aparecerá información adicional sobre esa consulta. El menú Detalles de la consulta incluye lo siguiente:

  • Una sección Información que incluye detalles sobre la consulta (consulta la siguiente tabla)
  • Una sección SQL que muestra el SQL sin procesar que se ejecutó en la base de datos Los **comentarios de contexto** no aparecerán en la información de **Detalles de la consulta**. Para evitar que los comentarios afecten el almacenamiento en caché de las consultas, Looker agrega los comentarios de contexto a los comandos SQL salientes justo antes de que se envíe el SQL a la base de datos
  • Una sección Consulta de la interfaz de SQL que aparece cuando se emite una consulta a través de la interfaz de SQL abierta. En esta sección, se muestra la consulta en SQL que se envió a Looker desde la herramienta de IE externa y puede ayudar a solucionar problemas y reproducirlos.
  • Un vínculo Abrir en el Ejecutor de SQL que abrirá la consulta en el Ejecutor de SQL.

La sección Info incluye la siguiente información:

Sección Definición
ID del historial Es el ID del historial de la consulta, si está disponible.
Estado Es el estado de la consulta, como se describe en la tabla de información básica de la consulta.
Mensaje Si la consulta contiene una PDT, el comentario de generación de PDT aparece en este campo. Si la consulta no contiene una PDT, el campo no aparece.
Conexión Es la conexión de Looker en la que se ejecutó esta consulta.
Usuario Es el usuario que ejecutó esta consulta, si se puede determinar. Algunas consultas no son ejecutadas por un usuario específico, como cuando Looker crea una tabla derivada persistente o cuando un usuario desconocido accede a un Look público.
Fuente Es la fuente de la consulta en Looker, como la página Explorar o el Ejecutor de SQL. Si es posible, se muestra información adicional, como un vínculo al Look guardado, el ID de la consulta, el nombre del modelo, el nombre de Explorar o los campos que se seleccionaron.
Hora de inicio Es la hora de inicio de la consulta, que se muestra en la zona horaria de tu aplicación.
Hora de finalización Es la hora de finalización de la consulta, que se muestra en la zona horaria de tu aplicación.
Entorno de ejecución Es el tiempo que tardó en ejecutarse la consulta.

Finalización de consultas

En el caso de los dialectos que admiten la finalización de consultas, Looker puede detener una consulta en ejecución de dos maneras:

Para que Looker finalice las consultas, ya sea cerrando la pestaña del navegador en la que se está ejecutando una consulta o deteniendo la consulta en la página Consultas (Queries), el dialecto de tu base de datos debe admitir la finalización de consultas. En la siguiente tabla, se muestran los dialectos que admiten la finalización de consultas en la versión más reciente de Looker:

Dialecto ¿Es compatible?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

Tiempos de espera y colas de consultas

Looker finaliza las consultas que han estado en la cola durante demasiado tiempo. Esta operación se denomina tiempo de espera. Es posible que se apliquen varios tiempos de espera a tu consulta:

  • Tiempo de espera del grupo de conexiones y cantidad máxima de consultas simultáneas: Para evitar la sobrecarga de tu base de datos con consultas simultáneas, Looker retiene el exceso de consultas simultáneas en la cola de consultas de Looker y finaliza las consultas que permanecen en la cola durante demasiado tiempo. De forma predeterminada, se permiten 75 consultas simultáneas máximas por conexión. Las consultas adicionales más allá del límite de conexión se agotarán después de 0 segundos. Para cambiar estos valores predeterminados, configura los parámetros de configuración Cantidad máxima de conexiones, Cantidad máx. de consultas simultáneas para esta conexión y Tiempo de espera del grupo de conexiones en la página Configuración de conexiones de una conexión.

  • Límite y tiempo de espera de consultas por usuario: Para evitar que un solo usuario llene la cola de consultas de Looker, cada usuario tiene una cantidad máxima de consultas simultáneas permitidas y un tiempo de espera de cola correspondiente para las consultas que se ponen en cola debido al límite de consultas simultáneas. El límite por usuario se aplica tanto a los usuarios que acceden a Looker con el proceso de autenticación normal como a los usuarios que acceden con credenciales de usuario de la API. Existen dos formas de definir la cantidad máxima de consultas simultáneas por usuario para las conexiones en tu instancia de Looker:

    • La opción de inicio per-user-query-limit. Este es un parámetro de configuración para toda la instancia que establece el valor predeterminado para las conexiones en tu instancia. La opción de inicio per-user-query-limit limita la cantidad de consultas simultáneas por usuario, por conexión y por nodo en la instancia de Looker. El máximo predeterminado de 15 consultas simultáneas por usuario se aplica a cada conexión válida y, si tu instancia de Looker está agrupada, a cada nodo del clúster. De forma predeterminada, cada usuario puede ejecutar un máximo de 15 consultas simultáneas por conexión, por nodo, con un tiempo de espera de 600 segundos. Por ejemplo, si tienes un clúster de 5 nodos con un per-user-query-limit de 15, cada nodo permitirá 15 consultas simultáneas por usuario para esta conexión, para un total de 75 consultas en todos los nodos (15 * 5 = 75).

    Puedes cambiar el límite de consultas por usuario para una conexión con el parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión en la página Configuración de conexiones de la conexión. Si tu instancia de Looker está alojada por el cliente, puedes cambiar la cantidad máxima predeterminada de consultas simultáneas por usuario configurando la opción de inicio --per-user-query-limit y puedes configurar el tiempo de espera de la cola con la opción de inicio --per-user-query-timeoutstartup option.

    • La opción Cantidad máx. de consultas simultáneas por usuario para esta conexión en la Configuración de conexiones de una conexión. El parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión tiene un valor predeterminado de 25 y es por usuario y por conexión, pero no por nodo. Por ejemplo, si tienes un clúster de 5 nodos y estableces este valor en 15, cada nodo permitirá 3 consultas simultáneas por usuario para esta conexión (15 / 5 = 3), para un total de 15 consultas en todos los nodos. En el caso de una conexión, si se proporciona un valor para el parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión, el valor de Cantidad máx. de consultas simultáneas por usuario para esta conexión anulará la opción de inicio per-user-query-limit para la conexión.
  • Límite y tiempo de espera de consultas del programador: Para evitar la sobrecarga del proceso del programador de Looker, una instancia de Looker puede ejecutar un máximo de 10 consultas programadas simultáneas, y el tiempo de espera para las consultas en la cola del programador es de 1,200 segundos. Si tu instancia de Looker está alojada por el cliente, puedes cambiar estos valores predeterminados configurando las --scheduler-query-limit y --scheduler-query-timeout opciones de inicio.

  • Límite y tiempo de espera de consultas del renderizador: Para evitar la sobrecarga del proceso del renderizador de Looker, una instancia de Looker puede renderizar un máximo de 2 descargas simultáneas basadas en imágenes, como los formatos PDF y PNG. Si tu instancia de Looker está alojada por el cliente, puedes cambiar este valor predeterminado configurando la --concurrent-render-jobs opción de inicio.

  • Tiempo de espera de webhook: Looker intentará entregar datos a un webhook durante un máximo de 30 minutos. Si Looker no puede comunicarse con el destino del webhook en 30 minutos, se agotará el tiempo de espera de la consulta. Este tiempo de espera no se puede configurar.
    • Tiempo de espera del proxy: Las instancias alojadas por el cliente suelen usar proxies con un tiempo de espera predeterminado de 60 segundos. Te recomendamos que aumentes este tiempo de espera a 60 minutos. Consulta la publicación de Comunidad de Looker Ejecución de Looker detrás de un servidor proxy o un balanceador de cargas para obtener más información.

    • Tiempo de espera de la base de datos: La mayoría de las bases de datos tienen reglas para las colas y los tiempos de espera que son independientes de las colas y los tiempos de espera de Looker. Por ejemplo, es posible que una consulta haya salido de la cola de Looker, pero que aún esté en cola en tu base de datos. Consulta la documentación de tu base de datos para obtener más información sobre la personalización de los tiempos de espera de las consultas de la base de datos.