MongoSQL

Connectez Looker directement à votre cluster MongoSQL à l'aide du dialecte MongoSQL (optimisé 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 officiel sous licence Apache-2.0 pour l'interface MongoSQL. Contrairement à l'ancien dialecte MongoBI, aucune installation manuelle de fichiers JAR de pilote JDBC personnalisés non empaqueté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 de SQL Schema Builder

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émas 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émas SQL pour mapper les structures de documents, 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 de MongoSQL Schema Builder 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 des adresses IP Looker à la liste d'accès IP Atlas

MongoSQL limite les connexions client aux adresses IP autorisées. Pour interroger MongoSQL à partir de votre instance Looker, vous devez ajouter vos adresses IP Looker à la liste d'accès 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 IP de votre projet Atlas en suivant la documentation sur la liste d'accès IP Atlas.

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 Add User (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 devez saisir les paramètres de connexion pour la connexion Atlas SQL. Pour obtenir les informations sur les paramètres, procédez comme suit :

  1. Connectez-vous à la console MongoDB Atlas.
  2. Accédez à votre cluster, puis cliquez sur Se connecter.
  3. Sélectionnez Atlas SQL (ou Connect your application using SQL).
  4. Sélectionnez Pilote JDBC.
  5. Notez les valeurs générées pour Host (Hôte), Port (généralement 27017), Database (Base de données) et les exigences SSL. 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 de ces 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 SQL Schema Builder.
    • 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 Paramètres JDBC compatibles.

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

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

Paramètres JDBC compatibles

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 interrogez MongoSQL à l'aide de l'interface SQL, tenez compte des caractéristiques de dialecte suivantes :

  • Exigence liée à SQL Schema Builder : comme indiqué dans les prérequis, les requêtes SQL nécessitent un schéma relationnel préconfiguré défini dans Atlas SQL Schema Builder.
  • Tables dérivées : les tables dérivées éphémères (standards) sont acceptées, mais pas les tables dérivées persistantes (PDT).
  • Types de date et de code temporel : 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 au format 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.

MongoSQL 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