Mise en cache des requêtes

Looker réduit la charge sur votre base de données et améliore les performances en utilisant les résultats mis en cache des requêtes SQL précédentes lorsqu'ils sont disponibles et lorsque cette fonction est autorisée par votre règle de mise en cache. Cette page décrit la stratégie de mise en cache par défaut de Looker, ainsi que les options disponibles pour modifier la durée des résultats mis en cache sur votre instance Looker.

Comment Looker utilise les requêtes mises en cache

Pour les requêtes SQL, le mécanisme de mise en cache de Looker fonctionne comme suit:

  1. Lorsqu'une requête SQL est exécutée à partir d'une exploration, d'une présentation ou d'un tableau de bord, Looker vérifie dans le cache s'il existe déjà des résultats mis en cache pour cette requête. Les résultats mis en cache ne sont utilisés que si tous les aspects de la requête sont identiques, y compris les champs, les filtres, les paramètres et les limites de lignes.

  2. Si des résultats mis en cache sont trouvés, Looker vérifie la stratégie de mise en cache définie dans le modèle LookML pour déterminer si ces résultats ont expiré. Si les résultats mis en cache n'ont pas expiré, Looker les utilise pour la requête.

  3. Si aucun résultat mis en cache n'est trouvé pour la requête, ou si les résultats mis en cache ont expiré, Looker exécutera la requête sur la base de données. Les résultats de la nouvelle requête sont alors mis en cache.

La règle de conservation par défaut du cache est d'une heure. La section suivante, Modifier les règles de conservation du cache, explique comment raccourcir ou allonger ce délai, et décrit les options permettant de synchroniser votre règle de conservation du cache avec le processus ETL (extraction, transformation et chargement) de votre base de données.

Modifier les règles de conservation du cache

Vous pouvez spécifier des règles de conservation du cache au niveau de l'exploration LookML et au niveau du modèle LookML.

Le mécanisme de mise en cache recommandé consiste à utiliser un paramètre datagroup au niveau du modèle. Les groupes de données vous permettent de synchroniser la règle de conservation du cache d'un modèle avec la programmation ETL de votre base de données à l'aide du paramètre sql_trigger et en définissant un intervalle d'expiration du cache avec le paramètre max_cache_age. Pour en savoir plus, consultez la section Mettre en cache des requêtes et régénérer des tables PDT à l'aide de groupes de données.

Pour simplifier l'approche, vous pouvez plutôt utiliser le paramètre persist_for au niveau du modèle ou au niveau de l'exploration. Utiliser le paramètre persist_for de cette manière vous permet de définir un intervalle d'expiration du cache qui remplace l'intervalle par défaut d'une heure. Cependant, l'utilisation de persist_for est moins robuste que l'utilisation de groupes de données pour plusieurs raisons, comme indiqué dans la section Mettre en cache des requêtes avec persist_for.

Si un groupe de données ou un persist_for est défini pour une exploration ou un modèle, les règles de mise en cache sont modifiées comme suit:

  • Avant l'expiration de l'intervalle persist_for ou de l'expiration de l'intervalle max_cache_age du groupe de données: si la requête est réexécutée, Looker extrait les données du cache.
  • À l'expiration de l'intervalle persist_for ou de l'intervalle max_cache_age du groupe de données: Looker supprime les données du cache.
  • Après l'expiration de l'intervalle persist_for ou de l'intervalle max_cache_age du groupe de données: si la requête est réexécutée, Looker extrait directement les données de la base de données et réinitialise l'intervalle persist_for ou max_cache_age.

Il est important de noter que les données sont supprimées du cache à l'expiration de l'intervalle persist_for ou max_cache_age.

Si le cache atteint la limite de stockage, les données sont éjectées selon un algorithme LRU (Les moins récemment utilisés), sans garantie que les données dont les intervalles persist_for ou max_cache_age ont expiré seront toutes supprimées en même temps.

Réduire le temps que vos données passent dans le cache

Looker écrira toujours les résultats de requête dans le cache. Même si les intervalles persist_for et max_cache_age sont définis sur zéro, les données mises en cache peuvent toujours être stockées pendant 10 minutes maximum. Toutes les données client stockées dans le cache du disque sont chiffrées avec la norme AES (Advanced Encryption Standard).

Pour réduire la durée de stockage des données dans le cache:

  • Pour tout paramètre persist_for (pour un modèle ou une exploration) ou max_cache_age (pour un groupe de données), définissez la valeur sur 0 minutes. Looker supprime le cache à l'expiration de l'intervalle persist_for ou lorsque les données atteignent l'intervalle max_cache_age spécifié dans son groupe de données. Il n'est pas nécessaire de définir le paramètre persist_for des tables PDT sur 0 minutes pour minimiser la quantité de données stockées dans le cache. Les tables PDT sont écrites dans la base de données elle-même et non dans le cache.)
  • Définissez le paramètre suggest_persist_for sur un petit intervalle. La valeur suggest_persist_for indique la durée pendant laquelle Looker doit conserver les suggestions de filtrage dans le cache. Les suggestions de filtre sont basées sur une requête sur les valeurs du champ filtré. Ces résultats de requête sont conservés dans le cache afin que Looker puisse rapidement fournir des suggestions au fur et à mesure que l'utilisateur saisit du texte dans le champ de texte du filtre. Par défaut, les suggestions de filtres sont mises en cache pendant 6 heures. Pour réduire la durée de conservation des données dans le cache, définissez la valeur suggest_persist_for sur une valeur inférieure, par exemple 5 minutes.

Vérifier si une requête a été renvoyée à partir du cache

Dans une fenêtre Explorer, vous pouvez déterminer si une requête a été renvoyée à partir du cache en consultant les informations à côté du bouton Exécuter après avoir exécuté une requête.

Lorsqu'une requête est renvoyée à partir du cache, le texte "from cache" (depuis le cache) s'affiche. Sinon, le temps nécessaire pour renvoyer la requête est affiché.

Forcer la génération de nouveaux résultats à partir de la base de données

Dans une fenêtre Explorer, vous pouvez forcer la récupération de nouveaux résultats dans la base de données. Après avoir exécuté une requête (y compris des requêtes de résultats fusionnés), sélectionnez l'option Vider le cache et actualiser dans le menu représenté par une roue dentée Explorer les actions.

Mise en cache des requêtes et régénération de tables PDT à l'aide de groupes de données

Utilisez des groupes de données pour coordonner la planification ETL (extraction, transformation et chargement) de votre base de données avec la stratégie de mise en cache de Looker et le calendrier de régénération des tables PDT.

Vous pouvez utiliser un groupe de données pour spécifier le déclencheur de la reconstruction des tables PDT en fonction du moment où de nouvelles données sont ajoutées à votre base de données. Vous pouvez ensuite appliquer le même groupe de données à votre exploration ou à votre modèle, de sorte que les résultats mis en cache expirent également lorsque vos tables PDT se régénèrent.

Vous pouvez également utiliser un groupe de données pour dissocier le déclencheur de régénération des tables PDT de l'âge maximal du cache. Cela peut être utile si vous disposez d'une exploration basée à la fois sur des données mises à jour très fréquemment et associées à une table PDT qui est régénérée moins souvent. Dans ce cas, vous souhaiterez peut-être que le cache de vos requêtes se réinitialise plus souvent que votre PDT n'est recréé.

Définition d'un groupe de données

Définissez un groupe de données avec le paramètre datagroup, soit dans un fichier de modèle, soit dans son propre fichier LookML. Vous pouvez définir plusieurs groupes de données si vous souhaitez des règles de mise en cache et de régénération des tables PDT différentes pour les explorations et/ou les tables PDT de votre projet.

Le paramètre datagroup peut comporter les sous-paramètres suivants:

  • label : spécifie un libellé facultatif pour le groupe de données.
  • description : spécifie une description facultative du groupe de données, qui peut être utilisée pour expliquer l'objectif et le mécanisme du groupe de données.
  • max_cache_age : spécifie une chaîne qui définit une période. Lorsque l'ancienneté du cache d'une requête dépasse la période définie, Looker invalide le cache. La prochaine fois que la requête sera émise, Looker l'envoie à la base de données pour obtenir des résultats actualisés.
  • sql_trigger : spécifie une requête SQL qui renvoie une ligne avec une colonne. Si la valeur renvoyée par la requête est différente des résultats précédents de la requête, le groupe de données passe à un état déclenché.
  • interval_trigger : spécifie une planification temporelle pour le déclenchement du groupe de données, par exemple "24 hours".

Un groupe de données doit comporter au moins le paramètre max_cache_age, le paramètre sql_trigger ou le paramètre interval_trigger.

Voici un exemple de groupe de données avec un sql_trigger configuré pour régénérer la table PDT tous les jours. De plus, max_cache_age est configuré de manière à vider le cache des requêtes toutes les deux heures, au cas où des explorations joignaient des tables PDT à d'autres données actualisées plus d'une fois par jour.

datagroup: customers_datagroup {
  sql_trigger: SELECT DATE(NOW());;
  max_cache_age: "2 hours"
}

Une fois le groupe de données défini, vous pouvez l'attribuer aux explorations et aux tables PDT:

Utiliser un groupe de données pour spécifier un déclencheur de recompilation pour les tables PDT

Pour définir un déclencheur de régénération de tables PDT à l'aide de groupes de données, créez un paramètre datagroup avec le sous-paramètre sql_trigger ou interval_trigger. Affectez ensuite le groupe de données à des tables PDT individuelles à l'aide du sous-paramètre datagroup_trigger dans la définition derived_table de la table PDT. Si vous utilisez datagroup_trigger pour votre table PDT, il n'est pas nécessaire de spécifier une autre stratégie de persistance pour la table dérivée. Si vous spécifiez plusieurs stratégies de persistance pour une table PDT, vous recevrez un avertissement dans l'IDE Looker, et seul datagroup_trigger sera utilisé.

Voici un exemple de définition d'une table PDT qui utilise le groupe de données customers_datagroup. Cette définition ajoute également plusieurs index, sur customer_id et first_order_date. Pour en savoir plus sur la définition des tables PDT, consultez la page de documentation Tables dérivées dans Looker.

view: customer_order_facts {
  derived_table: {
    sql: ... ;;
    datagroup_trigger: customers_datagroup
    indexes: ["customer_id", "first_order_date"]
  }
}

Consultez la page de documentation Tables dérivées dans Looker pour en savoir plus sur le fonctionnement des groupes de données avec les tables PDT.

Utiliser un groupe de données pour spécifier la réinitialisation du cache des requêtes pour les explorations

Lorsqu'un groupe de données est déclenché, le régénérateur Looker régénère les tables PDT qui utilisent ce groupe de données comme stratégie de persistance. Une fois les tables PDT du groupe de données régénérées, Looker vide le cache des explorations qui utilisent les tables PDT régénérées du groupe de données. Vous pouvez ajouter le paramètre max_cache_age à la définition de votre groupe de données si vous souhaitez personnaliser un calendrier de réinitialisation du cache de requêtes pour le groupe de données. Le paramètre max_cache_age vous permet de vider le cache des requêtes selon un calendrier spécifié, en plus de la réinitialisation automatique du cache effectuée par Looker lorsque les tables PDT du groupe de données sont recréées.

Pour définir une règle de mise en cache des requêtes avec des groupes de données, créez un paramètre datagroup avec le sous-paramètre max_cache_age.

Pour spécifier un groupe de données à utiliser pour la réinitialisation du cache de requêtes sur les explorations, utilisez le paramètre persist_with:

Les exemples suivants montrent un groupe de données nommé orders_datagroup défini dans un fichier de modèle. Le groupe de données comporte un paramètre sql_trigger, qui spécifie que la requête select max(id) from my_tablename sera utilisée pour détecter quand un processus ETL s'est produit. Même si cet ETL ne se produit pas pendant un certain temps, la règle max_cache_age du groupe de données spécifie que les données mises en cache ne seront utilisées que pendant 24 heures au maximum.

Le paramètre persist_with du modèle pointe vers la règle de mise en cache orders_datagroup, ce qui signifie qu'il s'agit de la règle de mise en cache par défaut pour toutes les explorations du modèle. Toutefois, nous ne voulons pas utiliser la règle de mise en cache par défaut du modèle pour les explorations customer_facts et customer_background. Nous pouvons donc ajouter le paramètre persist_with afin de spécifier une règle de mise en cache différente pour ces deux explorations. Les explorations orders et orders_facts ne comportent pas de paramètre persist_with. Elles utiliseront donc la règle de mise en cache par défaut du modèle: orders_datagroup.

datagroup: orders_datagroup {
  sql_trigger: SELECT max(id) FROM my_tablename ;;
  max_cache_age: "24 hours"
}

datagroup: customers_datagroup {
  sql_trigger: SELECT max(id) FROM my_other_tablename ;;
}

persist_with: orders_datagroup

explore: orders { ... }

explore: order_facts { ... }

explore: customer_facts {
  persist_with: customers_datagroup
  ...
}

explore: customer_background {
  persist_with: customers_datagroup
  ...
}

Si persist_with et persist_for sont tous les deux spécifiés, vous recevrez un avertissement de validation et persist_with sera utilisé.

Utiliser un groupe de données pour déclencher des envois planifiés

Les groupes de données peuvent également être utilisés pour déclencher l'envoi d'un tableau de bord ou d'une présentation. Avec cette option, Looker envoie vos données une fois le groupe de données terminé, afin que le contenu planifié soit à jour.

Utiliser le panneau Administration pour les groupes de données

Si vous disposez du rôle d'administrateur Looker, vous pouvez afficher les groupes de données existants depuis la page Groupes de données du panneau Administration. Vous pouvez voir la connexion, le modèle et l'état actuel de chaque groupe de données et, si spécifié dans le code LookML, une étiquette et une description pour chaque groupe de données. Vous pouvez également réinitialiser le cache d'un groupe de données, déclencher le groupe de données ou accéder au code LookML du groupe de données.

Mettre des requêtes en cache avec persist_for

Utilisez le paramètre persist_for au niveau du modèle ou au niveau de l'exploration pour modifier l'intervalle de conservation par défaut du cache de Looker d'une heure. Vous pouvez définir des intervalles de moins de 0 minutes et de 8760 hours (un an) ou plus.

Définir des paramètres persist_for peut être plus rapide et plus simple, mais moins robuste que de définir des groupes de données. Les groupes de données sont recommandés plutôt que persist_for pour les raisons suivantes:

  • Les groupes de données peuvent se synchroniser avec le processus ETL de votre base de données.
  • Vous pouvez réutiliser des groupes de données dans plusieurs modèles et explorations. Cela signifie que vous pouvez mettre à jour le max_cache_age d'un groupe de données, ce qui mettra à jour la règle de mise en cache partout où le groupe de données est utilisé.
  • Vous pouvez vider le cache associé à un groupe de données à partir de la page Groupes de données.