Looker puede acceder a MongoDB con el conector de MongoDB para IE de dos maneras:
- Usar el conector de MongoDB para IE en MongoDB Atlas
- Usar un conector de MongoDB para IE instalado en el mismo servidor que la base de datos de MongoDB
MongoDB Atlas
Tu MongoDB Atlas debe usar un clúster M10 o superior. Para que Looker use una base de datos de MongoDB que se ejecute en MongoDB Atlas, debes usar el conector de MongoDB para IE (MongoBI). Para habilitar el BI Connector para Atlas, MongoDB Atlas debe usar un clúster M10 o superior.
También debes crear una cuenta de usuario que tenga permisos de lectura para la base de datos deseada.
Configuración del conector de MongoDB para IE
Antes de crear una conexión en Looker, el administrador de MongoDB o Atlas debe configurar el conector de MongoDB para IE siguiendo estos pasos, que se explican en esta página:
- Agrega el servidor de Looker a la lista de acceso a IP de Atlas
- Habilita el conector de MongoDB para BI
- Permitir el uso de tablas derivadas normales (recomendado)
Cómo agregar el servidor de Looker a la lista de acceso a IP de Atlas
Atlas solo permite conexiones de clientes desde entradas en la lista de acceso a IP del proyecto. Agrega la dirección IP de Looker a la lista de acceso a IP del proyecto de Atlas:
- Obtén la dirección IP de Looker.
- Sigue las instrucciones de configuración de la lista de acceso a IPs de Atlas para agregar la dirección IP de Looker a la lista de acceso a IPs de Atlas.
Cómo habilitar el conector de MongoDB para IE
Habilita el conector de MongoDB para IE:
- Verifica que estés en un clúster M10 o posterior.
- En Atlas, abre la página Connect del clúster. Anota el nombre de host, el puerto y el usuario. Deberás usar esa información cuando configures la conexión en Looker.
MongoDB en el mismo servidor
Antes de crear una conexión en Looker, el administrador de MongoDB debe configurar MongoDB y el conector de Mongo para IE siguiendo estos pasos, que se explican en esta página:
- Instala el conector de Mongo para BI
- Encriptación del tráfico de red
- Cómo configurar el usuario y los permisos de Looker
- Permite el uso de tablas derivadas normales (recomendado)
Instala el conector de MongoDB para IE
Instala el conector de MongoDB para IE en el mismo servidor que la base de datos de MongoDB, como se explica en la página de documentación de MongoDB Install BI Connector On Premises .
Encriptación del tráfico de red
El conector de MongoDB para IE requiere el uso de encriptación SSL entre el servidor de MongoDB y la aplicación de Looker. Sigue las instrucciones de configuración de SSL en la página de documentación de MongoDB Configure SSL for BI Connector.
Cómo configurar el usuario y los permisos de Looker
En el shell de MongoDB, ingresa el comando use
para cambiar a la base de datos a la que se conectará Looker. Luego, crea un usuario para Looker con db.createUser()
con el rol readWrite
:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Cómo instalar los archivos del controlador JDBC de MongoBI
Para ambas opciones del conector de MongoDB para IE, Looker requiere que se configuren los archivos del controlador JDBC. Para ello, sigue estos pasos:
Descarga estos dos archivos JAR:
Sigue los pasos que se indican en la página de documentación de controladores JDBC sin empaquetar con los siguientes valores:
Símbolo de conductor: mongobi
Entrada del conductor:
- name: mongobi
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
Si usas Looker 6.2 o una versión anterior:
- name: maria15x
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
En el paso para colocar el controlador en el directorio de tu dialecto, las rutas de acceso a estos archivos se verán de la siguiente manera:
looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar
Permite el uso de tablas derivadas regulares (recomendado)
Las tablas derivadas son herramientas importantes en Looker que te permiten ampliar la sofisticación de tus análisis. También pueden desempeñar un papel valioso en la mejora del rendimiento de las consultas. En un nivel general, la capacidad de tablas derivadas de Looker proporciona una forma de crear tablas nuevas que aún no existen en tu base de datos.
El conector de MongoDB para IE admite tablas derivadas regulares temporales, pero no admite tablas derivadas persistentes.
Dado que las tablas derivadas normales son temporales, no es necesario almacenarlas. Por lo tanto, no es necesario que crees un esquema para ellos. Sin embargo, debes otorgar el rol dbOwner
al esquema looker_tmp
, incluso si ese esquema no existe.
Sigue la sección Modify MongoDB Users en esta página de documentación de MongoDB sobre la configuración de usuarios de bases de datos para agregar el rol dbOwner
en looker_tmp
para el usuario que Looker usará para conectarse.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Cómo crear la conexión de Looker a tu base de datos
Sigue estos pasos para crear la conexión de Looker a tu base de datos:
- En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
Selecciona MongoBI en el menú desplegable Dialect.
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 Cómo conectar Looker a tu base de datos para obtener más información.
Para verificar que la conexión se haya realizado correctamente, haz clic en Probar. Consulta la página de documentación Prueba la conectividad de la base de datos para obtener información sobre la solución de problemas.
Para guardar esta configuración, haz clic en Conectar.
Usa funciones y operadores de SQL con el conector de MongoDB para IE
Cuando desarrolles con una conexión de MongoDB Connector for IE, puedes usar las funciones y los operadores de SQL que se indican en la documentación de MongoDB.
Compatibilidad de características
Para que Looker admita algunas funciones, tu dialecto de base de datos también debe admitirlas.
A partir de Looker 25.10, MongoBI admite las siguientes funciones:
Función | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | No |
Agregaciones simétricas | No |
Tablas derivadas | Sí |
Tablas derivadas persistentes basadas en SQL | No |
Tablas derivadas persistentes nativas | No |
Vistas estables | No |
Cancelación de consultas | Sí |
Tablas dinámicas basadas en SQL | No |
Zonas horarias | No |
SSL | Sí |
Subtotales | No |
Parámetros adicionales de JDBC | Sí |
Distinción entre mayúsculas y minúsculas | Sí |
Tipo de ubicación | Sí |
Tipo de lista | No |
Percentil | No |
Percentil de valores distintos | No |
Ejecutor de SQL: Mostrar procesos | Sí |
Ejecutor de SQL: Describe la tabla | Sí |
Ejecutor de SQL: Mostrar índices | Sí |
Seleccionar 10 en el Ejecutor de SQL | Sí |
Recuento del Ejecutor de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth 2.0 | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Esbozos de HLL | No |
Conocimiento total | No |
PDT incrementales | No |
Milisegundos | No |
Microsegundos | No |
Vistas materializadas | No |
Medidas de comparación entre períodos | No |
Distinción de recuento aproximado | No |
Además, tenga en cuenta lo siguiente:
- MongoDB no admite períodos de milisegundos y microsegundos para los grupos de dimensiones.
- MongoDB no admite los tipos de milisegundos, milisegundosX y microsegundos para las dimensiones.
- Looker trata todas las marcas de tiempo a las que se accede desde MongoBI como si estuvieran en la zona horaria de hora universal coordinada (UTC).