Looker puede acceder a MongoDB con el conector de MongoDB para IE usando dos opciones:
- Cómo usar el conector de MongoDB para IE en MongoDB Atlas.
- Cómo 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+. Para que Looker use una base de datos de MongoDB que se ejecute en MongoDB Atlas, debes usar el Conector de MongoDB para BI (MongoBI). Habilitar el conector de IE para Atlas requiere que MongoDB Atlas use un clúster M10+.
También debes crear una cuenta de usuario que tenga permisos de lectura para la base de datos deseada.
Configura el conector de MongoDB para BI
Antes de crear una conexión en Looker, tu 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 de IP de Atlas
- Habilitar el conector de MongoDB para IE
- Permitir el uso de tablas derivadas normales (recomendado)
Agrega el servidor de Looker a la lista de acceso de IP de Atlas
Atlas solo permite conexiones de clientes desde entradas en la lista de acceso de IP del proyecto. Agrega la dirección IP de Looker a la lista de acceso de IP del proyecto de Atlas:
- Obtén la dirección IP de Looker.
- Sigue las instrucciones de configuración de la lista de acceso de IP de Atlas para agregar la dirección IP de Looker a la lista de acceso de IP de Atlas.
Habilita el conector de MongoDB para IE
Habilita el conector de MongoDB para IE:
- Verifica que estés en un clúster M10 o superior.
- 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, tu administrador de MongoDB debe configurar MongoDB y el conector de Mongo para IE siguiendo estos pasos, que se explican en esta página:
- Instalar el conector de Mongo para IE
- Encripta el tráfico de red
- Configura el usuario y los permisos de Looker
- Permitir el uso de tablas derivadas normales (recomendado)
Instalar el conector de Mongo para IE
Instala el conector de MongoDB para IE en el mismo servidor que la base de datos de MongoDB, como se explica en Cómo instalar el conector de IE en las instalaciones. Página de documentación de MongoDB.
Encripta el tráfico de red
El conector de MongoDB para IE requiere la encriptación SSL entre el servidor de MongoDB y la aplicación de Looker. Sigue las instrucciones de configuración de SSL que se indican en la página de documentación Configura SSL para el conector de IE de MongoDB.
Cómo configurar el usuario y los permisos de Looker
En la 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" ]
})
Instala los archivos de controlador de JDBC de MongoBI
En el caso de las dos opciones de MongoDB Connector para IE, Looker requiere configurar los archivos de controladores de JDBC siguiendo estos pasos:
Descarga estos dos archivos JAR:
Sigue los pasos que se indican en la página de documentación Controladores de JDBC sin empaquetar con los siguientes valores:
símbolo del controlador: mongobi
entrada del controlador:
- 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 normales (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 alto, la función de tabla derivada 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 crear 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 Modificar los usuarios de MongoDB en esta página de documentación de MongoDB sobre la configuración de usuarios de bases de datos para agregar el rol de dbOwner
en looker_tmp
para el usuario que Looker usará para conectarse.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Crea 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 Dialecto.
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.
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.
Cómo usar operadores y funciones de SQL con el conector de MongoDB para IE
Cuando desarrolles con un conector de MongoDB para la conexión de IE, podrás usar las funciones y los operadores de SQL enumerados en la documentación de MongoDB.
Compatibilidad de características
Para que Looker admita algunas funciones, el dialecto de la base de datos también debe admitirlas.
A partir de Looker 24.14, MongoBI es compatible con las siguientes funciones:
Atributo | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | No |
Agregados simétricos | No |
Tablas derivadas | Sí |
Tablas derivadas de SQL persistente | No |
Tablas derivadas persistentes nativas | No |
Vistas estables | No |
Cierre de consultas | Sí |
Tablas dinámicas basadas en SQL | No |
Zonas horarias | No |
SSL | Sí |
Subtotales | No |
Parámetros adicionales de JDBC | Sí |
Distingue mayúsculas de minúsculas | Sí |
Tipo de ubicación | Sí |
Tipo de lista | No |
Percentil | No |
Percentil distintivo | No |
Procesos de presentación del ejecutor de SQL | Sí |
Tabla Describe de SQL Runner | Sí |
Índices de programas del ejecutor de SQL | Sí |
Selección del ejecutor de SQL 10 | Sí |
Recuento de ejecutores de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Bocetos de HLL | No |
Reconocimiento agregado | No |
PDT incrementales | No |
Milisegundos | No |
Microsegundos | No |
Vistas materializadas | No |
Recuento aproximado de valores distintos | No |
Además, tenga en cuenta lo siguiente:
- MongoDB no admite períodos de milisegundos y microsegundos para grupos de dimensiones.
- MongoDB no admite 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 la hora universal coordinada (UTC).