Pour accéder à la page Connexions, ouvrez le menu Administration, puis 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, ainsi que 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 Databases (Bases de données) affiche des informations de base sur les connexions aux bases de données que vous avez définies. Il affiche également 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 dans 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 à partir de votre instance Looker. L'ensemble du trafic réseau provenant de Looker provient de l'une des adresses IP répertorié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 en provenance 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 de l'onglet Databases (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 lorsque vous utiliserez 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 le chiffrement SSL). |
| Type | Dialecte SQL de la connexion à la base de données. |
| Actions | Vous pouvez effectuer les actions suivantes sur 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 à partir d'une source de données supplémentaire à toutes les connexions gérées par Looker. |
Onglet "Serveurs SSH"
L'option Serveur SSH est disponible si l'instance est déployée sur l'infrastructure Kubernetes, et uniquement si la possibilité d'ajouter des informations de configuration du serveur SSH à votre instance Looker a été activée. 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 ouvrez une demande d'assistance.
Looker choisit automatiquement le port localhost 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. Cette action entraîne 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 indique les connexions aux bases de données associées à 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 choisie, qui permet de 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 de base de données pour ouvrir la page Modifier la connexion correspondante. |
| Menu à trois points Options | Actions possibles pour la configuration d'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. |
Ajouter ou modifier une configuration de serveur SSH
Pour ajouter une configuration de serveur SSH:
- Dans l'onglet Serveur SSH, cliquez sur Ajouter un serveur.
- Dans le champ Serveur sans nom en haut à droite, saisissez un nom pour la configuration du serveur SSH.
- 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.
- Dans le champ Nom d'utilisateur du serveur, saisissez le nom d'utilisateur que Looker utilisera pour se connecter au serveur SSH.
- 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.
- Dans le champ Server Port (Port du serveur), saisissez le numéro de port utilisé pour vous connecter au serveur SSH.
- Ajoutez la clé publique téléchargée au fichier de clé autorisée sur votre serveur SSH. Pour en savoir plus et obtenir un exemple, consultez la page de documentation Utiliser un serveur SSH.
- Assurez-vous que les adresses IP Looker appropriées sont ajoutées à la liste d'autorisation sur votre serveur SSH afin que Looker puisse s'y connecter.
- Cliquez sur Tester et Demandez une empreinte digitale pour vérifier votre connexion au serveur SSH.
- Affichez la nouvelle configuration SSH. Sur cet écran, vous pouvez également télécharger ou afficher la clé publique, ainsi que 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 sélectionnez Détails du serveur.
Tester les connexions à un serveur SSH
Pour tester toutes les connexions de base de données à un serveur SSH:
- Cliquez sur le menu Options à trois points sur la ligne du serveur SSH choisi.
- Choisissez Test Connections (Tester les connexions).
Looker teste toutes les connexions de base de données à l'aide de 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 est réussi. Une icône en forme de 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 :
- Cliquez sur le menu Options à trois points sur la ligne du serveur SSH choisi.
- Sélectionnez Add Connection (Ajouter une connexion).
Looker affiche la page Connection Settings (Paramètres de connexion), avec le serveur SSH listé dans le champ SSH Server (Serveur SSH).
Supprimer une configuration de serveur SSH
Pour supprimer une configuration de serveur SSH:
- Cliquez sur le menu Options à trois points sur la ligne du serveur SSH à supprimer.
- 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 des 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 "valide", elle apparaît en vert.
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.
Vous pouvez vérifier l'état des éléments suivants :
- Une seule connexion en cliquant sur Test à 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 source de confusion :
- Je peux trouver le schéma temporaire
- Peut utiliser des tables dérivées persistantes
Ces vérifications ne doivent pas nécessairement être validées pour que Looker fonctionne. Toutefois, vous devez les transmettre pour utiliser les 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, choisissez Connexions. Cliquez sur le bouton Modifier pour la connexion. La même page que celle 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 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 les options suivantes dans le menu déroulant en forme de roue dentée situé tout à droite de chaque connexion :
| Option | Description |
|---|---|
| Exécuteur SQL | Cette option vous permet d'accéder à SQL Runner de Looker, avec la connexion et le schéma appropriés déjà sélectionnés. |
| Explorer | Cette option vous permet d'accéder à 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 créer rapidement des rapports sur les données brutes des tables de votre connexion. Cette fonctionnalité n'est généralement utile que pour avoir une idée du contenu de la table avant la modélisation, et non pour l'analyse des données. |
| Supprimer | Pour supprimer une connexion existante, cliquez sur le menu déroulant en forme de roue dentée situé tout à droite de la connexion, puis sélectionnez Delete (Supprimer). Vous serez invité à confirmer la suppression, mais une fois que vous l'aurez fait, elle sera irréversible. Si vous supprimez accidentellement une connexion, toutes les requêtes qui l'utilisent seront désactivées. Toutefois, si vous recréez une connexion portant le même nom, la fonctionnalité sera rétablie. |
Actions disponibles pour certaines connexions
En fonction du 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 permet d'accéder à une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker basées 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 la manipuler comme n'importe quelle autre exploration Looker. |
| Afficher les bases de données | Cette option vous permet d'accéder à 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 ouvre une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker basées sur les processus exécutés sur cette connexion, leur état, leur durée d'exécution et d'autres informations. Cela peut être utile pour déterminer la cause si Looker est lent ou si une requête ne s'exécute pas du tout. |
| Afficher le journal des événements PDT | Cette option vous permet d'accéder à une page d'exploration Looker qui vous permet de créer des requêtes d'exploration Looker en fonction de 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 Tables dérivées persistantes. |