Conector de MongoDB para la IE

Migra a MongoSQL desde MongoBI

Looker ahora admite MongoSQL y recomienda migrar a MongoSQL desde el conector de MongoDB para IE.

Debido a las diferencias en la sintaxis de SQL entre el conector de MongoDB para IE (MongoBI) y MongoSQL, es posible que los modelos de LookML existentes que usan bloques de SQL personalizados, formato de fecha o funciones de base de datos requieran ajustes de sintaxis. No cambies una conexión de producción existente directamente a MongoSQL sin validar primero tu código de LookML, ya que esto puede interrumpir los paneles, las Looks y las programaciones o alertas.

Para migrar de forma segura de MongoBI a MongoSQL, sigue estos pasos:

  1. Revisa las diferencias en la sintaxis de SQL entre MongoBI y MongoSQL en la documentación de MongoDB Transición del conector de BI de Atlas a MongoSQL.
  2. Crea una conexión nueva para MongoSQL en Looker como conexión secundaria.
  3. En una rama de desarrollo nueva de tu proyecto de LookML, actualiza el parámetro connection en tu archivo de modelo para que apunte a la nueva conexión de MongoSQL.
  4. En el Ejecutor de SQL, prueba y ejecuta consultas de muestra desde tus Exploraciones para verificar la sintaxis y los resultados de las consultas.
  5. Valida tu proyecto y contenido:
  6. Después de resolver los errores de validación, implementa los cambios en la producción.

Usa el conector de MongoDB para IE (MongoBI)

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

  • Usa el conector de MongoDB para IE en MongoDB Atlas.
  • Usa 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 ejecuta en MongoDB Atlas, debes usar el conector de MongoDB para IE (MongoBI). Para habilitar el conector de BI para Atlas, se 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 elegida.

Configura el conector de MongoDB para IE

Antes de crear una conexión en Looker, el administrador de MongoDB o Atlas debe configurar el conector de MongoDB para IE 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 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 IE:

  1. Verifica que estás en un clúster M10+.
  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 IE con los siguientes pasos, que se explican en esta página:

Instala 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 la página de documentación de MongoDB Install BI Connector On Premises .

Encripta el tráfico de red

El conector de MongoDB para IE 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 en la página de documentación de MongoDB Configure SSL for 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 el rol 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 del conector de MongoDB para IE, Looker requiere configurar los archivos del controlador JDBC con los siguientes pasos:

Descarga estos dos archivos JAR:

Sigue los pasos de la página de documentación Unpackaged JDBC drivers con los siguientes valores:

driver symbol: mongobi

driver entry:

- name: mongobi
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

Si usas Looker 6.2 o versiones anteriores:

- 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 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 rol valioso en la mejora del rendimiento de las consultas. En un nivel superior, la capacidad 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 IE admite tablas derivadas normales temporales, pero no admite tablas derivadas persistentes.

Dado que las tablas derivadas normales son temporales, no es necesario almacenarlas. Por lo tanto, no necesitas crear un esquema para ellas. Sin embargo, debes otorgar el rol dbOwner al esquema looker_tmp, incluso si ese esquema no existe.

Sigue la sección Modifica 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 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:

  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 Dialecto.

  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 Conecta Looker a tu base de datos para obtener información.

  4. Para verificar que la conexión se realizó correctamente, haz clic en el botón Probar conexión en la sección Detalles del estado en la parte inferior de la página Configuración de conexiones.

  5. Si Looker muestra Se puede conectar, presiona Conectar para crear la conexión.

Luego, la conexión de la base de datos se agrega a la lista en la página Administrador Conexiones de Looker.

Usa funciones y operadores de SQL con el conector de MongoDB para IE

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

Parámetros de JDBC admitidos

Para el conector de MongoDB para IE, Looker admite los siguientes parámetros de JDBC en el campo Parámetros adicionales de JDBC para la conexión. Consulta la documentación de tu base de datos para obtener información sobre estos parámetros.

  • allowMultiQueries
  • appName
  • authSource
  • autoReconnect
  • cachePrepStmts
  • characterEncoding
  • connectTimeout
  • connectTimeoutMS
  • elideSetAutoCommits
  • enabledSslProtocolSuites
  • enabledTLSProtocols
  • explainSlowQueries
  • maxAllowedPacket
  • password
  • queryInterceptors
  • queryTimeoutKillsConnection
  • replicaSet
  • rewriteBatchedStatements
  • socketTimeout
  • ssl
  • sslMode
  • tcpKeepAlive
  • useCompression
  • useCursorFetch
  • useLocalSessionState
  • user
  • useServerPrepStmts
  • useSSL
  • verifyServerCertificate
  • zeroDateTimeBehavior

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

Función ¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes basadas en SQL
Tablas derivadas persistentes nativas
Vistas estables
Eliminación de consultas
Tablas dinámicas basadas en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distinción entre mayúsculas y minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Mostrar procesos del Ejecutor de SQL
Describir tabla del Ejecutor de SQL
Mostrar índices del Ejecutor de SQL
Seleccionar 10 del Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicar SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas entre períodos
Distinción de recuento aproximado
Modelos analíticos en la base de datos
Calendarios personalizados

Además, tenga en cuenta lo siguiente: