Conecta Looker a tu clúster de MongoSQL directamente con el dialecto MongoSQL (con la tecnología de la interfaz de MongoSQL). Conectar Looker a MongoSQL te permite analizar datos de documentos con consultas en SQL relacionales y crear paneles interactivos de Looker.
Looker incluye un controlador JDBC con licencia de Apache-2.0 empaquetado oficialmente para la interfaz de MongoSQL de forma predeterminada. 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
- Agrega direcciones IP de Looker a la lista de acceso de IP de Atlas
- Crea una cuenta de usuario de MongoDB para Looker
- Obtén los parámetros de conexión de Atlas SQL
Crea un esquema relacional con el compilador de esquemas de SQL
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 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 en SQL en tus colecciones de MongoDB.
Consulta la documentación de MongoSQL Schema Builder 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 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:
- Obtén la lista de direcciones IP de Looker para la región de tu instancia de Looker.
- 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:
- Accede a la consola de MongoDB Atlas.
- En el menú de navegación principal, en Seguridad, selecciona Acceso a la base de datos.
- Haz clic en Agregar un nuevo usuario de base de datos.
- Selecciona Contraseña como método de autenticación. Ingresa un Nombre de usuario (por ejemplo,
looker) y una contraseña segura. - En Privilegios de usuario de la base de datos, selecciona Rol integrado y asigna el rol
read(o los permisos de lectura personalizados) para la base de datos a la que accederá Looker. - 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 de Atlas SQL. Para obtener la información del parámetro, sigue estos pasos:
- Accede a la consola de MongoDB Atlas.
- Navega a tu clúster y haz clic en Conectar.
- Selecciona Atlas SQL (o Conecta tu aplicación con SQL).
- Selecciona Controlador de JDBC.
- Toma nota del Host, el Puerto (por lo general,
27017), la Base de datos y los requisitos de 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:
- En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
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: Es el nombre de host que proporciona la interfaz de MongoSQL (por ejemplo,
<cluster-name>.a.query.mongodb.net). - Puerto: Es el número de puerto para Atlas SQL (predeterminado:
27017). - Base de datos: Es el 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 que se creó para Looker.
- Contraseña: Es la 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=adminoconnectTimeoutMS=10000. Consulta Parámetros de JDBC admitidos.
Para verificar la conectividad de la base de datos, haz clic en Probar conexión.
Si Looker muestra Can Connect, presiona Connect para crear la conexión.
Luego, la conexión de tu base de datos se agrega a la lista de la página Conexiones de Administrador 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:
appNameauthSourceclientinfoconnectTimeoutMSdirectConnectiondisableclientcacheextjsonmodeheartbeatFrequencyMSjournallocalThresholdMSmaxIdleTimeMSmaxWaitTimeMSreadPreferencereplicaSetretryReadsretryWritesserverSelectionTimeoutMSsocketTimeoutMSssltlstlsAllowInvalidHostnamestlsInsecurewwtimeoutMS
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 de SQL Schema Builder: Como se indica en los requisitos previos, las consultas en SQL requieren un esquema relacional preconfigurado definido en Atlas SQL Schema Builder.
- Tablas derivadas: Se admiten las tablas derivadas efímeras (normales), 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 fechas como campostimestamp. - 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, el dialecto de tu base de datos también debe admitirlas.
MongoSQL admite las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Describe Table del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |