Connecteur MongoDB pour l'informatique décisionnelle

Looker peut accéder à MongoDB à l'aide du connecteur MongoDB pour l'analyse de données à l'aide de deux options :

  • Utilisation du connecteur MongoDB pour l'informatique décisionnelle dans MongoDB Atlas
  • À l'aide d'un connecteur MongoDB pour l'analyse de données 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'analyse de données

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

Atlas n'autorise que les connexions client à 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:

  1. Obtenir l'adresse IP de Looker
  2. 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 Atlas.

Activer le connecteur MongoDB pour l'informatique décisionnelle

Activez le connecteur MongoDB pour l'informatique décisionnelle:

  1. Vérifiez que vous vous trouvez sur un cluster M10 ou version ultérieure.
  2. Dans Atlas, ouvrez la page Connecter le 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 la BI

Installez le connecteur MongoDB pour l'analyse de données sur le même serveur que la base de données MongoDB, comme expliqué sur la page de documentation MongoDB Installer le connecteur BI sur site.

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 passer à la base de données à laquelle Looker se connectera. Créez ensuite un utilisateur pour Looker avec db.createUser() et 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 de connecteur MongoDB pour la BI, Looker nécessite de configurer les fichiers de pilotes 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 conducteur: 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ésentent 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 de réaliser des analyses approfondies. Elles peuvent également contribuer à améliorer sensiblement les performances de requête. 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 est compatible avec les tables dérivées régulières temporaires, mais pas avec les tables dérivées persistantes.

Étant donné que les tables dérivées standards sont 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 attribuer le rôle dbOwner au schéma looker_tmp, même si ce schéma 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:

  1. Dans la section Admin de Looker, sélectionnez Connexions, puis cliquez sur Ajouter une connexion.

  2. Sélectionnez MongoBI dans le menu déroulant Dialecte.

  3. 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.

  4. Pour vérifier que la connexion est établie, cliquez sur Test. Consultez la page de documentation Tester la connectivité de la base de données pour obtenir des informations de dépannage.

  5. Pour enregistrer ces paramètres, cliquez sur Connecter.

Utiliser des fonctions et des opérateurs SQL avec le connecteur MongoDB pour la BI

Lorsque vous développez une connexion à l'aide d'un connecteur MongoDB pour la BI, vous pouvez utiliser les fonctions et opérateurs SQL listé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
Arrêt des requêtes
Oui
Pivots basés sur SQL
Non
Fuseaux horaires
Non
SSL
Oui
Sous-totaux
Non
Paramètres JDBC supplémentaires
Oui
Sensible à la casse
Oui
Type d'emplacement
Oui
Type de liste
Non
Centile
Non
Centile distinct
Non
Exécuteur SQL : afficher les processus
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
Résumés HLL
Non
Reconnaissance d'agrégats.
Non
Augmentation de tables PDT
Non
Millisecondes
Non
Microsecondes
Non
Vues matérialisées
Non
Nombre approximatif d'éléments distincts
Non

Autres caractéristiques :