Pour accéder à la page Connexions, ouvrez le menu Admin, puis sélectionnez Connexions sous Base de données.
Afficher les connexions
Sur la page Connexions, vous pouvez afficher les connexions à votre 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 connexion.
Onglet "Bases de données"
L'onglet Bases de données contient 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 provenant de votre instance Looker. Tout le 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. 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 simple 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. |
| 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 | Que vous utilisiez 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 possibles pour une connexion: tester une connexion, modifier une connexion, afficher d'autres informations sur une connexion, accéder à la liste des 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 votre gestionnaire de compte Looker ou ouvrez une demande d'assistance dans le Centre d'aide Looker.
Looker choisit automatiquement le port localhost pour vous lorsque vous créez des tunnels SSH. Actuellement, 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. La configuration du tunnel SSH échouera. 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 liste les connexions aux bases de données qui utilisent 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 de serveur SSH, que vous avez choisie, qui permet de se connecter à votre base de données. |
| Connexions | Liste des connexions à la 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" | Actions possibles pour la configuration d'un serveur SSH : tester les connexions à un serveur SSH, ajouter une connexion à la 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:
- Dans l'onglet Serveur SSH, cliquez sur Ajouter un serveur.
- Dans le champ Serveur sans nom situé en haut à droite, saisissez un nom pour la configuration du serveur SSH.
- Cliquez sur Download Key (Télécharger la clé) pour télécharger la clé publique dans un fichier texte. Veillez à enregistrer ce fichier pour un usage ultérieur.
- Dans le champ Server Username (Nom d'utilisateur du serveur), saisissez le nom d'utilisateur que Looker utilisera pour se connecter au serveur SSH.
- Dans le champ Server IP Address or Hostname (Adresse IP du serveur ou nom d'hôte), saisissez le nom d'hôte ou l'adresse IP du serveur SSH.
- Dans le champ Port du serveur, saisissez le numéro de port utilisé pour la connexion au serveur SSH.
- Ajoutez la clé publique téléchargée au fichier de clé autorisé sur votre serveur SSH. Pour en savoir plus et voir un exemple, consultez la page Utiliser un serveur SSH.
- Assurez-vous que les adresses IP Looker appropriées ont été ajoutées à la liste d'autorisation sur votre serveur SSH pour que Looker puisse se connecter au serveur SSH.
- Cliquez sur Tester le & demande d'empreinte 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 de votre choix, puis sélectionnez Détails du serveur.
Tester les connexions à un serveur SSH
Pour tester toutes les connexions à la base de données sur un serveur SSH:
- Cliquez sur le menu à trois points sur la ligne du serveur SSH souhaité.
- 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 auxquelles le test de connexion réussit. Une icône en forme de point d'exclamation rouge indique que la connexion a échoué au test.
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 à trois points sur la ligne du serveur SSH souhaité.
- Sélectionnez Ajouter une connexion.
Looker affiche la page Paramètres de connexion, avec le serveur SSH répertorié dans le champ Serveur SSH.
Suppression d'une configuration de serveur SSH
Pour supprimer une configuration de serveur SSH:
- Cliquez sur le menu à 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 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 comprend une liste de vérifications d'état indiquant si Looker peut utiliser la connexion à la base de données. Exemple :
Les problèmes potentiels sont indiqués en jaune et les erreurs en rouge. Si une connexion est "passée", elle apparaît en vert.
Les connexions à une base de données utilisant 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 affiche un avertissement avec un lien Connexion. 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:
- Une seule connexion, en cliquant sur Tester à l'extrémité 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 trouvé
- Peut utiliser des tables dérivées persistantes
Il n'est pas nécessaire que ces vérifications soient réussies pour que Looker fonctionne. Cependant, 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 à la base de données, suivez les étapes décrites sur la page de documentation Connecter Looker à votre base de données.
Modifier les connexions
Pour modifier une connexion, cliquez sur le bouton Edit (Modifier) situé à l'extrémité droite de chaque connexion. La page que vous utilisez pour créer une connexion s'affiche (décrite dans la section 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 Mettre à jour la connexion.
Actions disponibles pour toutes les connexions
Toutes les connexions offrent les options suivantes 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 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 vous permet d'obtenir la liste des options 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 de vos tableaux de connexion. Cette méthode est généralement uniquement utile pour avoir une idée du contenu d'une table avant la modélisation, plutôt que pour analyser les données. |
| Supprimer | Pour supprimer une connexion, cliquez sur le menu déroulant en forme de roue dentée situé à l'extrême droite d'une connexion, puis sélectionnez Supprimer. Vous avez la possibilité de confirmer la suppression, mais elle 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 situé à 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 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 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, du nom du catalogue, du nombre de tables et du nombre de colonnes, vous pouvez la manipuler comme n'importe quel autre rapport Looker. |
| Afficher les processus | Cette option vous redirige vers une page d'exploration Looker qui vous permet de créer des rapports Looker basés sur les processus en cours d'exécution sur cette connexion, leur état d'exécution, 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 n'est pas du tout exécutée. |
| Afficher le journal d'événements des 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é du tableau dérivé de cette connexion. Pour en savoir plus sur les champs disponibles, consultez la page de documentation Tables dérivées persistantes. |