MongoDB recomienda migrar desde la Atlas BI Connector al nuevo Interfaz SQL.
Nota
El conector BI de Atlas y el conector BI on-premises son herramientas independientes. Esta guía trata sobre la migración desde el Atlas BI Connector, que MongoDB está dejando de utilizar.
MongoSQL
Similar al conector BI de Atlas, MongoSQL te permite analizar datos de clústeres de Atlas utilizando diversas herramientas basadas en SQL, como Tableau y Power BI.
En comparación con el conector Atlas BI, MongoSQL ofrece las siguientes ventajas:
Puedes leer datos de fuentes que no sean clústeres de Atlas utilizando la infraestructura de Atlas Data Federation.
Puedes establecer tu esquema.
Solo pagas por tu uso; no necesitas una suscripción.
Puedes usar conectores personalizados de MongoDB para Tableau y Power BI.
Para obtener más información sobre MongoSQL, consulta query con la Interfaz SQL.
Limitaciones de MongoSQL
MongoSQL es solo de lectura.
MongoSQL es compatible solo con el dialecto SQL 92; no se admiten otros dialectos de SQL.
Todas las limitaciones de Atlas Data Federation se aplican a MongoSQL porque es una funcionalidad de Atlas Data Federation.
Precios de MongoSQL
MongoSQL solo incurre en costos de query de Atlas Data Federation y AWS costos de transferencia; la Interfaz SQL en sí es gratuita de usar. Para obtener más información sobre el costo de las consultas a tu instancia de base de datos federada, consulta Costos de Data Federation.
Nota
Los costos incurridos por las consultas de MongoSQL aparecen en su factura bajo la instancia federada de base de datos que consultó, ya sea como "Datos procesados" o cargos por "Datos devueltos y transferidos".
Prepárate para la Transición a MongoSQL
Para pasar del Conector BI de Atlas a MongoSQL, asegúrate de que tu implementación cumpla con los siguientes requisitos previos:
Además, MongoDB recomienda que generes un Informe de preparación para la transición que te ayude a planificar tu transición.
Requisitos previos
Una instancia federada de base de datos que contiene datos consultables.
Un usuario de base de datos de MongoDB para conectarse a tu instancia de base de datos federada.
Generar un informe de preparación para la transición
MongoDB proporciona una herramienta de preparación para la transición a MongoSQL para ayudarte a planificar tu traslado del Atlas BI Connector a la Interfaz SQL. La herramienta genera un informe basado en tu uso anterior del Conector Atlas BI, proporcionando análisis de esquemas en tiempo real y sugerencias, y resaltando consultas que requieren cambios de sintaxis para ejecutarse correctamente usando MongoSQL.
Para generar un informe, debe proporcionar a la herramienta al menos uno de los siguientes detalles:
Tu registro de Atlas BI Connector, para el análisis de query.
Su clúster URI, para análisis de esquemas.
Puedes analizar tus consultas, tu esquema o ambos.
(Opcional) Descarga y descomprime los registros de tu Conector BI de Atlas.
Proporcionar los registros de Atlas BI Connector permite a la herramienta Readiness Report informar sobre la siguiente información:
Datos históricos de query, como volumen y frecuencia.
Sintaxis de query que fallará en MongoSQL.
campos de colección con tipos de datos desconocidos para las bases de datos relacionales.
Para descargar tus registros de Atlas BI Connector:
En la interfaz de usuario de Atlas, ve al clúster de Atlas con la conexión de BI que deseas analizar.
En las opciones de tu clúster (), selecciona Download Logs.
Descargar
mongosql.gz.Cree un nuevo directorio y luego descomprima
mongosql.gzen él.
(Opcional) Copia la URI de tu clúster.
Proporcionar el URI de tu clúster Atlas permite que la herramienta Readiness Report analice los esquemas de tu colección e identifique los campos que contienen tipos de datos desconocidos para las herramientas SQL.
Para encontrar el URI de tu clúster:
En la Interfaz de Usuario de Atlas, ve al clúster con las colecciones que deseas analizar.
Haga clic en Connect.
Selecciona Shell en la lista de opciones de conexión.
Copia solo tu URI de conexión.
La URI de conexión se parece a:
mongodb+srv://bicluster.example.mongodb.net/. Excluye el ejecutable de shell,mongosh, y cualquier opción de línea de comandos específica del shell.
Generar un informe.
En un terminal, ejecuta el archivo ejecutable de la Herramienta de Informe de Preparación y proporciona los registros descargados o el URI de tu clúster.
Debes incluir el nombre de usuario de tu base de datos.
Debes incluir
--input,--urio ambos. Si incluye su URI, la herramienta Reporte de preparación le solicitará la contraseña del usuario de la base de datos.Puedes especificar un destino
--outputpara tu reporte generado. De lo contrario, se genera en tu directorio actual.Puede especificar un
--resolverpara elegir un DNS resolvedor para solicitudes de red. Los valores posibles son:cloudflare,google, yquad9.Puedes usar
--includeo--excludepara limitar tu lista de namespace. Se admite la sintaxis glob. Por defecto, se incluyen todos los espacios de nombres.
La opción --help devuelve la lista completa de opciones de la Herramienta de Informe de Preparación:
<executable-filename> --help Options: -i, --input <INPUT> Sets the input file or directory to analyze BIC logs (optional). One of `--input` or `--uri` must be provided, or both -o, --output <OUTPUT> Sets the output directory (optional). If not specified, the current directory is used --uri <URI> The Atlas cluster URI to analyze schema (optional). One of `--input` or `--uri` must be provided, or both -u, --username <USERNAME> Username for authentication (optional). This is required if the username and password is not provided in the URI --quiet Enables quiet mode for less output --resolver <RESOLVER> The specified resolver (optional) [possible values: cloudflare, google, quad9] --include <INCLUDE> A list of namespaces to include (optional). If not provided, all namespaces are included. Glob syntax is supported --exclude <EXCLUDE> A list of namespaces to exclude (optional). If not provided, no namespaces are excluded -h, --help Print help (see more with '--help') -V, --version Print version
La Herramienta de Informe de Preparación organiza el resultado y genera un archivo de índice que se puede hacer clic para que pueda navegar fácilmente por el informe.
Transición a MongoSQL
La arquitectura subyacente de MongoSQL es diferente de Atlas BI Connector y es posible que debas adaptar tu esquema o tus consultas.
Para hacer la transición a MongoSQL, identifica las consultas existentes de Atlas BI Connector que fallen en MongoSQL y actualiza tu esquema o su sintaxis para corregirlas.
Advertencia
MongoDB recomienda realizar pruebas exhaustivas del proceso de transición en un entorno de pruebas antes de implementar cambios en su entorno de producción. Pasar del conector Atlas BI a MongoSQL sin adaptar tu esquema o tus consultas puede causar cambios disruptivos.
Habilita MongoSQL para tu instancia federada de base de datos.
Para obtener más información sobre cómo habilitar y usar MongoSQL, consulte Habilitar la interfaz SQL.
Conéctese a sus datos con la interfaz SQL.
Para obtener más información sobre cómo conectar con MongoSQL, consulta Conecta tu herramienta de BI.
Prueba tus consultas.
Prueba tus queries con tu nueva conexión MongoSQL para asegurarte de que se ejecuten y devuelvan los resultados que esperas.
Para obtener más información sobre cómo consultar con MongoSQL, consulta Query con instrucciones MongoSQL.
Consulta tu esquema y adáptalo si es necesario.
Para obtener más información sobre esquemas en MongoSQL, consulte Gestión de esquemas.
Adapta cualquier query que esté fallando.
Es posible que algunas sintaxis de query deban cambiarse cuando se realice la transición del BI Connector de Atlas a MongoSQL.
Para aprender más sobre la sintaxis de la query MongoSQL, consulta la Referencia del lenguaje MongoSQL.
Solucionar problemas de MongoSQL
Los siguientes recursos de MongoDB pueden ayudarte a solucionar problemas con tu configuración de MongoSQL:
Las comunidades de MongoDB en Reddit o Stack Overflow
Tu equipo de Éxito del Cliente