MongoDB recomienda migrar desde el Atlas BI Connector al nuevo Interfaz SQL.
Nota
El Conector de BI de Atlas y el Conector de BI local son herramientas independientes. Esta guía trata sobre la migración desde el Conector de BI de Atlas, que MongoDB está descontinuando.
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 configurar 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 MongoSQL aparecen en su factura bajo la instancia de base de datos federada que consultó, ya sea como cargos "Datos procesados" o "Datos devueltos y transferidos".
Prepárese 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 MongoDB para conectarse a su instancia de base de datos federada.
Generar un informe de preparación para la transición
MongoDB ofrece una herramienta de preparación para la transición de MongoSQL que le ayudará a planificar su migración del Conector Atlas BI a la Interfaz SQL. Esta herramienta genera un informe basado en su uso anterior del Conector Atlas BI, que proporciona análisis de esquemas y sugerencias en tiempo real, y destaca las consultas que requieren cambios de sintaxis para ejecutarse correctamente con 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 la URI de su 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 una terminal, ejecute el ejecutable de la herramienta de informes de preparación y proporcione los registros descargados o la URI de su clúster.
Debes incluir tu nombre de usuario de la 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 solucionador DNS para las solicitudes de red. Los valores posiblescloudflareson:,googlequad9y.Puede usar
--includeo--excludepara limitar la lista de espacios de nombres. Se admite la sintaxis glob. De forma predeterminada, 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 informes de preparación organiza los resultados y genera un archivo de índice en el 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 probar el proceso de transición completo en un entorno de pruebas antes de realizar cambios en el entorno de producción. La transición del Conector Atlas BI a MongoSQL sin adaptar el esquema ni las consultas podría causar cambios importantes.
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 conectarse con MongoSQL, consulte Conectar su 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 sea necesario cambiar alguna sintaxis de consulta al realizar la transición del Conector Atlas BI 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 ayudarle a solucionar problemas de configuración de MongoSQL:
Las comunidades de MongoDB en Reddit o Stack Overflow
Tu equipo de Éxito del Cliente