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.
Docs Menu
Docs Home
/
Herramientas
/
Interfaz SQL
Docs Home
/
Herramientas
/
Interfaz SQL
Docs Home
/
Herramientas
/
Interfaz SQL

Transición del conector BI a la interfaz SQL

Esta guía abarca la migración desde el conector MongoDB para BI y el conector Atlas BI a la interfaz SQL más reciente.

Importante

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

Interfaz SQL

Al igual que el conector BI, la interfaz SQL le permite analizar datos de sus implementaciones de MongoDB utilizando diversas herramientas basadas en SQL, como Tableau y Power BI.

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

  • Puedes conectarte directamente a un clúster dedicado de Atlas, sin necesidad de una instancia de base de datos federada. Esta es la opción recomendada para la mayoría de las conexiones a Atlas.

  • Mediante una instancia de base de datos federada de Atlas, puede leer datos de fuentes distintas a los clústeres de Atlas. Utilice esta opción cuando una sola consulta deba abarcar más de una fuente de datos.

  • Los esquemas se almacenan por separado y se pueden actualizar sin interrumpir 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 la descripción general de la interfaz SQL de MongoDB.

Limitaciones de la interfaz SQL

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

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

Prepárese para la transición a la interfaz SQL.

Antes de migrar del conector BI a la interfaz SQL, confirme que su implementación cumple con los requisitos previos para su destino de migración. MongoDB también recomienda generar un informe de preparación para la transición que le ayude a planificarla.

Requisitos previos

Los requisitos previos dependen del destino de la migración. Para comparar los destinos de Atlas, consulte la descripción general de la interfaz SQL de MongoDB.

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

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

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

Generar un informe de preparación para la transición

MongoDB ofrece una herramienta de preparación para la transición a MongoSQL que le ayudará a planificar su migración del conector BI a la interfaz SQL. Esta herramienta genera un informe basado en su uso anterior del conector BI, proporcionando análisis de esquema y sugerencias en tiempo real, y resaltando 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:

  • Registros de su conector BI, para análisis de consultas.

  • Tu URI de clúster, para el análisis de esquemas.

Puedes analizar tus consultas, tu esquema o ambos.

1

Descargar la herramienta de informe de preparación de MongoSQL.

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

2

Conceder permiso de ejecución a la herramienta de reporte de preparación.

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

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

(Opcional) Descargue y descomprima los registros de su conector BI.

Proporcionar los registros de BI Connector permite que la herramienta de informe de preparación genere informes 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 conector BI local, los registros se encuentran 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

(Opcional) Copia la URI de tu clúster.

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

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

5

Generar un informe.

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.

  • Puedes especificar un --resolver para elegir un resolvedor DNS para las solicitudes 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> --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 la interfaz SQL

La arquitectura subyacente de la interfaz SQL es diferente a la del conector BI, por lo que es posible que deba adaptar su esquema o sus consultas.

Para migrar a la interfaz SQL, identifique las consultas existentes del conector BI que fallan en MongoSQL y actualice su esquema o su sintaxis para solucionarlo.

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 conector BI a la interfaz SQL sin adaptar su esquema o sus consultas podría provocar cambios incompatibles.

1

Habilite la interfaz SQL en su clúster Atlas.

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 requiere una instancia de base de datos federada. Utilice una instancia de base de datos federada cuando una sola consulta SQL deba abarcar más de un origen de datos.

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

2

Conéctese a sus datos con la interfaz SQL.

Para obtener más información sobre cómo conectarse mediante la interfaz SQL, consulte Conectar su herramienta SQL a MongoDB.

3

Prueba tus consultas.

Pruebe sus consultas con su nueva conexión de interfaz SQL para asegurarse de que se ejecutan correctamente y devuelven los resultados esperados.

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

4

Consulta tu esquema y adáptalo si es necesario.

Para obtener más información sobre los esquemas en la interfaz SQL, consulte la sección Administración de esquemas.

5

Adapta cualquier query que esté fallando.

Es posible que sea necesario modificar la sintaxis de algunas consultas al pasar del conector BI a la interfaz SQL.

Para aprender más sobre la sintaxis de la query MongoSQL, consulta la Referencia del lenguaje MongoSQL.

Solucionar problemas de la interfaz SQL

Los siguientes recursos de MongoDB pueden ayudarle a solucionar problemas de configuración de su interfaz SQL:

Volver
Overview
Next
Instalar
Califique esta página

En esta página