Paramètres d'administration - Connexions

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

Afficher les connexions

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

Onglet "Bases de données"

L'onglet Bases de données affiche des informations de base sur les connexions à la base de données que vous avez définies. Il 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 à partir de l'onglet Bases de données.

Vous pouvez cliquer sur Adresses IP publiques pour afficher la liste des adresses IP requises pour autoriser le trafic réseau provenant de votre instance Looker. L'ensemble du trafic réseau provenant de Looker proviendra de l'une des adresses IP indiquées, en fonction de la région où votre instance Looker est hébergée. Interdire le trafic vers votre base de données, sauf à partir de ces adresses IP et d'autres adresses IP approuvées, est un moyen de limiter l'accès aux données.

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

Colonne Description
Nom Nom de la connexion, que vous avez choisi, qui est 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é dans votre instance Looker.
SSL Indique si vous utilisez ou non le chiffrement SSL pour protéger les données transférées entre Looker et votre base de données (il existe d'autres options sécurisées en plus de 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 d'une source de données supplémentaire à n'importe quelle connexion gérée par Looker.

Onglet Serveurs SSH

L'option Serveur SSH n'est disponible que si l'instance est déployée sur l'infrastructure Kubernetes et uniquement si l'ajout des 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 des ventes Google Cloud ou envoyez une demande d'assistance.

Looker choisit automatiquement le port localhost pour vous lors de la création des 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 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 pour qu'elle écoute sur un port autre que le port 443 lorsque SSL est activé.

L'onglet Serveurs SSH répertorie les configurations de serveur SSH que vous avez ajoutées, indique l'état des connexions aux serveurs SSH et répertorie les connexions de base de données associées à chaque serveur SSH. Depuis 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ée 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 Voici les actions que vous pouvez effectuer pour configurer un serveur SSH: tester les connexions à un serveur SSH, ajouter une connexion de base de données à un serveur SSH, modifier la configuration d'un serveur SSH ou supprimer une configuration de serveur SSH.

Ajout ou modification d'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 Serveur sans nom situé 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 Nom d'utilisateur du serveur, saisissez le nom d'utilisateur que Looker utilisera pour se connecter au serveur SSH.
  5. Dans le champ Server IP Address or Hostname (Adresse IP ou nom d'hôte du serveur), saisissez le nom d'hôte ou l'adresse IP du serveur SSH.
  6. Dans le champ Port du serveur, saisissez le numéro de port utilisé pour la connexion au serveur SSH.
  7. Ajoutez la clé publique téléchargée au fichier de clé autorisée sur votre serveur SSH. Consultez la page de documentation Utiliser un serveur SSH pour obtenir plus d'informations et un exemple.
  8. Assurez-vous que les adresses IP Looker appropriées sont ajoutées à la liste d'autorisation sur votre serveur SSH afin que Looker puisse se connecter au serveur SSH.
  9. Cliquez sur Tester et demander une 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 voir l'empreinte unique de la configuration du serveur SSH.

Pour modifier la configuration d'un serveur SSH existant, cliquez sur le menu à trois points Options sur la ligne du serveur SSH sélectionné, puis choisissez Informations sur le 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 à trois points Options sur la ligne du serveur SSH choisi.
  2. Sélectionnez Tester les connexions.

Looker testera toutes les connexions à la base de données à l'aide de ce serveur SSH et affichera une coche verte à côté du nom du serveur et de toutes les connexions où le test de connexion réussit. Une icône avec un point d'exclamation rouge indique que le test de la connexion a échoué.

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

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

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

Looker affiche la page Paramètres de connexion, et le serveur SSH est indiqué dans le champ Serveur SSH.

Supprimer une configuration de serveur SSH

Pour supprimer une configuration de serveur SSH:

  1. Cliquez sur le menu à trois points Options dans 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 de l'état qui vous indiquent si Looker peut utiliser la connexion à la base de données.

Les problèmes potentiels sont indiqués en jaune, et les erreurs en rouge. Si une connexion aboutit, elle apparaît en vert.

Les connexions aux bases de données qui utilisent OAuth, comme 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 affiche un avertissement accompagné d'un lien Se connecter. Cliquez sur le lien pour saisir vos identifiants OAuth ou pour autoriser Looker à accéder à vos informations de compte OAuth.

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

  • Une seule connexion en cliquant sur Tester tout à 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 source de confusion:

  • Schéma temporaire disponible
  • Utilisation de tables dérivées persistantes

Ces vérifications n'ont pas besoin d'être validées pour que Looker fonctionne. Cependant, vous devez les transmettre pour utiliser des tables dérivées persistantes, qui constituent une fonctionnalité de modélisation très utile.

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, sélectionnez Connexions. Cliquez sur le bouton Edit (Modifier) de la connexion. La page que vous utilisez pour créer une connexion s'affiche (décrite sur la page de documentation Connecter Looker à votre base de données), mais avec les informations pertinentes déjà renseignées. Apportez toutes les modifications nécessaires, puis cliquez sur Update Connection (Mettre à jour la connexion).

Actions disponibles pour toutes les connexions

Le menu déroulant en forme de roue dentée situé à l'extrême droite de chaque connexion propose les options suivantes:

Option Description
Exécuteur SQL Cette option vous amène à l'exécuteur SQL de Looker, avec la connexion et le schéma appropriés déjà sélectionnés.
Explorer Cette option affiche 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 des rapports rapides sur les données brutes dans les tables de votre connexion. Cela n'est généralement utile que pour avoir une idée du contenu d'une table avant la modélisation, plutôt qu'à des fins d'analyse réelle des données.
Supprimer Pour supprimer une connexion existante, cliquez sur le menu déroulant en forme de roue dentée situé à l'extrême droite de l'assemblage, puis sélectionnez Supprimer. Vous aurez la possibilité de confirmer la suppression, mais cette action est irréversible. La suppression accidentelle d'une connexion désactive toutes les requêtes qui l'utilisent. 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 vous 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 rapports Looker basés sur les 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 les manipuler comme n'importe quel autre rapport Looker.
Afficher les bases de données Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des rapports Looker basés sur les 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 de colonnes, vous pouvez les manipuler comme n'importe quel autre rapport Looker.
Afficher les processus Cette option ouvre une page d'exploration Looker qui vous permet de créer des rapports Looker en fonction des processus en cours d'exécution sur cette connexion, de leur état, de leur durée d'exécution et d'autres informations. Cela peut être utile pour déterminer la cause d'une lenteur de Looker ou d'une requête qui n'est pas en cours d'exécution.
Afficher le journal des événements PDT Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des rapports Looker basés sur l'activité de la table dérivée pour cette connexion. Les champs disponibles sont décrits plus en détail sur la page de documentation consacrée aux tables dérivées persistantes.