Connecteur MongoDB pour l'informatique décisionnelle

Migrer de MongoBI vers MongoSQL

Looker est désormais compatible avec MongoSQL et recommande de migrer vers MongoSQL depuis le connecteur MongoDB pour BI.

En raison des différences de syntaxe SQL entre le connecteur MongoDB pour BI (MongoBI) et MongoSQL, les modèles LookML existants qui utilisent des blocs SQL personnalisés, un formatage de date ou des fonctions de base de données peuvent nécessiter des ajustements de syntaxe. Ne basculez pas directement une connexion de production existante vers MongoSQL sans avoir d'abord validé votre code LookML, car cela pourrait endommager les tableaux de bord, les présentations, les planifications ou les alertes.

Pour migrer en toute sécurité de MongoBI vers MongoSQL, procédez comme suit :

  1. Passez en revue les différences de syntaxe SQL entre MongoBI et MongoSQL dans la documentation MongoDB Transition from Atlas BI Connector to MongoSQL (Passer du connecteur Atlas BI à MongoSQL).
  2. Créez une connexion pour MongoSQL dans Looker en tant que connexion secondaire.
  3. Dans une nouvelle branche de développement de votre projet LookML, mettez à jour le paramètre connection dans votre fichier de modèle pour qu'il pointe vers la nouvelle connexion MongoSQL.
  4. Dans l'exécuteur SQL, testez et exécutez des exemples de requêtes à partir de vos explorations pour vérifier la syntaxe et les résultats des requêtes.
  5. Validez votre projet et votre contenu :
    • Utilisez la validation de contenu pour analyser tous les tableaux de bord et Looks à la recherche de champs ou de références non valides.
    • Utilisez l'outil de validation SQL de Looker CI pour valider les dimensions de vos explorations par rapport à la base de données.
  6. Après avoir résolu les erreurs de validation, déployez vos modifications en production.

Utiliser le connecteur MongoDB pour BI (MongoBI)

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

Vous devez également créer un compte utilisateur disposant d'autorisations de lecture pour la base de données choisie.

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 IP Atlas

Atlas n'autorise que les connexions client provenant d'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 par adresse IP d'Atlas pour ajouter l'adresse IP de Looker à la liste d'accès par adresse IP d'Atlas.

Activer le connecteur MongoDB pour BI

Activez le connecteur MongoDB pour BI :

  1. Vérifiez que vous utilisez un cluster M10 ou version ultérieure.
  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 le connecteur Mongo pour BI en suivant les étapes décrites sur cette page :

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 Install BI Connector On Premises (Installer le connecteur BI sur site).

Chiffrement du trafic réseau

Le connecteur MongoDB pour 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 Configure SSL for BI Connector (Configurer SSL pour le connecteur BI).

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. 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 de connecteur MongoDB pour 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

driver entry :

- 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 standards (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.

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

Comme les tables dérivées standards sont temporaires, elles n'ont pas besoin d'être stockées. Vous n'avez donc pas besoin de créer de schéma pour ces types de données. 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 "Modify MongoDB Users" (Modifier les utilisateurs MongoDB) de cette page de la 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 entre Looker et 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 est établie, cliquez sur le bouton Tester la connexion dans la section Détails de l'état en bas de la page Paramètres de connexion.

  5. Si Looker affiche Connexion possible, appuyez sur Connecter pour créer la connexion.

Votre connexion de base de données est ensuite ajoutée à la liste de la page Connexions de la section Admin de Looker.

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.

Paramètres JDBC compatibles

Pour le connecteur MongoDB pour BI, Looker accepte les paramètres JDBC suivants dans le champ Paramètres JDBC supplémentaires de 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

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 26.22 :

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
Pivots basés sur SQL
Fuseaux horaires
SSL
Sous-totaux
Paramètres JDBC supplémentaires
Sensible à 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 l'exécuteur SQL
Nombre d'exécuteurs SQL
SQL Explain
Identifiants OAuth 2.0
Commentaires sur le contexte
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
Modèles d'analyse dans la base de données
Agendas personnalisés

Autres caractéristiques :