Migra a MongoSQL desde MongoBI
Looker ahora admite MongoSQL y recomienda migrar a MongoSQL desde MongoDB Connector for IE.
Debido a las diferencias de sintaxis de SQL entre MongoDB Connector for 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 romper los paneles, los Looks, los programas o las alertas.
Para migrar de MongoBI a MongoSQL de forma segura, sigue estos pasos:
- Revisa las diferencias de sintaxis de SQL entre MongoBI y MongoSQL en la documentación de MongoDB Transición de Atlas BI Connector a MongoSQL.
- Crea una conexión nueva para MongoSQL en Looker como una conexión secundaria.
- En una nueva rama de desarrollo de tu proyecto de LookML, actualiza el parámetro
connectionen tu archivo de modelo para que apunte a la nueva conexión de MongoSQL. - En el Ejecutor de SQL, prueba y ejecuta consultas de muestra desde tus Exploraciones para verificar la sintaxis y los resultados de las consultas.
- Valida tu proyecto y contenido:
- Usa el Validador de contenido para analizar todos los paneles y las vistas en busca de campos o referencias dañados.
- Usa el validador de SQL de la CI de Looker para validar las dimensiones de tus exploraciones con la base de datos.
- Después de resolver los errores de validación, implementa los cambios en producción.
Usa el conector de MongoDB para IE (MongoBI)
Looker puede acceder a MongoDB con el conector de MongoDB para IE a través de 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 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 IE (MongoBI). Para habilitar el conector de BI para Atlas, es necesario 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
- Habilita el conector de MongoDB para BI
- Permitir el uso de tablas derivadas normales (recomendado)
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:
- Obtén la dirección IP de Looker.
- 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:
- Verifica que estés en un clúster M10 o superior.
- En Atlas, abre la página Conectar 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 el conector de Mongo para IE con los siguientes pasos, que se explican en esta página:
- Instala Mongo Connector for BI
- Encripta el tráfico de red
- Configura el usuario y los permisos de Looker
- Permitir el uso de tablas derivadas normales (recomendado)
Instala Mongo Connector for 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 Instala el conector de BI de forma local .
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 Configura 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 el rol readWrite:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Instala los archivos del controlador de JDBC de MongoBI
Para ambas opciones de MongoDB Connector for 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 conductor: 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 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.jarlooker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar
Permitir el uso de tablas derivadas normales (recomendado)
Las tablas derivadas son herramientas importantes en Looker que te permiten ampliar 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 IE admite tablas derivadas normales temporales, pero no admite tablas derivadas persistentes.
Como 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:
- En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
Selecciona MongoBI en el menú desplegable Dialecto.
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.
Para verificar que la conexión se haya establecido 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 la conexión.
Si Looker muestra Can Connect, presiona Connect para crear la conexión.
Luego, la conexión de tu base de datos se agrega a la lista de la página Conexiones de Administrador de Looker.
Usa funciones y operadores de SQL con MongoDB Connector for IE
Cuando desarrollas con un conector de MongoDB para la conexión de 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 de JDBC adicionales de la conexión. Consulta la documentación de tu base de datos para obtener información sobre estos parámetros.
allowMultiQueriesappNameauthSourceautoReconnectcachePrepStmtscharacterEncodingconnectTimeoutconnectTimeoutMSelideSetAutoCommitsenabledSslProtocolSuitesenabledTLSProtocolsexplainSlowQueriesmaxAllowedPacketpasswordqueryInterceptorsqueryTimeoutKillsConnectionreplicaSetrewriteBatchedStatementssocketTimeoutsslsslModetcpKeepAliveuseCompressionuseCursorFetchuseLocalSessionStateuseruseServerPrepStmtsuseSSLverifyServerCertificatezeroDateTimeBehavior
Compatibilidad de funciones
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.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| 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 | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Describe Table del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones 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:
- MongoDB no admite períodos de milisegundos ni microsegundos para los grupos de dimensiones.
- MongoDB no admite los tipos de milisegundo, millisecondX y microsegundo para las dimensiones.
- Looker trata todas las marcas de tiempo a las que se accede desde MongoBI como si estuvieran en la zona horaria de tiempo universal coordinado (UTC).