Paramètres d'administration – Requêtes

La page Requêtes de la section Base de données du menu Admin liste des informations sur les 50 dernières requêtes que Looker a envoyées à votre base de données. Pour en savoir plus sur les requêtes plus anciennes que les 50 dernières, consultez la section Utilisation de Looker.

Si vous avez activé la fonctionnalité de laboratoire Administration avancée des requêtes, la page Requêtes affiche les onglets suivants :

  • Récentes : affiche les requêtes exécutées au cours de la dernière heure. Dans cet onglet, les administrateurs Looker peuvent annuler les requêtes en cours d'exécution.
  • Complètes : affiche les 500 requêtes les plus récentes.

Si vous n'avez pas activé la fonctionnalité expérimentale Administration avancée des requêtes, la page Requêtes liste les 50 dernières requêtes sur une seule page.

Informations de base sur les requêtes

Colonne Définition
Heure Heure de début de la requête, affichée dans le fuseau horaire de votre application.
État État de la requête, qui peut inclure :
  • Cache : Looker a renvoyé les résultats de son cache au lieu d'exécuter une requête en double sur la base de données.
  • Terminée : la requête a bien été exécutée.
  • Erreur : la requête n'a pas abouti en raison d'une erreur. Pour en savoir plus, cliquez sur le bouton Détails.
  • Annulée : la requête a été annulée par Looker ou par l'utilisateur.
  • En attente d'une PDT : la requête doit attendre la création d'une table dérivée persistante avant de pouvoir être exécutée.
  • Création de PDT : une table dérivée persistante est en cours de création.
  • En file d'attente : la requête est en attente d'exécution, car trop de requêtes sont déjà en cours (Looker peut limiter les requêtes dans la configuration de votre connexion ou dans votre base de données).
  • En cours d'exécution : la requête est en cours d'exécution.
  • Inconnu : Looker n'a pas pu déterminer ce qui s'est passé avec cette requête.
Connexion La connexion Looker sous laquelle cette requête a été exécutée.
Utilisateur Utilisateur qui a exécuté cette requête, si cela peut être déterminé. Certaines requêtes ne sont pas exécutées par un utilisateur spécifique, par exemple lorsque Looker crée une table dérivée persistante ou lorsqu'un utilisateur inconnu accède à un look public.
Source Source de la requête dans Looker, comme la page "Explorer" ou SQL Runner. Si possible, un lien vers la requête enregistrée ou l'ID de requête, ainsi que le nom du modèle et de l'exploration, sont également affichés. Certaines requêtes ne comportent pas d'informations supplémentaires, comme celles exécutées dans SQL Runner. Les requêtes émises à partir de l'interface Open SQL ont une valeur Source de Sql_interface.
Environnement d'exécution Temps nécessaire à l'exécution de la requête. Cela inclut la construction de la requête, le temps passé dans la file d'attente, le transit vers et depuis la base de données, et l'exécution de la requête par la base de données.

Si la requête est en cours d'exécution, la durée d'exécution indique depuis combien de temps elle est en cours d'exécution. Pour les requêtes exécutées précédemment, la durée d'exécution indique également une estimation du temps nécessaire à l'exécution de la requête. L'estimation est basée sur la durée de la dernière exécution de la requête et indique par exemple "environ 2 s".
Bouton "Détails" Pour en savoir plus, consultez la sous-section Bouton "Détails" sur cette page.

Bouton "Détails"

Cliquez sur le bouton Détails à droite d'une requête pour obtenir des informations supplémentaires à son sujet. Le menu Détails de la requête inclut les éléments suivants :

  • Une section Infos qui inclut des détails sur la requête (voir le tableau ci-dessous).
  • Une section SQL qui affiche le code SQL brut exécuté sur la base de données. Les commentaires contextuels n'apparaissent pas dans les informations Détails de la requête. Pour éviter que les commentaires n'affectent la mise en cache des requêtes, Looker ajoute les commentaires contextuels aux commandes SQL sortantes juste avant que le code SQL ne soit envoyé à la base de données.
  • Une section Requête d'interface SQL s'affiche lorsqu'une requête a été émise via l'interface SQL ouverte. Cette section affiche la requête SQL qui a été envoyée à Looker depuis l'outil de BI externe. Elle peut vous aider à résoudre les problèmes et à les reproduire.
  • Un lien Ouvrir dans l'exécuteur SQL qui ouvre la requête dans l'exécuteur SQL.

La section Infos inclut les informations suivantes :

Section Définition
ID de l'historique L'ID de l'historique de la requête, le cas échéant.
État État de la requête, tel que décrit dans le tableau d'informations de base sur les requêtes.
Message Si la requête contient une PDT, le commentaire de génération de la PDT s'affiche dans ce champ. Si la requête ne contient pas de PDT, le champ n'apparaît pas.
Connexion La connexion Looker sous laquelle cette requête a été exécutée.
Utilisateur Utilisateur qui a exécuté cette requête, si cela peut être déterminé. Certaines requêtes ne sont pas exécutées par un utilisateur spécifique, par exemple lorsque Looker crée une table dérivée persistante ou lorsqu'un utilisateur inconnu accède à un look public.
Source Source de la requête dans Looker, comme la page Explorer ou SQL Runner. Si possible, des informations supplémentaires s'affichent, comme un lien vers la présentation enregistrée, l'ID de requête, le nom du modèle, le nom de l'exploration ou les champs sélectionnés.
Heure de début Heure de début de la requête, affichée dans le fuseau horaire de votre application.
Heure de fin Heure de fin de la requête, affichée dans le fuseau horaire de votre application.
Environnement d'exécution Durée d'exécution de la requête.

Arrêt des requêtes

Lorsque vous fermez l'onglet du navigateur dans lequel une requête est en cours d'exécution, Looker l'arrête automatiquement. Les administrateurs Looker peuvent également arrêter une requête en cours d'exécution depuis la page Requêtes. (Les utilisateurs disposant de l'autorisation see_queries peuvent consulter la page Requêtes, mais seuls les administrateurs Looker peuvent arrêter une requête en cours d'exécution.) Pour toute requête en cours d'exécution, un bouton Arrêter s'affiche à droite. Cliquez sur Arrêter pour arrêter la requête.

Pour que Looker puisse arrêter les requêtes, votre dialecte de base de données doit prendre en charge cette fonctionnalité. La liste suivante répertorie les dialectes prenant en charge l'arrêt des requêtes dans la dernière version de Looker :

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

Délai avant expiration des requêtes et mise en file d'attente

Looker arrête les requêtes qui sont en file d'attente depuis trop longtemps. Cette opération est appelée délai d'inactivité. Plusieurs délais d'expiration peuvent s'appliquer à votre requête :

  • Délai avant expiration du pool de connexions et nombre maximal de requêtes simultanées : pour éviter de surcharger votre base de données avec des requêtes simultanées, Looker conserve les requêtes simultanées excédentaires dans la file d'attente des requêtes Looker et arrête les requêtes qui y restent trop longtemps. Par défaut, 75 requêtes simultanées maximum sont autorisées par connexion. Les requêtes supplémentaires au-delà de la limite de connexion expireront après 0 seconde. Pour modifier ces valeurs par défaut, configurez les paramètres Nombre maximal de connexions, Nombre maximal de requêtes simultanées pour cette connexion et Délai avant expiration du pool de connexions sur la page Paramètres de connexion d'une connexion.

  • Limite de requêtes et délai d'expiration par utilisateur : pour éviter qu'un seul utilisateur ne remplisse la file d'attente des requêtes Looker, chaque utilisateur est soumis à un nombre maximal de requêtes simultanées autorisées et à un délai d'expiration de la file d'attente correspondant. Par défaut, chaque utilisateur peut exécuter un maximum de 15 requêtes simultanées. Le délai avant expiration est de 600 secondes pour les requêtes mises en file d'attente en raison de cette limite. Ces paramètres s'appliquent à la fois aux utilisateurs qui se connectent à Looker à l'aide de la procédure d'authentification habituelle et à ceux qui se connectent à l'aide d'identifiants d'utilisateur de l'API. Pour modifier ces valeurs par défaut, configurez les paramètres Nombre maximal de requêtes simultanées par utilisateur pour cette connexion sur la page Paramètres de connexion d'une connexion. Si votre instance Looker est hébergée par le client, vous pouvez modifier ces valeurs par défaut en configurant les options de démarrage --per-user-query-limit et --per-user-query-timeout.

  • Limite de requêtes et délai d'expiration du planificateur : pour éviter de surcharger le processus du planificateur Looker, une instance Looker peut exécuter un maximum de 10 requêtes programmées simultanément. Le délai d'expiration des requêtes dans la file d'attente du planificateur est de 1 200 secondes. Si votre instance Looker est hébergée par le client, vous pouvez modifier ces valeurs par défaut en configurant les options de démarrage --scheduler-query-limit et --scheduler-query-timeout.

  • Limite et délai avant expiration des requêtes du moteur de rendu : pour éviter de surcharger le processus du moteur de rendu Looker, une instance Looker peut générer un maximum de deux téléchargements simultanés basés sur des images, tels que les formats PDF et PNG. Si votre instance Looker est hébergée par le client, vous pouvez modifier cette valeur par défaut en configurant l'option de démarrage --concurrent-render-jobs.

  • Délai avant expiration du webhook : Looker tente d'envoyer des données à un webhook pendant 30 minutes au maximum. Si Looker ne parvient pas à communiquer avec la destination du webhook au bout de 30 minutes, la requête expire. Ce délai avant expiration n'est pas configurable.
    • Délai avant expiration du proxy : les instances hébergées par le client utilisent souvent des proxys avec un délai avant expiration par défaut de 60 secondes. Nous vous recommandons de porter ce délai à 60 minutes. Pour en savoir plus, consultez le post de la communauté Looker Exécuter Looker derrière un serveur proxy ou un équilibreur de charge.

    • Délai d'expiration de la base de données : la plupart des bases de données ont des règles de mise en file d'attente et de délai d'expiration qui sont indépendantes de celles de Looker. Par exemple, une requête peut avoir quitté la file d'attente Looker, mais elle peut toujours être en file d'attente dans votre base de données. Pour en savoir plus sur la personnalisation des délais d'expiration des requêtes de base de données, consultez la documentation de votre base de données.