MongoSQL

Conecta Looker a tu clúster de MongoSQL directamente con el dialecto MongoSQL (con tecnología de la interfaz de MongoSQL). Conectar Looker a MongoSQL te permite analizar datos de documentos con consultas relacionales de SQL y crear paneles interactivos de Looker.

Looker incluye un controlador JDBC con licencia Apache 2.0 y agrupado oficialmente para la interfaz de MongoSQL. A diferencia del dialecto heredado de MongoBI, no se requiere la instalación manual de archivos JAR de controladores JDBC personalizados sin empaquetar.

Requisitos previos y configuración de MongoSQL

Antes de crear una conexión en Looker, completa los siguientes pasos de configuración en MongoSQL:

Compila un esquema relacional con el compilador de esquemas de SQL

MongoDB almacena datos en un formato de documento flexible y no relacional (JSON/BSON). Para que Looker pueda consultar tus colecciones de MongoDB con SQL estándar, debes usar el compilador de esquemas de SQL en MongoSQL para crear un esquema de SQL.

La interfaz de MongoSQL se basa en el esquema relacional que crea el compilador de esquemas de SQL para asignar estructuras de documentos, campos anidados y arrays a tablas, filas y columnas de SQL estándar. Sin un esquema de SQL activo, la interfaz de SQL no podrá traducir las consultas de SQL en tus colecciones de MongoDB.

Consulta la documentación del compilador de esquemas de MongoSQL para definir y publicar tus esquemas tabulares antes de crear la conexión en Looker.

Para las instancias locales de MongoDB Enterprise, usa la CLI del compilador de esquemas de SQL de MongoDB para definir tus esquemas.

Agrega direcciones IP de Looker a la lista de acceso de IP de Atlas

MongoSQL restringe las conexiones de clientes a direcciones IP autorizadas. Para consultar MongoSQL desde tu instancia de Looker, debes agregar tus direcciones IP de Looker a la lista de acceso de IP de Atlas. Para ello, sigue estos pasos:

  1. Obtén la lista de direcciones IP de Looker para la región de tu instancia de Looker.
  2. Agrega estas direcciones IP a la lista de acceso de IP de tu proyecto de Atlas según la documentación de la lista de acceso de IP de Atlas.

Crea una cuenta de usuario de MongoDB para Looker

Usa la consola web de MongoDB Atlas para crear una cuenta de usuario de base de datos para Looker. Para ello, sigue estos pasos:

  1. Accede a la consola de MongoDB Atlas.
  2. En el menú de navegación principal, en Seguridad , selecciona Acceso a la base de datos.
  3. Haz clic en Agregar usuario nuevo de la base de datos.
  4. Selecciona Contraseña como el método de autenticación. Ingresa un nombre de usuario (por ejemplo, looker) y una contraseña segura.
  5. En Privilegios del usuario de la base de datos, selecciona Rol integrado y asigna el rol read (o permisos de lectura personalizados) para la base de datos a la que accederá Looker.
  6. Haz clic en Agregar usuario para guardar las credenciales del usuario.

Obtén parámetros de conexión de SQL de Atlas

Para crear la conexión de Looker, deberás ingresar parámetros de conexión para la conexión de SQL de Atlas. Para obtener la información de los parámetros, sigue estos pasos:

  1. Accede a la consola de MongoDB Atlas.
  2. Navega a tu clúster y haz clic en Conectar.
  3. Selecciona SQL de Atlas (o Conecta tu aplicación con SQL).
  4. Selecciona Controlador JDBC.
  5. Ten en cuenta los requisitos de host, puerto (por lo general, 27017), base de datos y SSL generados. Ingresarás estos detalles cuando crees la conexión de Looker.

Crea la conexión de Looker a tu base de datos

Sigue estos pasos para establecer la conexión de Looker a MongoSQL:

  1. En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.

  2. Completa los detalles de la conexión. La mayoría de los parámetros de configuración son comunes en la mayoría de los dialectos de bases de datos. Consulta la página de documentación Conecta Looker a tu base de datos para obtener información. A continuación, se describen algunos de los parámetros de configuración. Usa los valores predeterminados en todos los demás campos o déjalos en blanco.

    • Nombre: Ingresa un nombre de conexión único.
    • Dialecto: Selecciona MongoSQL en el menú desplegable.
    • Host: Nombre de host proporcionado por la interfaz de MongoSQL (por ejemplo, <cluster-name>.a.query.mongodb.net).
    • Puerto: Número de puerto para SQL de Atlas (predeterminado: 27017).
    • Base de datos: Nombre de la base de datos para la que creaste un esquema con el compilador de esquemas de SQL.
    • Nombre de usuario: Nombre de usuario de la base de datos creado para Looker.
    • Contraseña: Contraseña del usuario de la base de datos.
    • SSL: Habilita SSL (ssl=true).
    • Parámetros adicionales de JDBC: (Opcional) Parámetros adicionales de JDBC compatibles con el controlador de MongoDB, como authSource=admin o connectTimeoutMS=10000. Consulta Parámetros de JDBC admitidos.

  3. Para verificar la conectividad de la base de datos, haz clic en Probar conexión.

  4. Si Looker muestra Se puede conectar, presiona Conectar para crear la conexión.

Luego, la conexión de la base de datos se agrega a la lista en la página Administrador Conexiones de Looker.

Parámetros de JDBC admitidos

Para el dialecto MongoSQL, Looker admite los siguientes parámetros de JDBC en el campo Parámetros adicionales de JDBC:

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

Limitaciones de las consultas y comportamiento de SQL

Cuando compiles modelos de LookML y consultes MongoSQL con la interfaz de SQL, ten en cuenta las siguientes características del dialecto:

  • Requisito del compilador de esquemas de SQL: Como se indicó en los requisitos previos, las consultas de SQL requieren un esquema relacional preconfigurado definido en el compilador de esquemas de SQL de Atlas.
  • Tablas derivadas: Se admiten tablas derivadas efímeras (regulares), pero no se admiten tablas derivadas persistentes (PDT).
  • Tipos de fecha y marca de tiempo: No se admite el tipo de datos date. La práctica estándar es almacenar y modelar fechas como campos timestamp.
  • Zonas horarias: Todas las marcas de tiempo a las que se accede desde la interfaz de MongoSQL se tratan en UTC. Looker no convierte las zonas horarias en la base de datos para las conexiones de MongoDB.

Compatibilidad de características

Para que Looker admita algunas funciones, el dialecto de tu base de datos también debe admitirlas.

MongoSQL admite las siguientes funciones a partir de Looker 26.16:

Función ¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes basadas en SQL
Tablas derivadas persistentes nativas
Vistas estables
Finalización de consultas
Tablas dinámicas basadas en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distinción entre mayúsculas y minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Mostrar procesos del Ejecutor de SQL
Describir tabla del Ejecutor de SQL
Mostrar índices del Ejecutor de SQL
Seleccionar 10 del Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicar SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas entre períodos
Distinción de recuento aproximado
Modelos analíticos en la base de datos
Calendarios personalizados