Connecteur MongoDB pour l'informatique décisionnelle

Looker peut accéder à MongoDB à l'aide de MongoDB Connector for BI de deux manières :

  • Utiliser MongoDB Connector for BI dans MongoDB Atlas.
  • Utiliser un connecteur MongoDB for 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 MongoDB Connector for BI (MongoBI). Pour activer BI Connector for 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 MongoDB Connector for BI

Avant de créer une connexion dans Looker, votre administrateur MongoDB ou Atlas doit configurer MongoDB Connector for BI en procédant comme suit, comme expliqué sur cette page :

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

Atlas n'autorise les connexions client que depuis les entrées de la liste d'accès IP du projet. Ajoutez l'adresse IP Looker à la liste d'accès IP du projet Atlas :

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

Activer MongoDB Connector for BI

Activez MongoDB Connector for BI :

  1. Vérifiez que vous utilisez 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 lors de la configuration de 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 Mongo Connector for BI en procédant comme suit, comme expliqué sur cette page :

Installer Mongo Connector for BI

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

Chiffrer le trafic réseau

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

Téléchargez ces deux fichiers JAR :

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

Symbole du pilote : mongobi

Entrée du pilote :

- 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 permettent de réaliser des analyses approfondies. Elles contribuent en outre à améliorer sensiblement les performances de requête. À un niveau élevé, la fonctionnalité de tables dérivées de Looker permet de créer de nouvelles tables qui n'existent pas encore dans votre base de données.

MongoDB Connector for BI est compatible avec les tables dérivées régulières temporaires regular derived tables, mais pas avec les tables dérivées persistantes persistent derived tables.

Étant donné que les tables dérivées régulières sont temporaires, elles n'ont pas besoin d'être stockées. Vous n'avez donc pas besoin de créer de schéma pour elles. 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

Procédez comme suit pour créer la connexion entre Looker et votre base de données :

  1. Dans la section Admin de Looker, sélectionnez Connections (Connexions), puis cliquez sur Add Connection (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 Test (Tester). Pour obtenir des informations sur la résolution des problèmes, consultez la page de documentation Tester la connectivité de la base de données.

  5. Pour enregistrer ces paramètres, cliquez sur Connect (Se connecter).

Utiliser des fonctions et des opérateurs SQL avec MongoDB Connector for 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.

Paramètres JDBC compatibles

Pour MongoDB Connector for BI, Looker est compatible avec les paramètres JDBC suivants dans le Additional JDBC parameters (Paramètres JDBC supplémentaires) pour la connexion. Pour en savoir plus sur ces paramètres, consultez la documentation de votre base de données.

  • allowMultiQueries
  • appName
  • authSource
  • autoReconnect
  • cachePrepStmts
  • characterEncoding
  • connectTimeout
  • connectTimeoutMS
  • elideSetAutoCommits
  • enabledSslProtocolSuites
  • enabledTLSProtocols
  • explainSlowQueries
  • maxAllowedPacket
  • password
  • queryInterceptors
  • queryTimeoutKillsConnection
  • replicaSet
  • rewriteBatchedStatements
  • socketTimeout
  • ssl
  • sslMode
  • tcpKeepAlive
  • useCompression
  • useCursorFetch
  • useLocalSessionState
  • user
  • useServerPrepStmts
  • useSSL
  • verifyServerCertificate
  • zeroDateTimeBehavior

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 26.8, MongoBI est compatible avec les fonctionnalités suivantes :

Fonctionnalité Compatibilité
Looker (Google Cloud Core)
Agrégations symétriques
Tables dérivées
Tables dérivées SQL persistantes
Tables dérivées natives persistantes
Vues stables
Arrêt des requêtes
Tableaux croisés dynamiques basés sur SQL
Fuseaux horaires
SSL
Sous-totaux
Paramètres JDBC supplémentaires
Sensibilité à la casse
Type de lieu
Type de liste
Centile
Centile distinct
Afficher les processus dans l'Exécuteur SQL
Décrire la table dans l'Exécuteur SQL
Afficher les index dans l'Exécuteur SQL
Sélectionner 10 dans SQL Runner
Compter dans l'Exécuteur SQL
Expliquer SQL
Identifiants OAuth 2.0
Commentaires contextuels
Regroupement de connexions
Résumés HLL
Reconnaissance d'agrégats
Augmentation de tables PDT
Millisecondes
Microsecondes
Vues matérialisées
Mesures de variation par période
Nombre approximatif d'éléments distincts
Agendas personnalisés

Autres caractéristiques :