Conector de MongoDB para la IE

Looker puede acceder a MongoDB con el conector de MongoDB para IE usando dos opciones:

  • Con el conector de MongoDB para BI 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 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 el conector de BI 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.

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

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:

  1. Obtén la dirección IP de Looker.
  2. 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 BI:

  1. Verifica que estés en un clúster M10 o superior.
  2. 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 BI siguiendo los pasos que se explican en esta página:

Instalar el conector de Mongo para IE

Instala el conector de MongoDB para BI 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.

Encripta el tráfico de red

El conector de MongoDB para BI 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 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

Para ambas opciones del conector de MongoDB para la IE, Looker requiere que configures 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 de JDBC sin empaquetar con los siguientes valores:

símbolo del controlador: 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, haz lo siguiente:

- 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 expandir la sofisticación de tus análisis. También pueden desempeñar un papel valioso en la mejora del rendimiento de las consultas. En términos generales, la función 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 BI admite tablas derivadas normales temporales, pero no tablas derivadas persistentes.

Dado que las tablas derivadas regulares son temporales, no es necesario almacenarlas. Por lo tanto, no necesitas 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 Modifica los usuarios de MongoDB en esta página de la documentación de MongoDB sobre la configuración de usuarios de base de datos para agregar el rol dbOwner en looker_tmp para el usuario que usará Looker 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:

  1. En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
  2. Selecciona MongoBI en el menú desplegable Dialect.

  3. 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 información.

  4. Para verificar que la conexión se haya establecido 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.

  5. Para guardar esta configuración, haz clic en Conectar.

Cómo usar funciones y operadores de SQL con el conector de MongoDB para BI

Cuando desarrolles con un conector de MongoDB para la conexión de BI, puedes usar los operadores y funciones de SQL que se indican en la documentación de MongoDB.

Compatibilidad de características

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 24.16:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No
Agregados simétricos
No
Tablas derivadas
Tablas derivadas de SQL persistentes
No
Tablas derivadas persistentes nativas
No
Vistas estables
No
Cierre de consultas
Pivotes basados en SQL
No
Zonas horarias
No
SSL
Subtotales
No
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
Tipo de ubicación
Tipo de lista
No
Percentil
No
Percentil de valores distintos
No
Procesos de presentación del ejecutor de SQL
Tabla Describe de SQL Runner
Índices de Show de SQL Runner
Selección del ejecutor de SQL 10
Recuento de ejecutores de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios contextuales
Agrupación de conexiones
No
Esbozos de HLL
No
Reconocimiento agregado
No
PDT incrementales
No
Milisegundos
No
Microsegundos
No
Vistas materializadas
No
Distinción de recuento aproximado
No

Además, tenga en cuenta lo siguiente: