Connecteur MongoDB pour l'informatique décisionnelle

Looker nécessite au moins MongoDB version 4.0+ et le connecteur MongoDB pour BI version 2.6.0+ (où la variable de session type_conversion_mode a été introduite).

Looker peut accéder à MongoDB à l'aide du connecteur MongoDB pour l'informatique décisionnelle à l'aide de deux options:

  • Utilisation du connecteur MongoDB pour l'informatique décisionnelle dans MongoDB Atlas
  • En utilisant un connecteur MongoDB pour la BI installé sur le même serveur que la base de données MongoDB.

MongoDB Atlas

Votre MongoDB Atlas doit utiliser un cluster M10+. Pour que Looker utilise une base de données MongoDB exécutée sur MongoDB Atlas, vous devez utiliser le connecteur MongoDB pour l'informatique décisionnelle (MongoBI). L'activation du connecteur BI pour Atlas nécessite que MongoDB Atlas utilise un cluster M10+.

Vous devez également créer un compte utilisateur disposant d'autorisations en lecture sur 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 la BI en suivant la procédure ci-dessous, qui est expliquée sur cette page:

Ajouter le serveur Looker à la liste d'accès aux adresses IP Atlas

Versa 3 autorise uniquement les connexions client à partir des entrées de la liste d'accès IP du projet. Ajoutez l'adresse IP de Looker à la liste d'accès des adresses 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 Atlas pour ajouter l'adresse IP de Looker à la liste d'accès des 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 utilisez un cluster M10+.
  2. Dans Atlas, ouvrez la page de connexion du cluster. Notez le nom d'hôte, le port et l'utilisateur. Vous en aurez besoin pour configurer 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 procédant comme indiqué sur cette page:

Installer le connecteur Mongo pour l'informatique décisionnelle

Installez le connecteur MongoDB pour l'informatique décisionnelle 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 la BI nécessite l'utilisation du chiffrement SSL entre le serveur de MongoDB et l'application Looker. Suivez les instructions de configuration SSL sur la page de documentation MongoDB Configurer SSL pour le connecteur BI.

Configurer l'utilisateur et les autorisations Looker

Dans l'interface système MongoDB, saisissez la commande use pour basculer vers la base de données à laquelle Looker se connectera. Créez ensuite 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 requiert la configuration des fichiers de pilote JDBC. Procédez comme suit:

Téléchargez ces deux fichiers JAR:

Suivez les étapes décrites sur la page de documentation Pilotes JDBC non empaquetés à l'aide des 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 que 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

Les tables dérivées sont des outils importants dans Looker qui vous permettent d'améliorer la sophistication de vos analyses. Elles peuvent également jouer un rôle important dans l'amélioration des performances des requêtes. De manière générale, la fonctionnalité de table dérivée de Looker permet de créer des tables qui n'existent pas déjà dans votre base de données.

Le connecteur MongoDB pour la BI est compatible avec les tables dérivées standards temporaires, mais pas avec les tables dérivées persistantes pour le moment.

Étant donné que 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. Toutefois, vous devez accorder 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 pour ajouter le rôle dbOwner sur looker_tmp que l'utilisateur Looker pourra utiliser pour se connecter.

db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])

Créer la connexion Looker à votre base de données

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

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 a réussi, cliquez sur Tester. Pour en savoir plus sur le dépannage, consultez la page de test de la connectivité de la base de données.

Pour enregistrer ces paramètres, cliquez sur Connecter.

Utiliser des fonctions et des opérateurs SQL avec MongoDB Connector for BI

Lorsque vous développez à l'aide d'un connecteur MongoDB pour la connexion BI, vous pouvez utiliser les fonctions et les opérateurs SQL répertoriés sur cette page de documentation MongoDB.

Prise en charge de fonctionnalités

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

MongoBI est compatible avec les fonctionnalités suivantes à partir de Looker 23.8:

Caractéristique Compatible ?
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
Processus d'affichage de l'exécuteur SQL
Oui
Table "Décrire" de l'exécuteur SQL
Oui
Index d'émissions SQL Runner
Oui
Exécuteur SQL 10
Oui
Nombre d'exécuteurs SQL
Oui
SQL Explain
Oui
Identifiants OAuth
Non
Commentaires contextuels
Oui
Pooling de connexions
Non
croquis HLL
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 :