Looker peut accéder à MongoDB à l'aide du connecteur MongoDB pour l'informatique décisionnelle à l'aide de deux options:
- En utilisant le connecteur MongoDB pour l'analyse de données dans MongoDB Atlas.
- Utiliser un connecteur MongoDB pour l'informatique décisionnelle installé sur le même serveur que la base de données MongoDB
MongoDB Atlas
Votre cluster MongoDB Atlas doit utiliser un cluster M10+. Pour que Looker utilise une base de données MongoDB s'exécutant sur MongoDB Atlas, vous devez utiliser le connecteur MongoDB pour l'informatique décisionnelle (MongoBI). Pour activer le connecteur d'informatique décisionnelle pour Atlas, MongoDB Atlas doit utiliser un cluster M10+.
Vous devez également créer un compte utilisateur disposant d'autorisations de lecture pour la base de données souhaitée.
Configurer le connecteur MongoDB pour l'informatique décisionnelle
Avant de créer une connexion dans Looker, votre administrateur MongoDB ou Atlas doit configurer le connecteur MongoDB pour l'informatique décisionnelle en suivant les étapes décrites sur cette page :
- Ajouter le serveur Looker à la liste d'accès IP Atlas
- Activer le connecteur MongoDB pour l'analyse de données
- Autoriser l'utilisation de tables dérivées standards (recommandé)
Ajouter le serveur Looker à la liste d'accès IP Atlas
Atlas n'autorise les connexions client qu'à partir des entrées de la liste d'accès aux adresses IP du projet. Ajoutez l'adresse IP Looker à la liste d'accès IP du projet Atlas:
- Obtenir l'adresse IP de Looker
- Suivez les instructions de configuration de la liste d'accès aux adresses IP d'Atlas pour ajouter l'adresse IP de Looker à la liste d'accès aux adresses IP d'Atlas.
Activer le connecteur MongoDB pour l'informatique décisionnelle
Activez le connecteur MongoDB pour l'informatique décisionnelle:
- Vérifiez que vous utilisez un cluster M10 ou version ultérieure.
- Dans Atlas, ouvrez la page Connect du cluster. Notez le nom d'hôte, le port et l'utilisateur. Vous devrez utiliser ces informations lorsque vous configurerez la connexion dans Looker.
MongoDB sur le même serveur
Avant de créer une connexion dans Looker, votre administrateur MongoDB doit configurer MongoDB et le connecteur Mongo pour l'informatique décisionnelle en suivant les étapes décrites sur cette page:
- Installer le connecteur Mongo pour l'analyse de données
- Chiffrement du trafic réseau
- Configurer l'utilisateur et les autorisations Looker
- Autoriser l'utilisation de tables dérivées standards (recommandé)
Installer le connecteur Mongo pour la BI
Installez le connecteur MongoDB pour l'informatique décisionnelle sur le même serveur que la base de données MongoDB, comme expliqué dans l'article Installer un connecteur d'informatique décisionnelle sur site. Page de documentation de MongoDB.
Chiffrement du trafic réseau
Le connecteur MongoDB pour l'analyse de données nécessite l'utilisation du chiffrement SSL entre le serveur MongoDB et l'application Looker. Suivez les instructions de configuration SSL de la page de documentation MongoDB Configurer SSL pour le connecteur d'informatique décisionnelle.
Configurer l'utilisateur et les autorisations Looker
Dans le shell MongoDB, saisissez la commande use
pour basculer vers la base de données à laquelle Looker se connectera. Ensuite, créez un utilisateur pour Looker avec db.createUser()
avec le rôle readWrite
:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Installer les fichiers du pilote JDBC MongoBI
Pour les deux options du connecteur MongoDB pour l'informatique décisionnelle, Looker nécessite de configurer les fichiers de pilote JDBC en procédant comme suit:
Téléchargez ces deux fichiers JAR:
Suivez la procédure décrite sur la page de documentation Pilotes JDBC non empaquetés en utilisant les valeurs suivantes:
Symbole du pilote : mongobi
driver input:
- name: mongobi
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
Si vous utilisez Looker 6.2 ou une version antérieure:
- name: maria15x
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
Pour l'étape consistant à placer le pilote dans le répertoire de votre dialecte, les chemins d'accès à ces fichiers se présenteront comme suit:
looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar
Autoriser l'utilisation de tables dérivées régulières (recommandé)
Les tables dérivées sont des outils importants de Looker qui vous permettent d'affiner vos analyses. Elles peuvent également jouer un rôle précieux dans l'amélioration des performances des requêtes. Dans les grandes lignes, la capacité des tables dérivées de Looker permet de créer des tables qui n'existent pas encore dans votre base de données.
Le connecteur MongoDB pour l'analyse de données accepte les tables dérivées régulières temporaires, mais pas les tables dérivées persistantes.
Les tables dérivées régulières étant temporaires, elles n'ont pas besoin d'être stockées. Vous n'avez donc pas besoin de leur créer un schéma. Toutefois, vous devez accorder le rôle dbOwner
au schéma looker_tmp
, même s'il n'existe pas.
Suivez la section "Modifier les utilisateurs MongoDB" de cette page de documentation MongoDB sur la configuration des utilisateurs de base de données pour ajouter le rôle dbOwner
sur looker_tmp
pour l'utilisateur que Looker utilisera pour se connecter.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Créer la connexion Looker à votre base de données
Pour créer la connexion entre Looker et votre base de données, procédez comme suit:
- Dans la section Administration de Looker, sélectionnez Connexions, puis cliquez sur Ajouter une connexion.
Sélectionnez MongoBI dans le menu déroulant Dialect (Dialecte).
Saisissez les informations de connexion. La majorité des paramètres sont communs à la plupart des dialectes de base de données. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.
Pour vérifier que la connexion est établie, cliquez sur Test (Tester). Consultez la page de documentation Tester la connectivité de la base de données pour obtenir des informations de dépannage.
Pour enregistrer ces paramètres, cliquez sur Connecter.
Utiliser des fonctions et des opérateurs SQL avec le connecteur MongoDB pour l'informatique décisionnelle
Lorsque vous développez à l'aide d'un connecteur MongoDB pour la connexion d'informatique décisionnelle, vous pouvez utiliser les fonctions et opérateurs SQL répertoriés dans la documentation MongoDB.
Compatibilité des caractéristiques
Pour que Looker prenne en charge certaines fonctionnalités, votre dialecte de base de données doit également les prendre en charge.
MongoBI prend en charge les fonctionnalités suivantes à partir de Looker 24.16:
Caractéristique | Compatibilité |
---|---|
Niveau d'assistance | Compatible |
Looker (Google Cloud Core) | Non |
Agrégations symétriques | Non |
Tables dérivées | Oui |
Tables dérivées SQL persistantes | Non |
Tables dérivées natives persistantes | Non |
Vues stables | Non |
Suppression des requêtes | Oui |
Tableaux croisés dynamiques basés sur SQL | Non |
Fuseaux horaires | Non |
SSL | Oui |
Sous-totaux | Non |
Paramètres supplémentaires JDBC | Oui |
Sensible à la casse | Oui |
Type d'emplacement | Oui |
Type de liste | Non |
Centile | Non |
Centile distinct | Non |
Processus d'affichage de l'exécuteur SQL | Oui |
Table de description de l'exécuteur SQL | Oui |
Index d'affichage de l'exécuteur SQL | Oui |
SQL Runner Select 10 | Oui |
Nombre d'exécuteurs SQL | Oui |
SQL Explain | Oui |
Identifiants OAuth | Non |
Commentaires sur le contexte | Oui |
Pooling des connexions | Non |
HLL Sketches | Non |
Reconnaissance d'agrégats. | Non |
Augmentation de tables PDT | Non |
Millisecondes | Non |
Microsecondes | Non |
Vues matérialisées | Non |
Nombre approximatif distinct | Non |
Autres caractéristiques :
- MongoDB n'est pas compatible avec les intervalles de millisecondes et de microsecondes pour les groupes de dimensions.
- MongoDB n'accepte pas les types de milliseconde, millisecondeX et microsecondes pour les dimensions.
- Looker traite tous les horodatages accessibles depuis MongoBI comme étant basés sur le fuseau horaire UTC (temps universel coordonné).