Connexion BigQuery par défaut pour Looker (Google Cloud Core)

Looker (Google Cloud Core) doit être connecté à une base de données pour permettre l'exploration des données. Vous pouvez créer une connexion BigQuery par défaut pouvant utiliser les identifiants par défaut de l'application à l'aide de la connexion BigQuery Quickstart.

Carte de démarrage rapide BigQuery sur une page d'accueil.

Avant de commencer

Pour configurer une connexion BigQuery Quickstart, vous devez disposer des autorisations suivantes.

Autorisations Looker (Google Cloud Core)

Vous pouvez afficher et modifier la page Connexion de démarrage rapide BigQuery sur la page Accueil de votre instance Looker (Google Cloud Core) si vous disposez de l'une des autorisations suivantes:

Autorisations BigQuery

Les instances Looker (Google Cloud Core) peuvent utiliser les identifiants par défaut de l'application (ADC) pour s'authentifier lorsque vous configurez une connexion à une base de données SQL standard BigQuery. Lorsque vous utilisez les ADC, la connexion s'authentifie auprès de la base de données à l'aide des identifiants du compte de service du projet Looker (Google Cloud Core).

Si le compte de service Looker (Google Cloud Core) ne dispose pas déjà de rôles IAM dans le projet contenant l'ensemble de données BigQuery, vous devez être autorisé à modifier les stratégies IAM dans la console Google Cloud en procédant comme suit.

  1. Connectez-vous à la console Google Cloud , puis accédez au projet auquel vous souhaitez attribuer de nouveaux rôles.
  2. Copiez l'identifiant du compte principal et ajoutez-le en tant que compte principal dans IAM.
  3. Attribuez les deux rôles suivants au compte principal que vous avez ajouté :
    • Service Usage Consumer
    • BigQuery Jobs User

Si votre instance Looker (Google Cloud core) utilise des tables dérivées persistantes avec un ensemble de données BigQuery, vous devez également accorder au compte de service Looker (Google Cloud core) le rôle IAM d'Éditeur de données BigQuery.

Configurer une connexion au démarrage rapide BigQuery

La connexion de démarrage rapide BigQuery contient les sections suivantes.

Vue de la connexion

Les utilisateurs disposant des autorisations appropriées peuvent consulter et modifier la connexion de démarrage rapide BigQuery depuis la page Accueil ou Connexions du panneau d'administration. Sur la page Connexions, la connexion BigQuery de démarrage rapide s'affiche sous le nom Connexion BigQuery par défaut. Dans une nouvelle instance, les champs ID du projet de stockage et ID du projet de facturation sont définis par défaut sur Aucun.

Sur la page Accueil, cliquez sur le bouton Examiner la connexion pour la gérer. Vous pouvez ignorer la carte de la page Accueil en cliquant sur le x ou en désactivant l'option Démarrage rapide de BigQuery dans la barre latérale "Découvrir".

La connexion de démarrage rapide BigQuery contient les sections suivantes.

ID du projet de facturation

L'ID de projet sert d'identifiant unique pour le projet de facturation Google Cloud . Le projet de facturation est le projet Google Cloud qui est facturé. Toutefois, vous pouvez toujours interroger des ensembles de données dans un autre projet Google Cloud si vos développeurs LookML spécifient des noms de table entièrement définis dans le paramètre sql_table_name de vos vues, explorations ou jointures LookML. Champ obligatoire.

Pour vous authentifier auprès d'une base de données BigQuery à l'aide d'OAuth: pour les connexions BigQuery, Looker (Google Cloud Core) peut automatiquement utiliser les identifiants d'application OAuth que votre administrateur Looker (Google Cloud Core) a utilisés pour créer l'instance. Pour en savoir plus, consultez la page Créer des identifiants d'autorisation OAuth pour une instance Looker (Google Cloud Core).

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

Ensemble de données principal

La page Ensemble de données principal contient les paramètres suivants.

ID de projet Cloud Storage

Si vous utilisez un projet autre que le projet BigQuery dans lequel se trouve Looker (Google Cloud Core), saisissez l'ID du projet Storage. Champ obligatoire.

Pour trouver votre ID de projet Cloud Storage, procédez comme suit:

  1. Ouvrez la console Google Cloud .
  2. Dans la liste des projets, sélectionnez Tous. Les noms et ID de tous les projets dont vous êtes membre s'affichent.
  3. Copiez l'ID du projet Storage du projet contenant les données que vous souhaitez connecter à Looker (Google Cloud Core).

Ensemble de données principal

BigQuery recherchera des tables dans l'ensemble de données principal si leur emplacement n'est pas spécifié dans le texte de la requête SQL. Notez que les requêtes Looker (Google Cloud Core) peuvent faire référence à des tables de n'importe quel projet ou ensemble de données, à condition que les requêtes utilisent des noms de tables complets au format project_id.dataset_name.table_name. L'agent de service Looker (Google Cloud Core) aura également besoin des autorisations IAM appropriées pour accéder aux tables à cet emplacement. Champ obligatoire.

Pour en savoir plus sur les ensembles de données, consultez la page de documentation Connecter Looker à BigQuery.

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

Paramètres facultatifs

La section Paramètres facultatifs contient les options suivantes:

  • Nombre maximal de connexions par nœud: nombre maximal de connexions simultanées à la base de données. Remarque: Ce paramètre s'applique à chaque nœud du déploiement Looker (Google Cloud Core). La valeur doit être comprise entre 5 et 100. Vous pouvez conserver la valeur par défaut au départ. Pour en savoir plus sur ce paramètre, consultez la section Connexions maximales par nœud de la page de documentation Connecter Looker à votre base de données.

  • Délai avant expiration du pool de connexions: durée d'attente, en secondes, avant l'expiration d'une requête lorsque le pool de connexions est saturé. vous pouvez conserver la valeur par défaut indiquée. Pour en savoir plus sur ce paramètre, consultez la section Délai avant expiration du pool de connexions de la page de documentation Connecter Looker à votre base de données.

  • Paramètres JDBC supplémentaires: ajoutez des paramètres JDBC supplémentaires, tels que des étiquettes BigQuery (pour en savoir plus, consultez la section Étiquettes de tâches et commentaires de contexte pour les connexions BigQuery sur cette page).

  • Calendrier de maintenance: expression Cron indiquant la fréquence maximale des vérifications des déclencheurs de groupe de données et de la maintenance des PDT. Pour en savoir plus sur ce paramètre, consultez la documentation Planification du suivi des tables PDT et des groupes de données.

  • SSL: indiquez si vous souhaitez utiliser le chiffrement SSL pour protéger les données lors de leur transfert entre Looker (Google Cloud Core) 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.

  • Valider SSL: indiquez si vous souhaitez demander une validation du certificat SSL utilisé par la connexion. Pour en savoir plus sur ce paramètre, consultez la section Valider le protocole SSL de la page de documentation Connecter Looker à votre base de données.

  • 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.

  • Extraire et mettre en cache le schéma: pour certaines fonctionnalités d'écriture SQL telles que la connaissance des agrégations, Looker (Google Cloud Core) utilise le schéma d'informations de votre base de données pour optimiser l'écriture SQL. Pour en savoir plus sur ce paramètre, consultez la section Extraire le schéma d'informations de l'écriture SQL de la page de documentation Connecter Looker à votre base de données.

  • Activer les PDT: activez l'option Activer les PDT pour activer les tables dérivées persistantes. Lorsque les PDT sont activés, la fenêtre Paramètres facultatifs affiche des champs PDT supplémentaires et la section Remplacements pour les PDT.

  • Base de données temporaire: saisissez l'ensemble de données dans BigQuery, où Looker (Google Cloud Core) créera des tables dérivées persistantes. Vous devez configurer cet ensemble de données à l'avance, avec les autorisations en écriture appropriées. Ce champ est obligatoire pour utiliser les PDT.

  • Nombre maximal de connexions du générateur de PDT: le paramètre Nombre maximal de connexions du générateur de PDT est défini par défaut sur 1, mais peut être défini sur 10. Toutefois, cette valeur ne peut pas être supérieure à celle définie dans Connexions maximales par nœud. Pour en savoir plus sur ce paramètre, consultez la section Nombre maximal de connexions du générateur PDT de la page de documentation Connecter Looker à votre base de données. 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.

  • Réessayer les PDT dérivées persistantes en échec: le bouton Réessayer les générations de PDT persistantes en échec configure la façon dont le régénérateur Looker (Google Cloud Core) tente de régénérer les tables dérivées persistantes déclenchées qui ont échoué lors du cycle de régénérateur précédent. Pour en savoir plus sur ce paramètre, consultez la section Réessayer les PDT persistantes en échec de la page de documentation Connecter Looker à votre base de données.

  • 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.

  • Forcer les tables dérivées persistantes: 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 (Google Cloud Core) 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. Pour en savoir plus sur ce paramètre, consultez la section Forcer les données de type PDT de la page de documentation Connecter Looker à votre base de données.

  • Fuseau horaire de la base de données: fuseau horaire dans lequel votre base de données stocke les informations temporelles. Looker (Google Cloud Core) 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.

  • Fuseau horaire de la requête: l'option Fuseau horaire de la requête n'est visible que si vous avez désactivé les fuseaux horaires spécifiques à l'utilisateur. 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

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.

Enregistrer et tester la connexion

Cliquez sur le bouton Enregistrer pour enregistrer les modifications apportées à la connexion de démarrage rapide BigQuery.

Vous pouvez tester vos paramètres de connexion à plusieurs endroits dans l'interface utilisateur de Looker (Google Cloud Core) :

  • Développez la section Détails de l'état en bas de l'une des pages de connexion de démarrage rapide, puis cliquez sur Tester la connexion.
  • Sur la page Accueil, développez la section Détails de l'état en bas de la carte "Connexion QuickStart", puis cliquez sur Tester la connexion.
  • Sur la page d'administration Connexions, sélectionnez le bouton Test à côté de la liste de la connexion, comme décrit sur la page de documentation Connexions.

Une fois que vous avez saisi les paramètres de connexion, cliquez sur Tester pour vérifier que les informations sont correctes et que la base de données est en mesure de se connecter.

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

Étape suivante