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

Conecte su herramienta SQL a MongoDB

Conecte su herramienta SQL, como Tableau, Power BI o DBeaver, a su base de datos MongoDB Atlas o Enterprise Advanced (EA).

Las tres opciones de implementación de la interfaz SQL utilizan los mismos controladores JDBC y ODBC, por lo que los pasos de esta página son los mismos tanto si se conecta a un clúster dedicado de Atlas, a una instancia de base de datos federada de Atlas o a una implementación Enterprise Advanced (EA) autogestionada. Primero, configure su implementación para que acepte conexiones SQL. Para obtener más información, consulte Configuración del servidor de la interfaz SQL.

Nota

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

Conectar Tableau

Conecte un clúster dedicado de Atlas, una instancia de base de datos federada de Atlas o una base de datos Enterprise Advanced (EA) autohospedada a Tableau (Desktop o Server) mediante el conector de Tableau para MongoDB.

Requisitos previos

Procedimiento

Los siguientes pasos muestran cómo conectarse a MongoDB con Tableau:

1

Descarga el Connector Tableau para MongoDB.

Nota

Tableau Desktop y Tableau Server versión 2025 y posteriores incluyen el Tableau Connector para MongoDB. Si su versión de Tableau ya incluye el conector, omita este paso. Para usar una versión diferente a la que se incluye con Tableau, complete este paso.

Para Tableau Desktop, también puede instalar el conector desde Tableau. Busque MongoDB SQL interface by MongoDB en Tableau Exchange y, a continuación, haga clic en Install and restart Tableau.

  1. Descargue el archivo taco más reciente del conector de Tableau desde el centro de descargas de MongoDB.

  2. Mueve el archivo taco al directorio apropiado para tu sistema operativo:

    • Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors

    • MacOS: ~/Documents/My Tableau Repository/Connectors

    • Linux: /opt/tableau/connectors

Importante

Si descarga una nueva versión del Tableau Connector para MongoDB, borre el archivo anterior taco de su directorio Connectors para asegurar que Tableau utilice la última versión.

2

Obtenga la información de conexión de la base de datos MongoDB.

Seleccione la pestaña para su tipo de implementación para obtener instrucciones sobre cómo obtener su información de conexión:

  1. Ve a tu clúster dedicado de Atlas o a la instancia federada de base de datos de Atlas para tu proyecto.

  2. Haga clic en Connect.

  3. Seleccione la opción Atlas SQL Interface.

  4. Selecciona la opción Tableau Connector en el menú desplegable Select your driver.

  5. Selecciona Tableau del menú desplegable.

  6. Selecciona la base de datos a la que deseas conectarte desde la lista desplegable Database.

  7. Copia tu cadena de conexión y los parámetros de conexión.

    Utiliza esta información para conectarte con Tableau en un paso posterior.

3

Abra Tableau Desktop o Tableau Server.

4

Ve al menú Connect.

5

Seleccione MongoDB SQL Interface by MongoDB.

Se muestra un modal de conexión.

6

Ingresa la información de conexión a tu base de datos:

Introduce tu cadena de conexión de Interfaz SQL que guardaste en un paso anterior.

7

Selecciona tu método de autenticación.

Elije tu Authentication Mechanism en el desplegable.

Para obtener información sobre todos los mecanismos de autenticación compatibles, consulta Autenticación de la Interfaz SQL.

  • UsernameIngresa tu nombre de usuario de MongoDB.

  • Password: Ingresa tu contraseña de MongoDB.

8

Haz clic en Sign In.

Configurar el registro de Tableau

Para cambiar la configuración de registro del controlador JDBC de MongoDB, agregue propiedades de registro al archivo mongodb_jdbc.properties. La ubicación de este archivo depende de su plataforma:

Plataforma
ruta

macOS

~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties
~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties

Windows

C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties
C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties

Tableau servidor (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

Copie este archivo a todos los nodos del servidor.

Para configurar el registro, añada las siguientes propiedades al archivo:

loglevel=INFO
logdir=<path-to-log-directory>

La propiedad loglevel establece el nivel de verbosidad del registro del driver. Acepta los siguientes valores, en orden de nivel de verbosidad creciente: OFF, SEVERE, WARNING, INFO, FINE y FINER. El valor es por defecto OFF.

La propiedad logdir establece el directorio donde el driver guarda las entradas de registro. El directorio debe existir previamente. Si omite logdir o lo establece en console, el driver guarda los registros en la consola en lugar de en un archivo.

Importante

En entornos de producción, comience con el nivel de registro SEVERE. Suba el nivel solo cuando deba diagnosticar un problema, porque cada nivel añade una gran cantidad de salida. En el nivel FINER, el driver registro cada llamar que recupera datos para cada celda de cada conjunto de resultados.

Para obtener más información sobre los archivos de propiedades en Tableau, consulte la documentación de Tableau.

Conectar Power BI

Conecte un clúster dedicado de Atlas, una instancia de base de datos federada de Atlas o una base de datos Enterprise Advanced (EA) autohospedada a Power BI mediante el conector de Power BI para MongoDB.

Requisitos previos

Procedimiento

Los siguientes pasos muestran cómo conectarse a MongoDB con Power BI:

1

Descarga el Power BI Connector para MongoDB.

  1. Descargue el último archivo de Power BI Connector pqx desde el centro de descargas de MongoDB.

    Nota

    El BI Connector para MongoDB se entrega con Power BI Desktop. Si la versión de Power BI Desktop que tienes ya cuenta con el conector SQL de MongoDB Atlas, omite este paso. Para usar una versión diferente de la que viene incluida con Power BI Desktop, completa este paso.

  2. Mueve el archivo del conector a la siguiente ruta de directorio:

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    Crea esta carpeta si aún no existe.

2

Obtenga la información de conexión de la base de datos MongoDB.

Seleccione la pestaña para su tipo de implementación para obtener instrucciones sobre cómo obtener su información de conexión:

  1. Ve a tu clúster dedicado de Atlas o a la instancia federada de base de datos de Atlas para tu proyecto.

  2. Haga clic en el botón Connect.

  3. Seleccione la opción Atlas SQL Interface.

  4. Selecciona la opción Power BI Connector en el menú desplegable Select your driver.

  5. Copie su cadena de conexión.

    Utilice esta información para conectarse con Power BI en un paso posterior.

3

Conectar desde Power BI Desktop.

  1. Abre Power BI Desktop.

  2. Selecciona Get data en el menú Home.

  3. Busque y seleccione el conector MongoDB Atlas SQL.

    1. Escribe mongo en la barra de búsqueda para encontrar el nuevo conector.

    2. Seleccione MongoDB Atlas SQL.

    3. Haga clic en Connect.

  4. Introduce la URI y el nombre de la base de datos, y haz clic en OK.

    El MongoDB URI es la cadena de conexión que copiaste en un paso anterior.

    En el campo Native query, puede introducir opcionalmente una query SQL. Power BI utiliza la query SQL como fuente directa de los datos. También puede agregar o cambiar la query SQL en el editor de Power Query después de conectarse.

  5. Introduzca su Atlas User name y Password y haga clic en Connect.

    De forma predeterminada, los usuarios pueden acceder a todos los espacios de nombres que permitan sus roles y URI de conexión. Si utiliza roles personalizados para restringir el acceso, puede otorgar a los usuarios acceso a espacios de nombres adicionales en el menú Edit User. Para obtener más información, consulte Configurar usuarios de la base de datos.

    Para obtener información sobre otros mecanismos de autenticación compatibles, consulta Autenticación de Interfaz SQL.

query directo

La consulta directa es un modo de conexión disponible con el conector de Power BI para MongoDB versión 1.2 y posteriores. Para usar la consulta directa, debe instalar el controlador ODBC de MongoDB versión 1.2 o posterior. No es necesario configurar un DSN.

El query directo es una alternativa a la moda de importación estándar y le permite consultar su base de datos directamente. Esto garantiza datos actualizados, pero puede tardar más en devolver resultados.

Query directo no admite algunas acciones. Si se intenta realizar una acción no compatible, Power BI pide que se cambie a Import Moda.

Conectar DBeaver

Conecte su clúster dedicado de Atlas, su instancia de base de datos federada de Atlas o su implementación autogestionada de Enterprise Advanced (EA) a DBeaver mediante el controlador JDBC de MongoDB.

Requisitos previos

Procedimiento

Para conectarse desde DBeaver:

1

Obtenga la información de conexión de la base de datos MongoDB.

Seleccione la pestaña para su tipo de implementación para obtener instrucciones sobre cómo obtener su información de conexión:

  1. Ve a tu clúster dedicado de Atlas o a la instancia federada de base de datos de Atlas para tu proyecto.

  2. Haga clic en el botón Connect.

  3. Seleccione la opción Atlas SQL Interface.

  4. Selecciona la opción JDBC Driver en el menú desplegable Select your driver.

  5. Selecciona la base de datos a la que deseas conectarte desde la lista desplegable Database.

  6. Copie su cadena de conexión.

    Utilice esta información para conectarse con DBeaver en un paso posterior.

2

Abra su aplicación DBeaver.

3

Agrega un controlador a DBeaver.

  1. En DBeaver, haz clic en Database y selecciona Driver Manager en el menú desplegable.

  2. Haz clic en New para abrir el modal Create new driver.

  3. En la pestaña Settings, especifique la siguiente información:

    Driver Name

    MongoSQL

    Nombre de la clase

    com.mongodb.jdbc.MongoDriver

  4. En la pestaña Libraries, haz clic en Add File y añade tu archivo de controlador JDBC all.jar.

    Haga clic en Find Class.

  5. Haz clic en OK. Se cierra el modal de Create new driver.

4

Crea una conexión de base de datos.

  1. En DBeaver, haz clic en Database y selecciona New Database Connection del menú desplegable para abrir el modal Connect to a database.

  2. De la lista de bases de datos, selecciona el controlador de base de datos MongoDB que creaste en el paso anterior.

    Si no ves MongoDB, selecciona la categoría All dentro del modal.

    Haga clic en Next.

  3. En la pestaña Main, ingrese la siguiente información:

    JDBC URL

    Cadena de conexión obtenida de un paso anterior.

    Nombre de usuario

    Usuario de MongoDB autorizado para la conexión.

    Contraseña

    Contraseña asociada con el usuario de MongoDB.

  4. En la pestaña Driver properties, expanda User Properties. Agregar las siguientes propiedades clave-valor:

    database

    El nombre de tu base de datos virtual.

    usuario

    El usuario de MongoDB con el que se conecta. No se requiere si ingresó un Username en el paso anterior.

Próximos pasos

Después de que conectes tu herramienta SQL a tu base de datos MongoDB, puedes query tus datos. Para aprender más, consulta:

Nota

Para conectarse utilizando nodos privados, consulte Conéctese a la interfaz SQL de MongoDB con nodos privados.

Volver
Configuración del controlador
Next
Query
Califique esta página

En esta página