Connecteur MongoDB pour l'informatique décisionnelle

Looker peut accéder à MongoDB à l'aide du connecteur MongoDB pour BI de deux manières :

• Utiliser le connecteur MongoDB pour BI dans MongoDB Atlas.
• Utiliser un connecteur MongoDB pour BI installé sur le même serveur que la base de données MongoDB.

MongoDB Atlas

Votre MongoDB Atlas doit utiliser un cluster M10 ou supérieur. Pour que Looker puisse utiliser une base de données MongoDB exécutée sur MongoDB Atlas, vous devez utiliser le connecteur MongoDB pour BI (MongoBI). Pour activer le connecteur BI pour Atlas, MongoDB Atlas doit utiliser un cluster M10 ou supérieur.

Vous devez également créer un compte utilisateur disposant des autorisations de lecture pour la base de données souhaitée.

Configurer le connecteur MongoDB pour BI

Avant de créer une connexion dans Looker, votre administrateur MongoDB ou Atlas doit configurer le connecteur MongoDB pour BI en suivant les étapes ci-dessous, qui sont expliquées sur cette page :

• Ajouter le serveur Looker à la liste d'accès aux adresses IP Atlas
• Activer le connecteur MongoDB pour BI
• Autoriser l'utilisation de tables dérivées standards (recommandé)

Ajouter le serveur Looker à la liste d'accès aux adresses 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 aux adresses IP du projet Atlas :

1. Obtenez l'adresse IP de Looker.
2. Suivez les instructions de Configuration de la liste d'accès aux adresses IP Atlas pour ajouter l'adresse IP Looker à la liste d'accès aux adresses IP Atlas.

Activer le connecteur MongoDB pour BI

Activez le connecteur MongoDB pour BI :

1. Vérifiez que vous êtes sur un cluster M10+.
2. Dans Atlas, ouvrez la page "Connect" (Se connecter) 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 ci-dessous, qui sont expliquées sur cette page :

• Installer le connecteur Mongo pour BI
• 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 BI

Installez le connecteur MongoDB pour BI sur le même serveur que la base de données MongoDB, comme expliqué sur la page de documentation MongoDB Installer BI Connector On Premises .

Chiffrement du trafic réseau

Le connecteur MongoDB pour BI nécessite l'utilisation du chiffrement SSL entre le serveur MongoDB et l'application Looker. Suivez les instructions de configuration SSL sur la page de documentation MongoDB Configurer SSL pour BI Connector.

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 du connecteur MongoDB pour BI, Looker nécessite la configuration des fichiers de pilote JDBC en procédant comme suit :

Téléchargez ces deux fichiers JAR :

• mongosql auth 1.0.0
• mysql connector java 5.1.47

Suivez les étapes de la page de documentation Pilotes JDBC non empaquetés en utilisant les valeurs suivantes :

Symbole du conducteur : mongobi

Entrée du conducteur :

- 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 permettant de 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 permettent de réaliser des analyses approfondies. Elles peuvent également contribuer à améliorer sensiblement les performances de requête. Moyennant de bonnes connaissances techniques, cette fonctionnalité de Looker permet de créer des tables qui n'existent pas encore dans la base de données.

Le connecteur MongoDB pour BI est compatible avec les tables dérivées régulières temporaires, mais pas avec les tables dérivées persistantes.

Comme les tables dérivées standards sont temporaires, il n'est pas nécessaire de les stocker. Vous n'avez donc pas besoin de créer de schéma pour eux. 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 :

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 Dialect (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 a réussi, cliquez sur Tester. Pour obtenir des informations sur le dépannage, consultez la page de documentation Tester la connectivité à la base de données.

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

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

Lorsque vous développez à l'aide d'une connexion MongoDB Connector for BI, vous pouvez utiliser les fonctions et opérateurs SQL listés dans la documentation MongoDB.

Compatibilité avec les fonctionnalités

Pour que Looker prenne en charge certaines fonctionnalités, votre dialecte de base de données doit également les prendre en charge.

Depuis Looker 25.10, MongoBI est compatible avec les fonctionnalités suivantes :

Autres caractéristiques :

• MongoDB n'est pas compatible avec les périodes en millisecondes et en microsecondes pour les groupes de dimensions.
• MongoDB n'est pas compatible avec les types milliseconde, millisecondeX et microseconde pour les dimensions.
• Looker considère que tous les codes temporels auxquels il accède depuis MongoBI sont dans le fuseau horaire UTC (temps universel coordonné).