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:
- Agregue el servidor de Looker a la lista de acceso de IP de Atlas
- Habilita el conector de MongoDB para BI
- Permitir el uso de tablas derivadas regulares (recomendado)
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:
- Obtén la dirección IP de Looker.
- 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:
- Verifica que estés en un clúster M10+.
- 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
- Encripta el tráfico de red
- Configura el usuario y los permisos de Looker
- Permitir el uso de tablas derivadas regulares (recomendado)
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
Permitir el uso de tablas derivadas regulares (recomendado)
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:
- MongoDB no admite períodos de milisegundos y microsegundos para grupos de dimensiones.
- MongoDB no admite tipos de milisegundos, milisegundos y microsegundos para las dimensiones.
- Looker considera todas las marcas de tiempo a las que se accedió desde MongoBI como si estuvieran en la zona horaria universal coordinada (UTC).
Próximos pasos
Después de completar la configuración de la base de datos, conéctate a Looker desde la base de datos.