MongoSQL

Connectez Looker directement à votre cluster MongoSQL à l'aide du dialecte MongoSQL (fourni par l'interface MongoSQL). En connectant Looker à MongoSQL, vous pouvez analyser les données de documents à l'aide de requêtes SQL relationnelles et créer des tableaux de bord Looker interactifs.

Looker inclut un pilote JDBC sous licence Apache 2.0 pour l'interface MongoSQL, prêt à l'emploi. Contrairement à l'ancien dialecte MongoBI, aucune installation manuelle de fichiers JAR de pilote JDBC non empaquetés personnalisés n'est requise.

Prérequis et configuration de MongoSQL

Avant de créer une connexion dans Looker, effectuez les étapes de configuration suivantes dans MongoSQL :

Créer un schéma relationnel à l'aide du générateur de schéma SQL

MongoDB stocke les données dans un format de document flexible et non relationnel (JSON/BSON). Avant que Looker puisse interroger vos collections MongoDB à l'aide du langage SQL standard, vous devez utiliser le générateur de schéma SQL dans MongoSQL pour créer un schéma SQL.

L'interface MongoSQL s'appuie sur le schéma relationnel créé par le générateur de schéma SQL pour mapper les structures de document, les champs imbriqués et les tableaux aux tables, lignes et colonnes SQL standard. Sans schéma SQL actif, l'interface SQL ne pourra pas traduire les requêtes SQL sur vos collections MongoDB.

Consultez la documentation sur le générateur de schémas MongoSQL pour définir et publier vos schémas tabulaires avant de créer la connexion dans Looker.

Pour les instances MongoDB Enterprise sur site, utilisez la CLI MongoDB SQL Schema Builder pour définir vos schémas.

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

MongoSQL limite les connexions client aux adresses IP autorisées. Pour interroger MongoSQL depuis votre instance Looker, vous devez ajouter vos adresses IP Looker à la liste d'accès aux adresses IP Atlas en procédant comme suit :

  1. Obtenez la liste des adresses IP Looker pour la région de votre instance Looker.
  2. Ajoutez ces adresses IP à la liste d'accès aux adresses IP de votre projet Atlas, conformément à la documentation Atlas sur la liste d'accès aux adresses IP.

Créer un compte utilisateur MongoDB pour Looker

Utilisez la console Web MongoDB Atlas pour créer un compte utilisateur de base de données pour Looker en procédant comme suit :

  1. Connectez-vous à la console MongoDB Atlas.
  2. Dans le menu de navigation principal, sous Sécurité, sélectionnez Accès à la base de données.
  3. Cliquez sur Ajouter un utilisateur de base de données.
  4. Sélectionnez Mot de passe comme méthode d'authentification. Saisissez un nom d'utilisateur (par exemple, looker) et un mot de passe sécurisé.
  5. Sous Database User Privileges (Droits d'utilisateur de la base de données), sélectionnez Built-in Role (Rôle intégré) et attribuez le rôle read (ou des autorisations de lecture personnalisées) pour la base de données à laquelle Looker accédera.
  6. Cliquez sur Ajouter un utilisateur pour enregistrer les identifiants de l'utilisateur.

Obtenir les paramètres de connexion Atlas SQL

Pour créer la connexion Looker, vous devrez saisir les paramètres de connexion pour la connexion Atlas SQL. Pour obtenir des informations sur les paramètres, procédez comme suit :

  1. Connectez-vous à la console MongoDB Atlas.
  2. Accédez à votre cluster, puis cliquez sur Connect (Connecter).
  3. Sélectionnez Atlas SQL (ou Connecter votre application à l'aide de SQL).
  4. Sélectionnez Pilote JDBC.
  5. Notez l'hôte, le port (généralement 27017), la base de données et les exigences SSL générés. Vous saisirez ces informations lorsque vous créerez la connexion Looker.

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

Pour établir la connexion entre Looker et MongoSQL, procédez comme suit :

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

  2. 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. Certains paramètres sont décrits ci-dessous. Utilisez les valeurs par défaut dans tous les autres champs ou laissez-les vides.

    • Nom : saisissez un nom de connexion unique.
    • Dialecte : sélectionnez MongoSQL dans le menu déroulant.
    • Hôte : nom d'hôte fourni par l'interface MongoSQL (par exemple, <cluster-name>.a.query.mongodb.net).
    • Port : numéro de port pour Atlas SQL (par défaut : 27017).
    • Base de données : nom de la base de données pour laquelle vous avez créé un schéma à l'aide de l'outil de création de schéma SQL.
    • Nom d'utilisateur : nom d'utilisateur de la base de données créé pour Looker.
    • Mot de passe : mot de passe de l'utilisateur de la base de données.
    • SSL : activez SSL (ssl=true).
    • Paramètres JDBC supplémentaires : (facultatif) paramètres JDBC supplémentaires compatibles avec le pilote MongoDB, tels que authSource=admin ou connectTimeoutMS=10000. Consultez la section Paramètres JDBC compatibles.

  3. Pour vérifier la connectivité à la base de données, cliquez sur Tester la connexion.

  4. Si Looker affiche Peut se connecter, 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 Admin de Looker.

Paramètres JDBC acceptés

Pour le dialecte MongoSQL, Looker accepte les paramètres JDBC suivants dans le champ Paramètres JDBC supplémentaires :

  • appName
  • authSource
  • clientinfo
  • connectTimeoutMS
  • directConnection
  • disableclientcache
  • extjsonmode
  • heartbeatFrequencyMS
  • journal
  • localThresholdMS
  • maxIdleTimeMS
  • maxWaitTimeMS
  • readPreference
  • replicaSet
  • retryReads
  • retryWrites
  • serverSelectionTimeoutMS
  • socketTimeoutMS
  • ssl
  • tls
  • tlsAllowInvalidHostnames
  • tlsInsecure
  • w
  • wtimeoutMS

Limites des requêtes et comportement SQL

Lorsque vous créez des modèles LookML et que vous interrogez MongoSQL à l'aide de l'interface SQL, gardez à l'esprit les caractéristiques de dialecte suivantes :

  • Exigence concernant le générateur de schéma SQL : comme indiqué dans les conditions préalables, les requêtes SQL nécessitent un schéma relationnel préconfiguré défini dans le générateur de schéma SQL Atlas.
  • Tables dérivées : les tables dérivées éphémères (régulières) sont acceptées, mais pas les tables dérivées persistantes (PDT).
  • Types de date et d'horodatage : le type de données date n'est pas accepté. La pratique standard consiste à stocker et à modéliser les dates en tant que champs timestamp.
  • Fuseaux horaires : tous les codes temporels accessibles depuis l'interface MongoSQL sont traités en UTC. Looker ne convertit pas les fuseaux horaires dans la base de données pour les connexions 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.

Depuis Looker 26.16, MongoSQL 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 persistantes basées sur SQL
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 de l'Exécuteur SQL
Décrire la table dans l'exécuteur SQL
Afficher les index dans l'Exécuteur SQL
Exécuteur SQL Select 10
Nombre d'exécuteurs SQL
Explication 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
Modèles analytiques dans la base de données
Agendas personnalisés