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.
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Docs Menu
Docs Home
/ /
Instalar
Docs Home
/
Herramientas
/
Interfaz SQL
/
Instalar
Docs Home
/
Herramientas
/
Interfaz SQL
/
Instalar

Conecta tu 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, versiones 2025 y posteriores, incluyen el conector de Tableau para MongoDB. Si su versión de Tableau ya incluye el conector, omita este paso. Para usar una versión diferente a la que viene 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. Descarga el archivo taco más reciente del Connector 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. Acceda a su clúster dedicado de Atlas o a la instancia de base de datos federada correspondiente a su 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.

Utilice una cadena de conexión compatible con el controlador Java de MongoDB. Para obtener más información, consulte URI de conexión.

3

Abra Tableau Desktop o Tableau Server.

4

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

Introduzca la siguiente cadena de conexión:

mongodb://localhost:<port>/?authSource=admin

Reemplace <port> con el número de puerto configurado para que el servidor de interfaz SQL escuche.

El parámetro authSource especifica la base de datos utilizada para autenticar al usuario de MongoDB. Si omite authSource, se utilizará la base de datos especificada en el campo Database para la autenticación.

En el campo Database, introduzca el nombre de la base de datos MongoDB que desea consultar.

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.

Configura tu certificado PEM utilizando uno de los siguientes métodos:

  • Utiliza una ruta de archivo PEM:

    En tu archivo mongodb_jdbc.properties, establece la propiedad x509pempath en la ruta de tu archivo PEM. Se puede mencionar, por ejemplo, x509pempath=/certs/client-cert.pem.

    • Si tu archivo PEM no está cifrado, no selecciones Provide PEM Contents. No se requiere ningún tipo de acción adicional.

    • Si tu archivo PEM está cifrado, selecciona Provide PEM Contents e ingresa la frase de contraseña del archivo en el campo Password.

  • Proporcione los contenidos PEM:

    Selecciona la casilla de verificación junto a Provide PEM Contents e introduce los datos de tu certificado en el campo Password:

    • Contenido sin cifrar: Pegue el contenido completo del certificado directamente en el campo.

    • Contenido Cifrado: Pegue un objeto JSON que contenga el contenido y la contraseña:

      { "pem": "<PEM-CONTENT>", "passphrase": "<PEM-PASSPHRASE>" }

Introduce el nombre principal de Kerberos en el campo Username. Por ejemplo, user@EXAMPLE.COM.

No se requieren propiedades ni campos adicionales en el cuadro de diálogo de conexión para OIDC.

8

Haga 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 detalle de los registros del controlador. Acepta los siguientes valores, en orden creciente de detalle: OFF, SEVERE, WARNING, INFO, FINE y FINER. El valor predeterminado es 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. Aumente el nivel solo cuando sea necesario diagnosticar un problema, ya que cada nivel añade una gran cantidad de información. En el nivel FINER, el controlador registra cada llamada que recupera datos para cada celda de cada conjunto de resultados.

Para obtener más información sobre los archivos de propiedades en Tableau, consulta 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. Acceda a su clúster dedicado de Atlas o a la instancia de base de datos federada correspondiente a su 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.

Utilice su URI de implementación de MongoDB. Para obtener más información, consulte Cadenas de conexión.

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.

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

    En el campo Native query, puede introducir opcionalmente una consulta SQL. Power BI utiliza la consulta SQL como fuente directa de datos. También puede añadir o modificar la consulta SQL en el editor de Power Query tras 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.

La consulta directa es una alternativa al modo de importación estándar y permite consultar la base de datos directamente. Esto garantiza datos actualizados, pero puede tardar más en mostrar los 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. Acceda a su clúster dedicado de Atlas o a la instancia de base de datos federada correspondiente a su 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.

Utilice una cadena de conexión compatible con el controlador Java de MongoDB. Para obtener más información, consulte URI de conexión.

2

Abra su DBeaver aplicación.

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 conectar su herramienta SQL a su base de datos MongoDB, podrá consultar sus datos. Para obtener más información, consulte:

Nota

Para conectarse mediante un punto final privado, consulte Conectarse a la interfaz SQL de MongoDB con un punto final privado.

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

En esta página