Conector de MongoDB para BI

Looker puede acceder a MongoDB mediante el conector de MongoDB para BI de dos formas:

  • Usar el conector de MongoDB para BI en MongoDB Atlas.
  • Usar un conector de MongoDB para BI instalado en el mismo servidor que la base de datos de MongoDB.

MongoDB Atlas

Tu instancia de 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 BI (MongoBI). Para habilitar 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 que quieras.

Configurar el conector de MongoDB para BI

Antes de crear una conexión en Looker, el administrador de MongoDB o Atlas debe configurar el conector de MongoDB para BI siguiendo estos pasos, que se explican en esta página:

Añadir el servidor de Looker a la lista de acceso por IP de Atlas

Atlas solo permite conexiones de clientes procedentes de entradas de la lista de acceso por IP del proyecto. Añade la dirección IP de Looker a la lista de acceso por IP del proyecto de Atlas:

  1. Obtén la dirección IP de Looker.
  2. Sigue las instrucciones para configurar la lista de acceso por IP de Atlas y añade la dirección IP de Looker a la lista de acceso por IP de Atlas.

Habilitar el conector de MongoDB para BI

Habilita el conector de MongoDB para BI:

  1. Verifica que estés en un clúster M10 o posterior.
  2. En Atlas, abre la página Connect del clúster. Anota el nombre de host, el puerto y el usuario. Deberá usar esa información al configurar 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 Mongo Connector for BI siguiendo estos pasos, que se explican en esta página:

Instalar el conector de Mongo para BI

Instala MongoDB Connector for BI en el mismo servidor que la base de datos de MongoDB, tal como se explica en la página de documentación de MongoDB Install BI Connector On Premises (Instalar BI Connector en las instalaciones).

Cifrar el tráfico de red

El conector de MongoDB para BI requiere el uso del cifrado SSL entre el servidor de MongoDB y la aplicación Looker. Sigue las instrucciones de configuración de SSL que se indican en la página de documentación Configurar SSL para BI Connector de MongoDB.

Configurar el usuario y los permisos de Looker

En el shell de MongoDB, introduce el comando use para cambiar a la base de datos a la que se conectará Looker. A continuación, crea un usuario para Looker con db.createUser() y el rol readWrite:

use looker_database

db.createUser({ user: looker,
                pwd: `some_password_here`,
                roles: [ "readWrite" ]
              })

Instalar los archivos del controlador JDBC de MongoBI

Para ambas opciones del conector de MongoDB para BI, Looker requiere que se configuren los archivos del controlador JDBC siguiendo estos pasos:

Descarga estos dos archivos JAR:

Sigue los pasos que se indican en la página de documentación Controladores JDBC sin empaquetar con los siguientes valores:

Símbolo de 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 estos archivos serán las siguientes:

  • looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
  • looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar

Permitir el uso de tablas derivadas normales (opción recomendada)

Las tablas derivadas son herramientas importantes de Looker que te permiten ampliar la sofisticación de tus análisis. También pueden desempeñar un papel valioso a la hora de mejorar el rendimiento de las consultas. A grandes rasgos, la función de tabla derivada de Looker permite crear tablas que aún no existen en tu base de datos.

El conector de MongoDB para BI admite tablas derivadas normales temporales, pero no tablas derivadas persistentes.

Como 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 asignar el rol dbOwner al esquema looker_tmp, aunque no exista.

Sigue las instrucciones de la sección "Modify MongoDB Users" (Modificar usuarios de MongoDB) de esta página de documentación de MongoDB sobre la configuración de usuarios de bases de datos para añadir el rol dbOwner en looker_tmp al usuario que Looker usará para conectarse.

db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])

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:

  1. En la sección Administrar de Looker, selecciona Conexiones y, a continuación, haz clic en Añadir conexión.

  2. Selecciona MongoBI en el menú desplegable Dialect (Dialecto).

  3. Rellena los detalles de la conexión. La mayoría de los ajustes son comunes a la mayoría de los dialectos de bases de datos. Consulta la página de documentación Conectar Looker a tu base de datos para obtener información.

  4. Para verificar que la conexión se ha realizado correctamente, haz clic en Probar. Consulta la página de documentación Probar la conectividad de la base de datos para obtener información sobre cómo solucionar problemas.

  5. Para guardar estos ajustes, haz clic en Conectar.

Usar funciones y operadores de SQL con MongoDB Connector for BI

Cuando desarrolles con una conexión de MongoDB Connector for BI, puedes usar las funciones y los operadores de SQL que se indican en la documentación de MongoDB.

Funciones admitidas

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

MongoBI admite las siguientes funciones a partir de Looker 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
No
Agregados simétricos
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No
Tablas derivadas nativas persistentes
No
Vistas estables
No
Eliminación de consultas
Sí
Pivotes basados en SQL
No
Zonas horarias
No
SSL
Sí
Subtotales
No
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
No
Percentil
No
Percentil de valores distintos
No
SQL Runner Show Processes
Sí
SQL Runner Describe Table
Sí
SQL Runner Show Indexes
Sí
SQL Runner Select 10
Sí
Recuento de ejecuciones de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
No
Esquemas HLL
No
Notoriedad agregada
No
PDTs incrementales
No
Milisegundos
No
Microsegundos
No
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No

Además, también ocurre lo siguiente: