Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /

Transición del conector BI de Atlas a MongoSQL

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.

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.

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

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

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.

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

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.

1

Selecciona la pestaña para tu sistema operativo a continuación y descarga el archivo ejecutable.

2

Si el archivo no tiene permisos de ejecución, concédalos.

chmod +x <executable-filename>
chmod +x <executable-filename>
chmod +x <executable-filename>
3

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:

  1. En la interfaz de usuario de Atlas, ve al clúster de Atlas con la conexión de BI que deseas analizar.

  2. En las opciones de tu clúster (), selecciona Download Logs.

  3. Descargar mongosql.gz.

  4. Cree un nuevo directorio y luego descomprima mongosql.gz en él.

4

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:

  1. En la Interfaz de Usuario de Atlas, ve al clúster con las colecciones que deseas analizar.

  2. Haga clic en Connect.

  3. Selecciona Shell en la lista de opciones de conexión.

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

5

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, --uri o 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 --output para tu reporte generado. De lo contrario, se genera en tu directorio actual.

  • Puede especificar un --resolver para elegir un solucionador DNS para las solicitudes de red. Los valores posiblescloudflare son:, google quad9y.

  • Puede usar --include o --exclude para 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.

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.

1

Para obtener más información sobre cómo habilitar y usar MongoSQL, consulte Habilitar la interfaz SQL.

2

Para obtener más información sobre cómo conectarse con MongoSQL, consulte Conectar su herramienta de BI.

3

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.

4

Para obtener más información sobre esquemas en MongoSQL, consulte Gestión de esquemas.

5

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.

Los siguientes recursos de MongoDB pueden ayudarle a solucionar problemas de configuración de MongoSQL:

Volver

Overview

En esta página