Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Transición de BI Connector a interfaz SQL

Esta guía cubre migrar tanto del MongoDB Connector for BI como del Atlas BI Connector a la nueva Interfaz SQL.

Importante

El MongoDB Connector para BI y el Atlas BI Connector llegaron al final de su vida útil (EOL) en septiembre de 2026.

Similar al BI Connector, SQL Interface le permite analizar datos de sus implementaciones de MongoDB utilizando una variedad de herramientas basadas en SQL, como Tableau y Power BI.

En comparación con el BI Connector, la interfaz SQL ofrece las siguientes ventajas:

  • Puede conectarse directamente a un clúster dedicado de Atlas, sin necesidad de una instancia federada de base de datos. Esta es la ruta recomendada para la mayoría de las conexiones de Atlas.

  • A través de una instancia federada de base de datos de Atlas, puede leer datos de fuentes distintas de los clústeres de Atlas. Utilice esta ruta cuando una sola query deba abarcar más de una fuente de datos.

  • Los esquemas se conservan por separado y se pueden actualizar sin afectar las capacidades de consulta SQL.

  • Puedes usar conectores personalizados de MongoDB para Tableau y Power BI.

Para comparar las dos rutas de conexión de Atlas, consulte Descripción general de la interfaz SQL de MongoDB.

  • La Interfaz SQL proporciona acceso de solo lectura.

  • MongoSQL es el único dialecto compatible. MongoSQL es compatible con SQL-92. No se admiten otros dialectos de SQL.

  • Si se conecta a través de una instancia federada de base de datos, también se aplican todas las limitaciones de Atlas Data Federation. No se aplican a una conexión directa a un clúster dedicado.

Antes de realizar la transición del BI Connector a la interfaz SQL, confirme que su implementación cumple los requisitos previos para su destino de migración. MongoDB también recomienda que generes un Informe de preparación para la transición que te ayude a planificar tu transición.

Los requisitos previos dependen de a dónde migre. Para comparar los destinos de Atlas, consulte Descripción general de la interfaz SQL de MongoDB.

  • Atlas clúster dedicado: un usuario de base de datos MongoDB con el que conectarse. Para habilitar la interfaz SQL, también necesita un Atlas user con el rol de Project Cluster Manager o Project Replica Set Manager.

  • Instancia federada de base de datos de Atlas: una instancia federada de base de datos que contiene datos consultables y un usuario de base de datos de MongoDB con el que conectarse.

  • Implementación de Enterprise Advanced (EA) autogestionada: un usuario de base de datos de MongoDB con los privilegios de base de datos necesarios. No se requiere ningún rol de Proyecto Atlas.

MongoDB proporciona una herramienta de preparación para la transición a MongoSQL para ayudarle a planificar su traslado desde el BI Connector a la interfaz SQL. La herramienta genera un informe basado en su uso anterior de BI Connector, proporcionando análisis y sugerencias de esquema en tiempo real y destacando las query que necesitan cambios de sintaxis para ejecutarse correctamente con MongoSQL.

Para generar un informe, debe proporcionar a la herramienta al menos uno de los siguientes detalles:

  • Los registros de su BI Connector, para el análisis de query.

  • Tu URI de clúster, para el 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>
3

Al proporcionar sus registros de BI Connector, permite que la herramienta de informe de preparación informe 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 el BI Connector on-premises, los registros están dondequiera que haya configurado la ruta de registro mongosqld.

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. Desde las opciones del clúster (), selecciona Download Logs.

  3. Descargar mongosql.gz.

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

4

Proporcionar tu URI del clúster de Atlas permite que la Herramienta de Informe de Preparación 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 tu clúster de Atlas:

  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.

    El URI de conexión se parece a: mongodb+srv://bicluster.example.mongodb.net/. Excluya el ejecutable de shell, mongosh, y cualquier opción de línea de comandos específica de shell.

5

En una terminal, ejecuta la herramienta inform de preparación, proporcionando tus registros descargados o el URI de tu clúster.

  • Debes incluir el nombre de usuario de tu 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 DNS resolver para las solicitud de red. Los valores posibles son cloudflare, google y quad9.

  • Puedes usar --include o --exclude para 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> --helpOptions: -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.

La arquitectura subyacente de la interfaz SQL es diferente del BI Connector y es posible que deba adaptar su esquema o sus query.

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

Advertencia

Recomendamos probar el proceso de transición completo en un entorno de pruebas antes de realizar cambios en su entorno de producción. La transición del BI Connector a la interfaz SQL sin adaptar su esquema o sus query podría causar cambios disruptivos.

1

Para la mayoría de las implementaciones de Atlas, habilite la Interfaz SQL directamente en un clúster dedicado. Este es el destino de migración recomendado y no necesita una instancia federada de base de datos. En su lugar, utilice una instancia federada de base de datos cuando una sola query SQL deba abarcar más de una fuente de datos.

Para obtener más información sobre cómo habilitar y usar la interfaz SQL, consulte Configurar el servidor de la interfaz SQL.

2

Para aprender más sobre cómo conectarse con la interfaz SQL, consulte Conecte su herramienta SQL a MongoDB.

3

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

Para obtener más información sobre cómo consultar con MongoSQL, consulta Query con instrucciones MongoSQL.

4

Para aprender más sobre los esquemas en la interfaz SQL, consulte Gestión de esquemas.

5

Algunas sintaxis de query podría necesitar cambiarse cuando haga la transición de BI Connector a la interfaz SQL.

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 su configuración de interfaz SQL: