Docs Menu
Docs Home
/ /

Transición del conector Atlas BI a MongoSQL

MongoDB recomienda migrar desde el Conector Atlas BI a la versión más reciente 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 Atlas BI, MongoSQL le permite analizar datos de clústeres Atlas utilizando una variedad de herramientas basadas en SQL, como Tableau y Power BI.

En comparación con Atlas BI Connector, MongoSQL ofrece las siguientes ventajas:

  • Puede leer datos de fuentes distintas a los clústeres Atlas utilizando la infraestructura de Atlas Data Federation.

  • Puedes configurar tu esquema.

  • Usted paga sólo por su uso; no necesita una suscripción.

  • Puede utilizar conectores MongoDB personalizados para Tableau y Power BI.

Para obtener más información sobre MongoSQL, consulte Consulta con interfaz SQL.

  • MongoSQL es solo de lectura.

  • MongoSQL sólo es compatible con el dialecto SQL 92; no se admiten otros dialectos SQL.

  • Todas las limitaciones de Atlas Data Federation se aplican a MongoSQL porque es una característica de Atlas Data Federation.

MongoSQL solo incurre en costos de consulta de Atlas Data Federation y Costos de transferencia deAWS; la interfaz SQL es gratuita. Para obtener más información sobre el costo de consultar su instancia de base de datos federada, consulte Costos de federación de datos.

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 realizar la transición del Conector Atlas BI a MongoSQL, asegúrese de que su implementación cumpla con los siguientes requisitos previos:

Además, MongoDB recomienda generar un Informe de preparación para la transición para ayudar a planificar su transición.

  • Una instancia de base de datos federada 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 URI de clúster, para análisis de esquema.

Puede analizar sus consultas, su esquema o ambos.

1

Seleccione la pestaña correspondiente a su sistema operativo a continuación y descargue el archivo ejecutable.

2

Si el archivo aún no tiene permiso de ejecución, concédaselo.

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

Al proporcionar los registros de Atlas BI Connector, la herramienta de informes de preparación podrá informar sobre la siguiente información:

  • Datos históricos de consultas, como volumen y frecuencia.

  • Sintaxis de consulta 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, vaya al clúster de Atlas con la conexión de BI que desea analizar.

  2. Desde las opciones de su clúster ( ), seleccione Download Logs.

  3. Descargar mongosql.gz.

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

4

Al proporcionar la URI de su clúster Atlas, la herramienta de informes de preparación puede analizar sus esquemas de recopilación e identificar 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, vaya al clúster con las colecciones que desea analizar.

  2. Haga clic en Connect.

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

  4. Copie únicamente su 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.

  • Debe --input incluir, --uri o ambos. Si incluye su URI, la herramienta de informes de preparación le solicitará la contraseña de usuario de la base de datos.

  • Puede especificar un destino --output para el informe generado. Si no lo hace, se generará en su 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 a la de Atlas BI Connector y es posible que deba adaptar su esquema o sus consultas.

Para realizar la transición a MongoSQL, identifique las consultas de Atlas BI Connector existentes que fallan en MongoSQL y actualice su esquema o su sintaxis para solucionarlas.

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 Conectarse mediante la interfaz SQL de Atlas.

3

Pruebe sus consultas con su nueva conexión MongoSQL para asegurarse de que se ejecuten y devuelvan los resultados que espera.

Para obtener más información sobre cómo realizar consultas con MongoSQL, consulte Consultas con declaraciones MongoSQL.

4

Para obtener más información sobre los esquemas en MongoSQL, consulte Administració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 obtener más información sobre la sintaxis de consulta de MongoSQL, consulte Referencia del lenguaje MongoSQL.

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

Volver

Habilitar acceso SQL

En esta página