Paramètres Admin – Connexions

Pour accéder à la page Connexions, ouvrez le menu Admin, puis sous Base de données, sélectionnez Connexions.

Afficher les connexions

Sur la page Connexions, vous pouvez afficher vos connexions de base de données et les adresses IP nécessaires pour autoriser le trafic réseau. Si la création d'une base de données a été activée pour votre instance, vous pouvez également ajouter une connexion.

Onglet "Bases de données"

L'onglet Bases de données affiche des informations de base sur les connexions de base de données que vous avez définies. Elle affiche également toutes les connexions gérées par Looker que vous avez créées, si la possibilité de créer une base de données a été activée pour votre instance. Vous pouvez également tester l'état de ces connexions et modifier leur configuration depuis l'onglet Bases de données.

Vous pouvez cliquer sur Adresses IP publiques pour afficher la liste des adresses IP nécessaires pour autoriser le trafic réseau depuis votre instance Looker. L'ensemble du trafic réseau émanant de Looker provient de l'une des adresses IP répertoriées suivantes, selon la région où votre instance Looker est hébergée. Empêcher le trafic à destination de votre base de données, sauf s'il provient de ces adresses IP et d'autres adresses dignes de confiance, est un moyen de limiter l'accès aux données.

Si vous disposez du rôle Administrateur, vous pouvez cliquer sur le bouton Tester l'accessibilité en haut de la page Connexions de Looker pour vérifier si Looker peut accéder à un nom d'hôte et à un port sur le réseau. Pour en savoir plus, consultez Diagnostics de joignabilité du réseau.

Le tableau suivant décrit les éléments de l'onglet Bases de données :

Colonne Description
Nom Nom de la connexion, que vous avez choisi, utilisé dans le paramètre LookML connection. Lorsque vous testez la connexion, Looker affiche la liste des vérifications d'état sous le nom de la connexion.
Base de données Nom de la base de données que Looker interrogera lors de l'utilisation de cette connexion.
Champ d'application Indique si la connexion peut être utilisée avec tous les projets ou un seul projet spécifique.
Serveur SSH Nom de la configuration du serveur SSH utilisée pour créer un tunnel SSH vers votre base de données. Cette colonne ne s'affiche que si l'onglet Serveurs SSH est activé sur votre instance Looker.
SSL Si vous utilisez ou non le chiffrement SSL pour protéger les données qui transitent entre Looker et votre base de données (il existe d'autres options sécurisées que SSL).
Type Dialecte SQL de la connexion à la base de données.
Actions Actions que vous pouvez effectuer pour une connexion : tester une connexion, modifier une connexion, afficher d'autres informations sur une connexion, accéder à une liste de liens vers les explorations de la connexion ou supprimer une connexion. Si la possibilité de créer une base de données a été activée pour votre instance, vous pouvez également ajouter des données provenant d'une source de données supplémentaire à n'importe quelle connexion gérée par Looker.

Onglet "Serveurs SSH"

L'onglet Serveurs SSH n'est pas disponible pour les instances Looker (Google Cloud Core).

L'option Serveur SSH est disponible si une instance Looker (original) 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 Google Cloud spécialiste des ventes ou ouvrez une demande d'assistance.

Looker choisit automatiquement le port localhost pour vous lors de la création de tunnels SSH. Vous ne pouvez pas spécifier le port localhost.

Les connexions SSH aux bases de données PrestoDB ou Trino peuvent nécessiter une configuration de base de données supplémentaire. Lorsque SSL est activé, la base de données PrestoDB ou Trino écoute par défaut sur le port 443. Pour établir le tunnel SSH, Looker doit définir le port localhost sur 443, qui est déjà utilisé par Looker. Cela entraînera l'échec de la configuration du tunnel SSH. Pour résoudre le problème, configurez votre base de données PrestoDB ou Trino de sorte qu'elle écoute sur un port autre que le port 443 lorsque SSL est activé.

L'onglet Serveurs SSH liste les configurations de serveur SSH que vous avez ajoutées, indique l'état des connexions aux serveurs SSH et liste les connexions de base de données utilisant chaque serveur SSH. Dans l'onglet Serveurs SSH, vous pouvez également tester une connexion à un serveur SSH, et ajouter ou modifier des configurations de serveur SSH.

Le tableau suivant décrit les éléments de l'onglet Serveurs SSH :

Colonne Description
Nom du serveur Nom de la configuration du serveur SSH, que vous avez choisi, utilisé pour se connecter à votre base de données.
Connexions Liste des connexions de base de données qui se connectent au serveur SSH. Cliquez sur une connexion à une base de données pour ouvrir la page Modifier la connexion correspondante.
Menu Options à trois points  Actions que vous pouvez effectuer pour une configuration de serveur SSH : tester les connexions à un serveur SSH, ajouter une connexion de base de données à un serveur SSH, modifier une configuration de serveur SSH ou supprimer une configuration de serveur SSH.

Ajouter ou modifier une configuration de serveur SSH

Pour ajouter une configuration de serveur SSH :

  1. Dans l'onglet Serveur SSH, cliquez sur Ajouter un serveur.
  2. Dans le champ Unnamed Server (Serveur sans nom) en haut à droite, saisissez un nom pour la configuration du serveur SSH.
  3. Cliquez sur Télécharger la clé pour télécharger la clé publique dans un fichier texte. Veillez à enregistrer ce fichier pour une utilisation ultérieure.
  4. Dans le champ Server Username (Nom d'utilisateur du serveur), saisissez le nom d'utilisateur que Looker utilisera pour se connecter au serveur SSH.
  5. Dans le champ Adresse IP ou nom d'hôte du serveur, saisissez l'adresse IP ou le nom d'hôte du serveur SSH.
  6. Dans le champ Port du serveur, saisissez le numéro de port utilisé pour se connecter au serveur SSH.
  7. Ajoutez la clé publique téléchargée au fichier de clés autorisées sur votre serveur SSH. Pour en savoir plus et obtenir un exemple, consultez la page de documentation Utiliser un serveur SSH.
  8. Assurez-vous que les adresses IP Looker appropriées sont ajoutées à la liste d'autorisation de votre serveur SSH afin que Looker puisse s'y connecter.
  9. Cliquez sur Tester et demander l'empreinte pour vérifier votre connexion au serveur SSH.
  10. Affichez la nouvelle configuration SSH. Sur cet écran, vous pouvez également télécharger ou afficher la clé publique, et afficher l'empreinte unique de la configuration du serveur SSH.

Pour modifier une configuration de serveur SSH existante, cliquez sur le menu à trois points Options sur la ligne du serveur SSH sélectionné, puis choisissez Détails du serveur.

Tester les connexions à un serveur SSH

Pour tester toutes les connexions de base de données à un serveur SSH :

  1. Cliquez sur le menu Options à trois points sur la ligne du serveur SSH choisi.
  2. Sélectionnez Tester les connexions.

Looker teste toutes les connexions de base de données utilisant ce serveur SSH et affiche une coche verte à côté du nom du serveur et de toutes les connexions pour lesquelles le test de connexion réussit. Un point d'exclamation rouge indique que le test de connexion a échoué.

Ajouter une connexion de base de données à un serveur SSH

Pour ajouter une connexion à une base de données à l'aide d'un serveur SSH :

  1. Cliquez sur le menu Options à trois points sur la ligne du serveur SSH choisi.
  2. Sélectionnez Ajouter une connexion.

Looker affiche la page Paramètres de connexion, avec le serveur SSH listé dans le champ Serveur SSH.

Supprimer une configuration de serveur SSH

Pour supprimer une configuration de serveur SSH :

  1. Cliquez sur le menu Options à trois points sur la ligne du serveur SSH à supprimer.
  2. Sélectionnez Supprimer le serveur.

Tester les connexions

Looker vous permet de tester vos connexions existantes pour vous assurer qu'elles fonctionnent correctement. Vous pouvez également tester les connexions à mesure que vous les ajoutez, comme décrit sur la page de documentation Connecter Looker à votre base de données.

Chaque test de connexion inclut une liste de vérifications d'état pour vous indiquer si Looker peut utiliser la connexion à la base de données.

Les problèmes potentiels sont affichés en jaune, et les erreurs en rouge. Si une connexion est "réussie", elle s'affiche en vert.

Vous pouvez vérifier l'état des éléments suivants :

  • Une seule connexion en cliquant sur Tester à l'extrême droite de cette connexion
  • Toutes les connexions en cliquant sur le bouton Tester toutes les connexions en haut de la page

Deux vérifications sont souvent confondues :

  • Le schéma temporaire est disponible
  • Peut utiliser des tables dérivées persistantes

Il n'est pas nécessaire que ces vérifications réussissent pour que Looker fonctionne. Toutefois, vous devez les réussir pour utiliser les tables dérivées persistantes, qui sont une fonctionnalité de modélisation très utile.

Diagnostic réseau

Looker fournit deux outils qui vous aident à déterminer si un problème de connexion est causé par le réseau (par exemple, une règle de pare-feu ou une route manquante) ou par la base de données (par exemple, des identifiants incorrects) :

Les deux outils recherchent le nom d'hôte dans le DNS, puis tentent d'ouvrir une connexion TCP vers chaque adresse IP renvoyée par la recherche. Comme ils utilisent des connexions TCP au lieu de requêtes ping ICMP, un hôte qui bloque les requêtes ping peut toujours apparaître comme accessible.

Diagnostic réseau dans les résultats du test de connexion

Lorsqu'un test de connexion ne parvient pas à se connecter à la base de données, Looker teste les points de terminaison suivants et ajoute les résultats à la fin du message d'erreur, sous Network Diagnostics: :

  • Pour toutes les connexions, l'hôte et le port configurés pour la connexion.
  • Pour les connexions Amazon Athena, le point de terminaison AWS Glue pour la région AWS de la connexion, sur le port 443, par exemple glue.us-east-1.amazonaws.com.
  • Pour les connexions Cloud SQL dont le champ Hôte contient un nom de connexion d'instance, tel que my-project:us-central1:my-instance, le point de terminaison sqladmin.googleapis.com sur le port 443. Le connecteur Cloud SQL utilise ce point de terminaison pour obtenir des informations sur l'instance et des certificats.

Looker teste jusqu'à trois adresses IP pour chaque point de terminaison, et les diagnostics prennent au maximum trois secondes. Looker n'exécute pas de diagnostics réseau pour les connexions qui utilisent un tunnel SSH.

Par exemple, les diagnostics suivants montrent que Looker peut atteindre le point de terminaison Athena, mais que les connexions au point de terminaison AWS Glue expirent :

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

Chaque adresse IP affiche l'un des résultats suivants :

  • success : Looker a ouvert une connexion TCP vers l'adresse IP et le port. Si toutes les adresses IP affichent success, mais que le test échoue toujours, vérifiez les paramètres de connexion, tels que les identifiants, les paramètres SSL et les autorisations de l'utilisateur de la base de données.
  • timeout (3000ms) : Looker n'a reçu aucune réponse dans les trois secondes. Ce résultat signifie souvent qu'une règle de pare-feu, un groupe de sécurité ou une route réseau manquante supprime le trafic.
  • failed: suivi d'un motif : la connexion a été refusée ou le réseau était inaccessible. Par exemple, Connection refused signifie que rien n'écoute sur le port ou qu'un pare-feu a rejeté la connexion.
  • blocked (sensitive IP) : Looker n'a pas testé l'adresse IP, car elle se trouve dans une plage restreinte.

Si la résolution DNS échoue, le point de terminaison affiche DNS resolution failed: suivi de la raison. Vérifiez que le nom d'hôte ne contient pas de fautes de frappe. Si la base de données utilise un nom d'hôte privé, assurez-vous que Looker peut le résoudre.

Diagnostics de joignabilité du réseau

Si vous disposez du rôle Administrateur Looker, vous pouvez tester un hôte de base de données avant d'ajouter une connexion, ou tester un point de terminaison dont dépend une connexion, comme sqladmin.googleapis.com sur le port 443.

Pour tester la joignabilité du réseau, procédez comme suit :

  1. Sur la page Connexions, cliquez sur le bouton Tester l'accessibilité en haut de la page.
  2. Dans la boîte de dialogue Diagnostic de la joignabilité du réseau, saisissez un nom d'hôte ou une adresse IP dans le champ Nom d'hôte ou domaine.
  3. Dans le champ Port, saisissez le port à tester. La valeur par défaut est 443.
  4. Cliquez sur Test.

Looker teste jusqu'à cinq adresses IP pour le nom d'hôte, et le test prend au maximum trois secondes. Voici un exemple de boîte de dialogue "Diagnostics de joignabilité du réseau" affichant les résultats de test pour un nom d'hôte et un port :

Boîte de dialogue "Diagnostics de joignabilité du réseau" affichant les résultats du test pour un nom d'hôte et un port.

Pour chaque adresse IP, la boîte de dialogue affiche un message, la durée de la connexion en millisecondes si elle a réussi, ainsi que l'un des états suivants :

  • Connecté : Looker a ouvert une connexion TCP vers l'adresse IP et le port.
  • Délai d'attente dépassé : Looker n'a reçu aucune réponse dans un délai de trois secondes.
  • Échec : la connexion a été refusée ou le réseau était inaccessible. Le message indique la raison.
  • SSRF bloqué : Looker n'a pas testé l'adresse IP, car elle se trouve dans une plage restreinte. Ces restrictions protègent contre la falsification de requête côté serveur (SSRF).

Si Looker ne parvient pas à résoudre le nom d'hôte ou si le port est restreint, la boîte de dialogue affiche un message d'erreur au lieu des résultats.

Adresses et ports restreints

Pour protéger votre instance, le diagnostic réseau Looker ne teste pas les adresses IP des plages suivantes :

  • Les plages d'adresses de bouclage, de liaison locale, de multidiffusion et d'autres plages d'adresses restreintes, y compris l'adresse du serveur de métadonnées 169.254.169.254.
  • Plages d'adresses privées (10.0.0.0/8, 172.16.0.0/12 et 192.168.0.0/16) sur les instances Looker (Google Cloud Core) qui n'utilisent que des connexions sécurisées publiques.

De plus, la fonction Tester l'accessibilité ne teste pas certains ports restreints pour des raisons de sécurité, comme le port 22. Si vous saisissez l'un de ces ports, la boîte de dialogue affiche un message tel que Port 22 is restricted from diagnostic probing for security reasons.

Ajouter des connexions

Pour ajouter une connexion de base de données, suivez la procédure décrite sur la page de documentation Connecter Looker à votre base de données.

Modifier des connexions

Pour modifier une connexion existante, ouvrez la page Connexions en sélectionnant le menu Admin, puis, sous Base de données, choisissez Connexions. Cliquez sur le bouton Modifier de la connexion. La page que vous utilisez pour créer une connexion s'affiche (comme décrit sur la page de documentation Connecter Looker à votre base de données), mais les informations pertinentes sont déjà renseignées. Apportez les modifications nécessaires, puis cliquez sur Mettre à jour la connexion.

Actions disponibles pour toutes les connexions

Toutes les connexions proposent ces options dans le menu déroulant en forme de roue dentée situé à l'extrême droite de chaque connexion :

Option Description
Exécuteur SQL Cette option vous redirige vers l'exécuteur SQL de Looker, avec la connexion et le schéma appropriés déjà sélectionnés.
Explorer Cette option vous redirige vers une liste d'options d'exploration de base générées automatiquement pour votre connexion. Ils ne sont pas basés sur vos modèles de données personnalisés, mais ils permettent de générer rapidement des rapports sur les données brutes des tables de votre connexion. En général, cela n'est utile que pour avoir une idée du contenu de la table avant la modélisation, plutôt que pour l'analyse des données proprement dite.
Supprimer Pour supprimer une connexion existante, cliquez sur le menu déroulant en forme de roue dentée situé tout à droite d'une connexion, puis sélectionnez Supprimer. Vous serez invité à confirmer la suppression, mais une fois que vous l'aurez fait, l'opération sera irréversible. La suppression accidentelle d'une connexion désactive toutes les requêtes qui l'utilisent et peut entraîner des erreurs de validation LookML pour les développeurs. Toutefois, si vous recréez une connexion portant le même nom, la fonctionnalité sera restaurée.

Actions disponibles pour certaines connexions

Selon le dialecte de connexion, le menu déroulant en forme de roue dentée à droite de la connexion peut proposer les options supplémentaires suivantes :

Option Description
Afficher les tables Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker en fonction des métadonnées de votre connexion. Bien que cette option commence par le nom du schéma, le nom de la table et le nombre de colonnes sélectionnés, vous pouvez la manipuler comme n'importe quelle autre exploration Looker.
Afficher les bases de données Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker en fonction des métadonnées de votre connexion. Bien que cette option commence par le nom du schéma, le nom du catalogue, le nombre de tables et le nombre de colonnes sélectionnés, vous pouvez la manipuler comme n'importe quelle autre exploration Looker.
Afficher les processus Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker basées sur les processus en cours d'exécution sur cette connexion, leur état, leur durée d'exécution et d'autres informations. Cela peut être utile pour déterminer la cause d'un ralentissement de Looker ou d'une requête qui ne s'exécute pas du tout.
Afficher le journal des événements PDT Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker basées sur l'activité des tables dérivées pour cette connexion. Les champs disponibles sont décrits plus en détail sur notre page de documentation Tables dérivées persistantes.

Supprimer une connexion de base de données de manière sécurisée

La suppression d'une connexion de base de données qui est toujours référencée par des modèles LookML entraîne des erreurs de validation qui peuvent empêcher les développeurs de valider ou de fusionner des branches. Pour supprimer une connexion en toute sécurité, procédez comme suit :

  1. Identifier les dépendances : en mode Développement, utilisez la recherche de projet pour connection: CONNECTION_NAME afin de trouver tous les fichiers de modèle LookML qui font référence à la connexion.
  2. Supprimer les dépendances : mettez à jour le paramètre connection dans ces fichiers de modèle pour qu'il pointe vers une connexion valide, ou supprimez les modèles dépendants s'ils ne sont plus nécessaires.
  3. Valider le contenu : exécutez la Validation de contenu pour identifier et corriger les Looks ou les tableaux de bord qui s'appuyaient sur les modèles utilisant la connexion.
  4. Déployer les modifications : validez et déployez ces modifications LookML dans la branche de production.
  5. Supprimer la connexion : une fois toutes les références supprimées de la branche de production, accédez à Admin > Base de données > Connexions, puis supprimez la connexion.