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

Conecte su herramienta de BI

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

Nota

MongoDB ofrece soporte oficial para Tableau (versión de escritorio o servidor) y Power BI Desktop (versión de escritorio y servicio) mediante sus controladores JDBC y ODBC. Si bien puede usar estos controladores con otras herramientas92 de BI basadas en SQL, MongoDB no garantiza la compatibilidad. Pruebe las características específicas de su interfaz SQL para confirmar la compatibilidad.

Conecte una instancia de base de datos federada de Atlas o una base de datos Enterprise Advanced (EA) autoalojada a Tableau (Desktop o Server) usando el Connector de Tableau para MongoDB.

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

1
  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

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 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 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 su cadena de conexión mongosh para.

3
4
5

Se muestra un modal de conexión.

6

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

7

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

Para cambiar la configuración de registro del controlador JDBC de MongoDB, agregue propiedades de mongodb_jdbc.properties registro al archivo. 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 Server (RHEL)

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

Copie este archivo en todos los nodos del servidor.

Para configurar el registro, agregue 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 define el directorio donde el controlador escribe los archivos de registro. Este directorio debe existir previamente. Si omite logdir o lo establece en console, el controlador escribirá 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, consulte la documentación de Tableau.

Conecta una instancia federada de base de datos de Atlas o una base de datos Enterprise Advanced (EA) autohospedada a Power BI usando el Conector para MongoDB de Power BI.

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

1
  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
  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 URL del paso anterior.

    También puedes introducir una consulta SQL en el campo Native query. Power BI utiliza la query SQL como la fuente directa para los datos.

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

    Por defecto, un usuario puede acceder a todos los clústeres e instancias federadas de base de datos en los proyectos a los que tiene acceso. Si ha restringido el acceso a clústeres específicos y a instancias federadas de base de datos, puedes conceder acceso a la nueva instancia federada de base de datos en el menú Edit User. Para obtener más información, consulte Configurar usuarios de bases de datos.

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

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 1 versión.2 o posterior.

El Query directo es una alternativa a la moda de importación estándar y te permite consultar query tu base de datos directamente. Esto garantiza datos actualizados, pero puede tardar más en mostrar 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.

Conecta tu instancia de base de datos federada de Atlas a DBeaver usando el controlador JDBC de MongoDB.

Para conectarse a su instancia federada de base de datos desde DBeaver:

1
  1. Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Data Federation en la sección Services.

Se muestra la página Data Federation.

2
3
4
5

Atlas Data Federation proporciona una cadena de conexión para conectarse a la instancia federada de base de datos. La vas a necesitar en un paso posterior.

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

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

Después de conectar tu herramienta BI con tu base de datos MongoDB, puedes query tus datos. Para obtener más información, consulta:

Nota

Para conectar utilizando un nodo privado, consulta Conectar a MongoSQL con un nodo privado. Para conectar utilizando el MongoDB Shell, consulta Conectar desde el MongoDB Shell.