Connecter Looker à votre base de données à l'aide du workflow amélioré

Une fois que vous avez sécurisé et configuré votre base de données, vous pouvez la connecter à Looker. Si la fonctionnalité Labs New Database Connection Setup (Nouvelle configuration de connexion de base de données) est activée, l'interface utilisateur de la page Add/Edit Connections (Ajouter/Modifier des connexions) sera mise à jour, les fonctionnalités de validation et de test de connexion seront améliorées, la documentation sera étendue (y compris des ressources spécifiques au cloud) et un récapitulatif de configuration complet sera disponible.

Vous créez une connexion de base de données dans Looker sur la page Connecter votre base de données à Looker. Vous avez deux options pour ouvrir la page Connecter votre base de données à Looker:

  • Sélectionnez Connexions dans la section Base de données du panneau Administration. Sur la page Connexions, cliquez sur le bouton Ajouter une connexion.
  • Cliquez sur le bouton Créer dans le menu de navigation principal, puis sélectionnez l'élément de menu Connexion.

Pour en savoir plus sur l'application d'attributs utilisateur aux paramètres de connexion, consultez la section Connexions de la page de documentation Attributs utilisateur.

Cette page décrit les champs courants que Looker affiche sur la page Connecter votre base de données à Looker. Les champs exacts affichés par la page dépendent de la configuration de votre dialecte.

Une fois que vous avez saisi les paramètres de connexion à la base de données, vous pouvez tester la connexion pour vous assurer qu'elle est correctement configurée. Pour obtenir des informations sur le dépannage, consultez la page de documentation Tester la connectivité de la base de données. Si Looker affiche Peut se connecter, appuyez sur Connecter pour créer la connexion. Votre connexion de base de données est ensuite ajoutée à la liste de la page Connexions Administration de Looker.

La configuration de la connexion à la base de données comporte les quatre sections suivantes:

Paramètres généraux

Nom

Le nom de la connexion tel que vous souhaitez y faire référence. Vous devez utiliser ce nom de connexion de base de données dans le paramètre connection de votre modèle LookML. Le nom de la connexion à la base de données permet également d'identifier la connexion sur la page Connexions Administration de Looker. N'utilisez pas le nom de dossiers pour ce paramètre. Cette valeur ne doit pas nécessairement correspondre à un élément de votre base de données. Name est un libellé qui identifie cette connexion dans l'interface utilisateur de Looker.

Dialecte SQL

Dialecte SQL correspondant à votre connexion. Il est important de choisir la valeur appropriée afin que les options de connexion pertinentes vous soient présentées et que Looker puisse convertir correctement votre LookML en langage SQL.

Portée du projet

Indiquez si la connexion peut être utilisée avec tous les projets ou avec un seul projet:

  • Tous les projets: tous les projets LookML de l'instance peuvent avoir accès à la connexion. Le nom de la connexion peut donc être spécifié dans le paramètre connection des fichiers de modèle de ce projet.
  • Projet sélectionné: un seul projet LookML de l'instance peut avoir accès à la connexion. Lorsque vous sélectionnez cette option, l'écran "Connexion" affiche un menu déroulant des projets de l'instance. Sélectionnez le projet pouvant accéder à cette connexion.

Utilisez cette option avec les autorisations suivantes pour déléguer la gestion des connexions et la configuration des modèles:

Informations relatives à l'état

Développez la section Status Details (Détails de l'état) pour tester les paramètres de votre connexion.

Paramètres de base de données

Activer le serveur SSH

L'option Serveur SSH n'est disponible que si l'instance est déployée sur l'infrastructure Kubernetes et si l'ajout d'informations de configuration du serveur SSH à votre instance Looker a été activé. Si cette option n'est pas activée sur votre instance Looker et que vous souhaitez l'activer, contactez un spécialiste commercial ou envoyez une demande d'assistance. Si vous activez l'option Activer le serveur SSH, Looker affiche les champs Serveur SSH et Tunnel SSH.

Serveur SSH

Le serveur SSH choisit automatiquement le port localhost pour vous et il est actuellement impossible de spécifier le port localhost. Si vous devez créer une connexion SSH qui nécessite de spécifier un port localhost, envoyez une demande d'assistance.

Sélectionnez une configuration de serveur SSH dans la liste déroulante. Un serveur SSH est requis pour sélectionner ou créer un tunnel SSH approprié. Vous pouvez créer un serveur SSH dans l'onglet Serveurs SSH du panneau Connexions.

tunnel SSH

Sélectionnez un tunnel SSH existant dans la liste déroulante ou cliquez sur l'icône Créer un tunnel si vous souhaitez créer un tunnel SSH avec un nom d'hôte et un port ou un port local.

Nom d'hôte

Nom d'hôte de votre base de données que Looker doit utiliser pour se connecter à l'hôte de la base de données.

Si vous avez travaillé avec un analyste Looker pour configurer un tunnel SSH vers votre base de données, saisissez "localhost" dans le champ Host (Hôte). Si vous appliquez un attribut utilisateur au champ Host (Hôte), le niveau d'accès utilisateur ne peut pas être défini sur Editable (Modifiable). Si vous avez configuré un tunnel SSH pour connecter votre base de données, vous ne pouvez pas appliquer d'attribut utilisateur au champ Remote Host:Port (Hôte distant : port).

Port

Port de base de données que Looker doit utiliser pour se connecter à l'hôte de la base de données.

Si vous avez travaillé avec un analyste Looker pour configurer un tunnel SSH vers votre base de données, dans le champ Port, saisissez le numéro de port qui redirige vers votre base de données, que votre analyste Looker devrait vous avoir fourni.

Port local

Par défaut, Looker sélectionne automatiquement un port local disponible pour le tunnel SSH. Pour choisir manuellement un port local, sélectionnez Saisie manuelle et saisissez un numéro de port dans le champ Port local personnalisé. Assurez-vous que le port local est disponible sur votre instance.

ID du projet de facturation (Google BigQuery uniquement)

L'ID de projet de facturation correspond à l'ID de projet Google Cloud . Pour en savoir plus, consultez la page de documentation Google BigQuery.

ID de projet Cloud Storage (Google BigQuery uniquement)

Nom de l'ID de votre projet de stockage, si vous séparez le calcul et le stockage dans un projet distinct. Vous pouvez interroger des ensembles de données dans un autre projet Google Cloud si vos développeurs LookML spécifient des noms de table à portée complète dans le paramètre sql_table_name de vos vues, explorations ou jointures LookML. Pour en savoir plus, consultez la page de documentation Google BigQuery.

Ensemble de données principal (Google BigQuery uniquement)

Nom de l'ensemble de données que vous souhaitez utiliser par défaut lorsque Looker interroge votre base de données. Pour en savoir plus, consultez la page de documentation Google BigQuery.

Nom de la base de données

Nom de la base de données de votre hôte. Par exemple, vous pouvez avoir un nom d'hôte my-instance.us-east-1.redshift.amazonaws.com sur lequel se trouve une base de données appelée sales_info. Vous devez saisir sales_info dans ce champ. Si vous avez plusieurs bases de données sur le même hôte, vous devrez peut-être créer plusieurs connexions pour les utiliser (à l'exception de MySQL, dans lequel le terme base de données a une signification légèrement différente de celle de la plupart des dialectes SQL).

Schéma par défaut

Le schéma par défaut que Looker utilise lorsqu'aucun schéma n'est indiqué. Cela s'applique lorsque vous utilisez SQL Runner, au cours de la génération d'un projet LookML et lorsque vous interrogez des tables.

Paramètres d'authentification

Pour les connexions Google BigQuery, Snowflake, Trino et Databricks, sélectionnez le type d'authentification que Looker doit utiliser pour accéder à votre base de données:

  • Pour les connexions Google BigQuery, vous pouvez configurer OAuth ou un compte de service que Looker utilisera pour s'authentifier auprès de votre base de données.
  • Pour les connexions à Snowflake, Trino et Databricks, vous pouvez configurer OAuth ou un compte de base de données que Looker utilisera pour s'authentifier auprès de votre base de données.

Lorsque vous utilisez OAuth, vos utilisateurs doivent se connecter à votre base de données pour émettre des requêtes depuis Looker. Pour en savoir plus sur la configuration d'OAuth pour une connexion à Looker, consultez les procédures de connexion à Google BigQuery, Snowflake, Trino ou Databricks.

Nom d'utilisateur

Nom d'utilisateur d'un compte utilisateur de votre base de données que Looker peut utiliser pour s'y connecter.

Mot de passe

Mot de passe d'un compte utilisateur de votre base de données que Looker peut utiliser pour s'y connecter.

Développez la section Status Details (Détails de l'état) pour tester les paramètres de votre connexion.

Paramètres facultatifs

Max Connections per node

Ici, vous pouvez configurer le nombre maximal de connexions que Looker peut établir avec votre base de données. Dans la majorité des cas, vous configurez le nombre de requêtes simultanées que Looker peut exécuter sur votre base de données. Looker consacre également jusqu'à trois connexions à la suppression des requêtes. Si le pool de connexions est de taille très restreinte, Looker consacrera moins de connexions.

Vous devez configurer cette valeur attentivement. Si cette valeur est trop élevée, vous risquez de submerger votre base de données. Si cette valeur est trop faible, les requêtes devront partager une petite quantité de connexions. Chaque requête devant attendre le retour des autres requêtes précédemment exécutées, il se peut donc que de nombreuses requêtes semblent lentes aux utilisateurs.

La valeur par défaut (qui varie en fonction de votre dialecte SQL) constitue généralement un point de départ raisonnable. Pour ce qui est du nombre maximal de connexions qu'elles acceptent, la plupart des bases de données disposent également de leur propre configuration. Si la configuration de votre base de données limite les connexions, veillez à ce que la valeur Max Connections per node (Nombre maximal de connexions par nœud) soit inférieure ou égale à la limite de votre base de données.

Expiration du pool de connexions

Si vos utilisateurs demandent davantage de connexions que le paramètre Nombre maximal de connexions par nœud, les requêtes devront attendre la fin des requêtes précédentes avant de pouvoir s'exécuter. Le temps d'attente maximal d'une requête se configure à cet endroit. La valeur par défaut est de 120 secondes.

Vous devez configurer cette valeur attentivement. S'il est trop faible, il se peut que les utilisateurs voient leurs requêtes annulées, car les requêtes des autres utilisateurs n'auront pas eu le temps de s'achever. S'il est trop élevé, il se peut qu'une grande quantité de requêtes s'accumulent et que le temps d'attente soit très long pour les utilisateurs. La valeur par défaut constitue généralement un point de départ raisonnable.

Paramètres JDBC supplémentaires

Si nécessaire, vous pouvez inclure d'autres paramètres JDBC (Java Database Connectivity) dans vos requêtes.

Pour référencer un attribut utilisateur dans un paramètre JDBC, utilisez la syntaxe de modèle Liquid: _user_attributes['name_of_attribute']. Exemple :

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

Calendrier de maintenance

Le régénérateur Looker vérifie les groupes de données et les tables persistantes (à la fois les tables agrégées et les tables dérivées persistantes) basées sur sql_trigger_value. Sur la base de ces vérifications, le régénérateur Looker regénère ou supprime les tables persistantes à partir du schéma de base de votre base de données.

La valeur Calendrier de maintenance définit l'intervalle cron pour le régénérateur Looker. Le régénérateur Looker lance un cycle de régénérateur pour vérifier les groupes de données et les tables persistantes à l'intervalle cron. Si un cycle de régénération du Looker est toujours en cours au prochain intervalle cron, le régénération du Looker termine le cycle en cours, puis attend le prochain intervalle cron pour commencer le cycle suivant.

Le paramètre Calendrier de maintenance accepte une expression cron. La valeur par défaut est */5 * * * *, ce qui signifie que le cycle de régénérateur Looker lance un cycle à intervalle de cinq minutes si le cycle de régénérateur précédent est terminé. Si le cycle de régénération précédent n'est pas terminé, le régénérateur Looker démarrera à l'intervalle de cinq minutes suivant la fin de son cycle.

La valeur par défaut de cinq minutes est également l'intervalle le plus fréquent accepté pour le calendrier de maintenance. Looker n'applique pas d'intervalle maximal pour le planning de maintenance. Vous pouvez donc prolonger l'intervalle entre les cycles de régénération de Looker aussi longtemps que spécifié par une expression cron. N'oubliez pas que des cycles de régénération Looker plus longs peuvent avoir un impact négatif sur la fraîcheur des données de votre cache et de vos tables persistantes.

Une fois que le régénérateur Looker a effectué toutes les vérifications et la régénération des tables PDT d'un cycle, il attend l'intervalle cron suivant pour lancer le cycle suivant. Si vous avez des builds de table PDT de longue durée, vous pouvez avoir de longues périodes entre les cycles de régénération de Looker. D'autres facteurs peuvent affecter le temps de régénération de vos tables, comme décrit dans la section Éléments importants à prendre en compte lors de la mise en œuvre de tables persistantes de la page Tables dérivées dans Looker.

Si votre base de données n'est pas active 24h/24 et 7j/7, vous pouvez limiter les vérifications aux moments d'activité de votre base de données. Voici quelques expressions cron supplémentaires:

Expression cron Définition
*/5 8-17 * * MON-FRI Vérifier les groupes de données et les tables PDT toutes les 5 minutes pendant les heures de travail, du lundi au vendredi
*/5 8-17 * * * Vérifier les groupes de données et les tables PDT toutes les 5 minutes pendant les heures de travail, au quotidien
0 8-17 * * MON-FRI Vérifier les groupes de données et les tables PDT toutes les heures pendant les heures de travail, du lundi au vendredi
1 3 * * * Vérifier les groupes de données et les tables PDT tous les jours à 3 h 01

Voici quelques points à prendre en compte lorsque vous créez une expression cron:

  • Looker utilise parse-cron v0.1.3, qui n'est pas compatible avec ? dans les expressions cron.
  • L'expression cron utilise le fuseau horaire de l'application Looker pour déterminer quand les vérifications sont effectuées.
  • Si les tables PDT ne sont pas créées, rétablissez la valeur par défaut de la chaîne cron, qui est */5 * * * *.

Vous trouverez ci-dessous quelques ressources pour vous aider à créer des chaînes cron:

SSL

Choisissez si vous souhaitez utiliser le chiffrement SSL pour protéger les données pendant leur transition entre Looker et votre base de données. SSL n'est qu'une des options permettant de protéger vos données. D'autres options sécurisées sont décrites sur la page de documentation Sécurisation de l'accès à la base de données.

Vérifier le protocole SSL

Choisissez si vous souhaitez demander une vérification du certificat SSL utilisé par la connexion. Si la vérification est requise, l'autorité de certification (AC) SSL qui a signé le certificat SSL doit provenir de la liste des sources fiables du client. Si l'AC n'est pas une source fiable, la connexion de base de données n'est pas établie.

Si cette case n'est pas cochée, le chiffrement SSL est toujours utilisé sur la connexion, mais la vérification de la connexion SSL n'est pas requise. De fait, une connexion peut être établie lorsque l'autorité de certification ne figure pas sur la liste des sources fiables du client.

Effectuer une mise en cache préalable des tables et des colonnes

Dans SQL Runner, toutes les informations de la table sont préchargées dès que vous sélectionnez une connexion et un schéma. Cela permet à SQL Runner d'afficher les colonnes de la table rapidement dès que vous cliquez sur un nom de table. Néanmoins, pour les connexions et les schémas comportant de nombreuses tables ou des tables très volumineuses, il se peut que vous ne souhaitiez pas que SQL Runner précharge l'ensemble des informations.

Si vous préférez que SQL Runner charge les informations de la table seulement lorsqu'une table est sélectionnée, vous pouvez désélectionner l'option Effectuer une mise en cache préalable des tables et des colonnes pour désactiver le préchargement de SQL Runner pour la connexion.

Récupérer et mettre en cache le schéma

Pour certaines fonctionnalités d'écriture SQL telles que la connaissance des agrégations, Looker utilise le schéma d'informations de votre base de données pour optimiser l'écriture SQL. Si le schéma d'informations n'est pas mis en cache, Looker peut être amené à bloquer l'écriture SQL sur la base de données afin de pouvoir récupérer le schéma d'informations. Pour les dialectes qui utilisent le système de fichiers distribué Hadoop (HDFS), l'extraction du schéma d'informations peut prendre suffisamment de temps pour affecter de manière significative les performances de vos requêtes Looker. Si vous savez que votre schéma d'informations est lent, vous pouvez désactiver l'option Extraire et mettre en cache le schéma pour votre connexion. Si vous désactivez cette fonctionnalité, certaines fonctionnalités ne seront pas optimisées par Looker SQL. Nous vous recommandons donc d'activer l'option Récupérer et mettre en cache le schéma, sauf si vous savez que le schéma d'informations de votre connexion est particulièrement lent.

Estimation du coût

Le bouton Estimation des coûts ne s'applique qu'aux connexions de base de données suivantes:

Le bouton d'activation/de désactivation Estimation des coûts active les fonctionnalités suivantes sur la connexion:

Pour en savoir plus, consultez la page de documentation Explorer les données dans Looker.

Pooling de connexions de base de données

Pour les dialectes compatibles avec le regroupement de connexions de base de données, cette fonctionnalité permet à Looker d'utiliser des pools de connexions via le pilote JDBC. Le regroupement de connexions de base de données améliore les performances des requêtes. Une nouvelle requête n'a pas besoin de créer une nouvelle connexion de base de données, mais peut utiliser une connexion existante du pool de connexions. La fonctionnalité de pool de connexions garantit qu'une connexion est nettoyée après l'exécution d'une requête et qu'elle peut être réutilisée une fois l'exécution de la requête terminée. Pour en savoir plus, consultez la page de documentation Pool de connexions à la base de données.

Paramètres des tables dérivées persistantes (PDT)

Les paramètres suivants s'affichent si les tables dérivées persistantes sont activées.

Activer les PDT

Activez l'option Activer les PDT pour activer les tables dérivées persistantes. Lorsque les tables PDT sont activées, la fenêtre Connection (Connexion) affiche des champs PDT supplémentaires et la section PDT Overrides (Remplacements pour les tables PDT). Looker n'affiche l'option Activer les tables PDT que si le dialecte de base de données prend en charge l'utilisation des tables PDT.

Remarques à propos des PDT :

  • Les tables PDT ne sont pas prises en charge pour les connexions Snowflake qui utilisent OAuth.
  • La désactivation des tables PDT sur une connexion ne désactive pas les groupes de données associés à vos tables PDT. Même si vous désactivez les tables PDT, les groupes de données existants exécuteront toujours leurs requêtes sql_trigger sur la base de données. Si vous souhaitez empêcher un groupe de données d'exécuter sa requête sql_trigger sur votre base de données, vous devez supprimer ou commenter le paramètre datagroup de votre projet LookML. Vous pouvez également modifier le paramètre Calendrier de maintenance des groupes de données et des tables de données de production pour la connexion afin que Looker vérifie les tables de données de production et les groupes de données très rarement ou jamais.
  • Pour les connexions Snowflake, Looker définit la valeur du paramètre AUTOCOMMIT sur TRUE (valeur par défaut de Snowflake). AUTOCOMMIT est nécessaire pour les commandes SQL exécutées par Looker afin de gérer son système d'enregistrement des tables PDT.

Base de données temporaire

Même s'il s'agit d'une base de données temporaire étiquetée, vous devez saisir le nom de la base de données ou du schéma (selon votre dialecte SQL) que Looker doit utiliser pour créer des tables dérivées persistantes. Vous devez configurer cette base de données ou ce schéma à l'avance en utilisant les autorisations en écriture appropriées. Sur la page de documentation Instructions de configuration de la base de données, sélectionnez le dialecte de votre base de données afin de consulter les instructions associées à ce dialecte.

Chaque connexion doit avoir sa propre base de données temporaire ou son propre schéma. Ces éléments ne peuvent pas être partagés entre les connexions.

Nombre maximal de connexions du générateur de PDT

Le paramètre Nombre maximal de connexions du générateur PDT vous permet de spécifier le nombre de tables simultanées que le générateur de Looker peut lancer sur votre connexion à la base de données. Le paramètre Nombre maximal de connexions du générateur de PDT ne s'applique qu'aux types de tables pour lesquels le régénérateur Looker lance des reconstructions:

  • Tables persistantes à déclenchement (tables dérivées persistantes et tables agrégées qui utilisent la stratégie de persistance datagroup_trigger ou sql_trigger_value).
  • Tables persistantes qui utilisent la stratégie persist_for, mais uniquement lorsque la table persist_for fait partie d'une cascade de tables dérivées, où elle dépend d'une table qui utilise la stratégie de persistance datagroup_trigger ou sql_trigger_value. Dans ce cas, le régénérateur Looker recréera une table persist_for, étant donné que la table est nécessaire pour recréer une autre table dans la cascade. Sinon, le régénérateur ne lance pas de créations de tables persist_for.

Le paramètre Nombre maximal de connexions du générateur de PDT est défini par défaut sur 1, mais peut être augmenté jusqu'à 10. Toutefois, cette valeur ne peut pas être supérieure à celle définie dans le champ Connexions max. par nœud ou dans per-user-query-limit défini dans les options de démarrage de Looker.

Vous devez configurer cette valeur attentivement. Si cette valeur est trop élevée, vous risquez de submerger votre base de données. Si cette valeur est faible, les tables PDT ou agrégées de grande taille peuvent retarder la création d'autres tables persistantes ou ralentir les autres requêtes sur la connexion. Les bases de données qui prennent en charge les environnements multi-tenant, telles que BigQuery, Snowflake et Redshift, peuvent gagner en performances lors de la gestion de créations de requêtes en parallèle.

Si vous souhaitez augmenter le paramètre Nombre maximal de connexions du générateur de PDT, nous vous recommandons de l'augmenter par incréments de 1. En cas de comportement inattendu, rétablissez la valeur par défaut de 1. Sinon, si les performances des requêtes ne sont pas affectées, vous pouvez continuer à l'augmenter par incréments de 1 et à vérifier les performances à chaque incrément avant d'augmenter davantage le paramètre.

Remarques concernant le paramètre Nombre maximal de connexions du générateur de PDT:

  • Le paramètre Nombre maximal de connexions du générateur de PDT ne s'applique qu'aux connexions requises pour la reconstruction des tables, et non aux connexions nécessaires pour les vérifications des déclencheurs. Un contrôle de déclenchement est une requête permettant de savoir si la stratégie de persistance de la table est déclenchée. Ces requêtes de contrôle de déclenchement étant toujours exécutées successivement, le paramètre Nombre maximal de connexions du générateur de PDT ne s'applique pas.
  • Dans une instance Looker en cluster, le régénérateur s'exécute uniquement sur le nœud principal. Le paramètre Max Number of PDT Builder Connections (Nombre maximal de connexions du générateur de PDT) ne s'applique qu'au nœud principal et, par conséquent, définit la limite pour l'ensemble du cluster.
  • Le paramètre Nombre maximal de connexions du générateur de PDT ne s'applique pas aux types de tables suivants. Ces types de tables sont créés les uns après les autres :
    • Les tables sont conservées via le paramètre persist_for (sauf si elles sont utilisées par des tables utilisant les stratégies datagroup_trigger ou sql_trigger_value).
    • Tables en mode Développement
    • Tables recréées avec l'option Rebuild Derived Tables & Run (Recréer les tables dérivées et exécuter).
    • Tables lorsque l'une dépend d'une autre dans une cascade de dépendances. Une table ne peut pas être créée en même temps qu'une table dont elle dépend. Par exemple, si table_B dépend de table_A, table_A doit terminer la recompilation avant que table_B puisse commencer.

Relancer les générations de tables dérivées persistantes en échec

Le bouton Réessayer les builds de PDT ayant échoué configure la façon dont le régénérateur Looker tente de régénérer les tables dérivées à déclenchement ayant échoué lors du cycle de régénérateur précédent. Le régénérateur Looker est le processus qui reconstruit les tables persistantes à déclenchement (tables PDT et tables agrégées) en fonction de l'intervalle configuré dans le paramètre de connexion Calendrier de maintenance. Lorsque l'option Retry Failed PDT Builds (Réessayer les générations de PDT ayant échoué) est activée, le régénérateur Looker tente de régénérer une table PDT dont la génération a échoué lors du cycle de régénérateur précédent, même si la condition de déclenchement de la table PDT n'est pas remplie. Lorsque ce paramètre est désactivé, le régénérateur Looker tentera de régénérer une table PDT dont la génération a échoué uniquement lorsque la condition de déclenchement de la table PDT est satisfaite. L'option Retry Failed PDT Builds (Réessayer les générations de tables dérivées persistantes en échec) est désactivée par défaut.

Pour en savoir plus sur le générateur Looker, consultez la page de documentation Tables dérivées dans Looker.

Contrôle des tables dérivées persistantes via l'API

Le bouton Contrôle des tables dérivées persistantes via l'API détermine si les appels d'API start_pdt_build, check_pdt_build et stop_pdt_build peuvent être utilisés pour cette connexion. Lorsque le bouton Commande API PDT est désactivé, ces appels d'API échouent lorsqu'ils font référence aux PDT sur cette connexion. Le bouton Contrôle des tables dérivées persistantes via l'API est désactivé par défaut.

Activer les remplacements pour les PDT

Si votre base de données est compatible avec les tables dérivées persistantes et que vous avez activé l'option Activer les tables dérivées persistantes dans les paramètres de connexion, Looker affiche la section Forcer les tables dérivées persistantes. Dans la section Remplacements pour les PDT, vous pouvez saisir des paramètres JDBC distincts (hôte, port, base de données, nom d'utilisateur, mot de passe, schéma, paramètres supplémentaires et instructions post-connexion) qui sont spécifiques aux processus PDT. Cette possibilité est précieuse pour plusieurs raisons :

  • En créant un utilisateur de base de données distinct pour les processus PDT, vous pouvez utiliser des PDT dans votre projet Looker, même si vous attribuez des attributs utilisateur à vos identifiants de connexion à la base de données ou si vous utilisez OAuth pour votre connexion à la base de données.
  • Les processus PDT peuvent s'authentifier par l'intermédiaire d'un utilisateur de base de données distinct dont la priorité est plus élevée. La base de données peut ainsi placer les jobs PDT en priorité au détriment des requêtes de moindre importance des utilisateurs.
  • L'accès en écriture peut être révoqué pour la connexion standard à la base de données Looker, et être octroyé seulement à un utilisateur spécifique que les processus PDT utiliseront pour s'authentifier. Il s'agit d'une meilleure stratégie de sécurité pour la plupart des organisations.
  • Pour les bases de données telles que Snowflake, les processus PDT peuvent être acheminés vers du matériel plus puissant qui n'est pas partagé avec les autres utilisateurs de Looker. Les tables PDT peuvent ainsi être créées rapidement en évitant les coûts inhérents à l'exécution d'un matériel onéreux à temps plein.

Par exemple, dans une connexion où les champs de nom d'utilisateur et de mot de passe sont définis avec des attributs utilisateur, la section Forcer le PDT peut créer un utilisateur distinct (pdt_user) avec son propre mot de passe. Avec cette configuration, les événements suivants se produisent:

  • Chaque utilisateur peut accéder à la base de données avec ses propres identifiants, tels qu'ils sont attribués par ses attributs utilisateur.
  • Le compte pdt_user sera utilisé pour l'ensemble des processus PDT, avec des niveaux d'accès adaptés à la création et à la mise à jour de tables PDT.
  • Le trafic des requêtes utilisateur et le trafic des processus PDT peuvent être rapidement différenciés à des fins telles que la surveillance avec l'activité système.

Fuseau horaire de la base de données

Le fuseau horaire dans lequel votre base de données stocke les informations temporelles. Looker doit connaître cette information afin de convertir les valeurs de date/heure pour les utilisateurs et ainsi simplifier la compréhension et l'utilisation des données temporelles. Pour en savoir plus, consultez la page de documentation Utiliser les paramètres de fuseau horaire.

Requête Fuseau horaire

L'option Fuseau horaire de la requête n'est visible que si vous avez désactivé les fuseaux horaires spécifiques à l'utilisateur.

Lorsque les fuseaux horaires spécifiques à l'utilisateur sont désactivés, le fuseau horaire de la requête est celui qui s'affiche pour vos utilisateurs lorsqu'ils interrogent des données basées sur l'heure. Il s'agit également du fuseau horaire dans lequel Looker convertira les données basées sur l'heure à partir du fuseau horaire de la base de données.

Pour en savoir plus, consultez la page de documentation Utiliser les paramètres de fuseau horaire.

Développez la section Status Details (Détails de l'état) pour tester les paramètres de votre connexion.

Examiner

Vous pouvez tester vos paramètres de connexion à plusieurs endroits dans l'interface utilisateur de Looker:

  • Sélectionnez le bouton Test en bas de la page Paramètres des connexions.
  • Sélectionnez le bouton Test à côté de la liste de la connexion sur la page Administration des connexions, comme décrit sur la page de documentation Connexions.
  • Sélectionnez le bouton Vérifier en bas de chaque étape de la configuration de la connexion. Dans la section Vérifier, examinez et modifiez les informations de connexion que vous avez saisies dans les sections précédentes. Développez la section Status Details (Détails de l'état) pour tester les paramètres de votre connexion. Cliquez sur l'icône Modifier à côté de chaque section pour y revenir et modifier vos paramètres.

Si votre connexion ne réussit pas un ou plusieurs tests, voici quelques options de dépannage:

  • Essayez quelques étapes de dépannage disponibles sur la page de documentation Testing database connectivity (Tester la connectivité de la base de données).
  • Si vous exécutez Mongo 3.6 ou une version antérieure sur Atlas et que vous rencontrez une défaillance de liaison de communication, consultez la page de documentation du connecteur MongoDB.
  • Pour recevoir des messages indiquant une connexion réussie concernant le schéma et les tables PDT temporaires, vous devrez avoir activé cette fonctionnalité au moment du paramétrage de votre base de données Looker. Pour ce faire, consultez la page de documentation Instructions pour la configuration de la base de données.

Les connexions de base de données qui utilisent OAuth, telles que Snowflake et Google BigQuery, nécessitent une connexion utilisateur. Si vous n'êtes pas connecté à votre compte utilisateur OAuth lorsque vous testez l'une de ces connexions, Looker émet un avertissement accompagné du lien Se connecter. Cliquez sur le lien pour saisir vos identifiants OAuth ou pour autoriser Looker à accéder à vos informations de compte OAuth.

Si vous rencontrez encore des difficultés, contactez le support Looker pour obtenir de l'aide.

Si vous avez défini une ou plusieurs valeurs de paramètre de connexion sur un attribut utilisateur, l'option Tester en tant qu'utilisateur s'affiche. Sélectionnez un utilisateur, puis cliquez sur Test (Tester) pour vérifier que la base de données peut se connecter et exécuter des requêtes en tant que cet utilisateur.

Étapes suivantes

Une fois votre base de données connectée à Looker, vous pouvez configurer des options de connexion pour vos utilisateurs.