Conector de MongoDB para BI

Looker requiere al menos MongoDB 4.0 o versiones posteriores y MongoDB Connector para BI versión 2.6.0+ (donde se introdujo la variable de sesión type_conversion_mode).

Looker puede acceder a MongoDB con MongoDB Connector para BI mediante dos opciones:

  • Usa 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 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 MongoDB para BI (MongoBI). Habilitar el conector de BI 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, su administrador de MongoDB o Atlas debe configurar el conector de MongoDB para BI con los siguientes pasos, que se explican en esta página:

Agrega el servidor de Looker a la lista de acceso de IP de Atlas

Atlas solo permite conexiones de clientes de entradas en la lista de acceso IP de un proyecto. Agregue la dirección IP de Looker a la lista de acceso IP del proyecto de Atlas:

  1. Obtén la dirección IP de Looker.
  2. Siga las instrucciones de la configuración de la lista de acceso 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 BI

Habilita el conector de MongoDB para BI:

  1. Verifica que estés en un clúster M10+.
  2. En Atlas, abre la página Connect del clúster. Toma nota del 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 Mongo Connector para BI con los siguientes pasos, que se explican en esta página:

Instala el conector Mongo para BI

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

Encriptar el tráfico de red

El conector de MongoDB para BI requiere el uso de la 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 Configurar SSL para BI Connector.

Configura 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 la función readWrite:

use looker_database

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

Instala los archivos del controlador JDBC de MongoBI

Para ambas opciones de MongoDB Connector para BI, Looker requiere que se configuren los archivos del controlador JDBC mediante los siguientes pasos:

Descarga estos dos archivos JAR:

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

símbolo del 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

Para el paso de colocar el controlador en el directorio de tu dialecto, las rutas 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

Las tablas derivadas son herramientas importantes en Looker que le permiten expandir la sofisticación de sus análisis. También pueden desempeñar una función valiosa para mejorar el rendimiento de las consultas. En un nivel alto, la funcionalidad de la tabla derivada de Looker proporciona una forma de crear tablas nuevas que aún no existen en tu base de datos.

MongoDB Connector para BI admite tablas derivadas regulares temporales, pero aún no admite tablas persistentes derivadas.

Debido a que las tablas derivadas regulares son temporales, no necesitan almacenarse. Por lo tanto, no necesitas crear un esquema para ellos. Sin embargo, debes otorgar la función dbOwner al esquema looker_tmp, incluso si ese esquema no existe.

Sigue la sección Modificar usuarios de MongoDB en esta página de documentación de MongoDB a fin de agregar la función dbOwner en looker_tmp para el usuario que usará Looker a fin de conectarse.

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

Agrega la conexión

Configurar una conexión de base de datos a través de la interfaz de Looker En la sección Administrador, seleccione Conexiones y, luego, haga clic en Agregar conexión. Completa los detalles de la conexión (consulta la página de documentación Conecta Looker a tu base de datos para obtener más información).

Haga clic en Probar esta configuración para verificar que la conexión se haya realizado correctamente. La página de documentación Prueba la conectividad de la base de datos contiene información para la solución de problemas.

Usa funciones y operadores de SQL con MongoDB Connector para BI

Cuando desarrolla con un conector de MongoDB para conexión de BI, puede usar las funciones y los operadores de SQL que se enumeran en esta página de 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.

En la versión más reciente de Looker, MongoDB es compatible con las siguientes características de Looker:

Además, tenga en cuenta lo siguiente:

Próximos pasos

Después de completar la configuración de la base de datos, conéctate a Looker desde la base de datos.