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, 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 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 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 et modifier la configuration de ces connexions à partir de 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 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 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 de 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 en transit 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 établir une connexion: tester une connexion, la modifier, afficher d'autres informations la concernant, 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 à n'importe quelle connexion gérée 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, déjà utilisé par Looker. Cela entraînera l'échec de la configuration du tunnel SSH. Pour corriger ce problème, configurez votre base de données PrestoDB ou Trino afin 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 à la base de données pour ouvrir la page Modifier la connexion correspondante. |
| Menu Options à trois points | 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 Port du serveur, saisissez le numéro de port utilisé pour se connecter au serveur SSH.
- 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.
- Assurez-vous que les adresses IP Looker appropriées sont ajoutées à la liste d'autorisation sur votre serveur SSH pour que Looker puisse se connecter au serveur SSH.
- Cliquez sur Tester et demander 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, et afficher l'empreinte unique de la configuration du serveur SSH.
Pour modifier une configuration de serveur SSH existante, cliquez sur le menu Options à trois points 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:
- Cliquez sur le menu Options à trois points sur la ligne du serveur SSH choisi.
- Choisissez Test Connections (Tester les connexions).
Looker testera toutes les connexions à la base de données utilisant ce serveur SSH et affichera une coche verte à côté du nom du serveur et de toutes les connexions pour lesquelles le test de connexion réussit. Une icône en forme de 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 à la 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 Paramètres de connexion, avec le serveur SSH indiqué dans le champ 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 comprend une liste de vérifications de l'état pour vous indiquer si Looker peut utiliser la connexion à la base de données.
Les problèmes potentiels sont indiqués en jaune, les erreurs en rouge. Si une connexion est "réussie", elle s'affiche 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 connexion unique en cliquant sur Test (Tester) tout à droite de cette connexion
- Toutes les connexions en cliquant sur le bouton Test All Connections (Tester toutes les connexions) en haut de la page
Deux vérifications sont souvent à l'origine de confusion:
- Schéma temporaire disponible
- Utilisation de tables dérivées persistantes
Ces vérifications ne doivent pas nécessairement ê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 à la base de données, suivez les étapes décrites dans 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 Edit (Modifier) de la connexion. La page que vous utilisez pour créer une connexion s'affiche (décrite dans la page Connecter Looker à votre base de données), mais contient déjà les informations pertinentes. Apportez toutes les modifications nécessaires, puis cliquez sur Update Connection (Mettre à jour la connexion).
Actions disponibles pour toutes les connexions
Pour toutes les connexions, les options suivantes sont disponibles 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 à 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. Ceux-ci 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. En général, cette méthode n'est utile que pour se faire 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é tout à droite de la connexion, puis sélectionnez Delete (Supprimer). Vous avez la possibilité de confirmer la suppression, mais cette opération 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, les fonctionnalités seront restaurées. |
Actions disponibles pour certaines connexions
Selon le dialecte de connexion, le menu déroulant en forme de roue dentée situé à 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 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 la manipuler comme n'importe quel autre rapport 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 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 le nombre de colonnes sélectionnés, vous pouvez la manipuler comme n'importe quel autre rapport Looker. |
| Afficher les processus | Cette option vous permet d'accéder à une page d'exploration Looker qui vous permet de créer des rapports Looker basés 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 d'une lenteur d'exécution 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 permet d'accéder à 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 Tables dérivées persistantes. |