MongoSQL

Conecta Looker directamente a tu clúster de MongoSQL 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 en SQL y crear paneles interactivos de Looker.

Looker incluye un controlador JDBC con licencia Apache-2.0 y empaquetado oficialmente para la interfaz de MongoSQL. A diferencia del dialecto heredado de MongoBI, no se requiere la instalación manual de archivos JAR del controlador 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:

Crea un esquema relacional con SQL Schema Builder

MongoDB almacena datos en un formato de documento flexible y no relacional (JSON/BSON). Antes de 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 SQL Schema Builder 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 de MongoDB SQL Schema Builder para definir tus esquemas.

Agrega direcciones IP de Looker a la lista de acceso a 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 a IPs 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

Para crear una cuenta de usuario de la base de datos para Looker, usa la consola web de MongoDB Atlas y 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 de 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 los parámetros de conexión de Atlas SQL

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

  1. Accede a la consola de MongoDB Atlas.
  2. Navega a tu clúster y haz clic en Connect.
  3. Selecciona Atlas SQL (o Conecta tu aplicación con SQL).
  4. Selecciona Controlador JDBC.
  5. Ten en cuenta los requisitos de Host, Port (por lo general, 27017), Database 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 más 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.
    • Dialect: Selecciona MongoSQL en el menú desplegable.
    • Host: Es el nombre de host que proporciona la interfaz de MongoSQL (por ejemplo, <cluster-name>.a.query.mongodb.net).
    • Puerto: Número de puerto para Atlas SQL (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: Es el 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) Son parámetros adicionales de JDBC que admite 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 Can Connect, presiona Connect para crear la conexión.

Luego, la conexión de la base de datos se agrega a la lista en la página Connections Admin 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 indica en los requisitos previos, las consultas en SQL requieren un esquema relacional preconfigurado definido en el compilador de esquemas de SQL de Atlas.
  • Tablas derivadas: Se admiten las tablas derivadas efímeras (regulares), pero no las 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 las 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 funciones

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

A partir de Looker 26.18, MongoSQL admite las siguientes funciones:

Función ¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes de SQL
Tablas derivadas persistentes nativas
Vistas estables
Cancelació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
Ejecutor de SQL: Mostrar procesos
Ejecutor de SQL: Describe la tabla
Ejecutor de SQL: Show Indexes
Seleccionar 10 en el Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas comparativas entre períodos
Distinción de recuento aproximado
Modelos analíticos integrados en la base de datos
Calendarios personalizados