Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /

Conéctese y consulte datos con herramientas SQL gratuitas

Este tutorial te guía para conectarte a una instancia federada de base de datos usando las herramientas gratuitas MongoDB JDBC Driver y DBeaver (Community Edition).

Si seguiste el Guía de configuración avanzada, este tutorial también te guía a través de la consulta de datos de muestra.

Instale el siguiente software cliente para conectarse a y query sus datos con MongoSQL.

1

DBeaver es una herramienta universal de bases de datos gratuita. Puedes usarlo para explorar tus datos de muestra en este tutorial. Descargar e instalar DBeaver (Edición Comunitaria).

2
  1. Descarga la última versión del MongoDB JDBC Driver.

  2. Verifica la integridad del paquete descargado:

    El equipo de lanzamiento de MongoDB firma digitalmente todos sus paquetes de software para certificar que un paquete específico de MongoDB es una versión válida y sin alterar. MongoDB firma cada rama de lanzamiento con una clave PGP diferente en .asc formato.

    1. Ejecuta el siguiente comando para descargar el archivo .asc desde el Repositorio Central de Maven. Reemplaza {version-number} con la versión del driver que descargaste y {artifact_to_verify} con el nombre del archivo que descargaste.

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/{version-number}/{artifact_to_verify}.asc

      Por ejemplo, si has descargado mongodb-jdbc-2.2.3-all.jar, debes ejecutar el siguiente comando.

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.2.3/mongodb-jdbc-2.2.3-all.jar.asc
    2. Ejecuta el siguiente comando para descargar y luego importar el archivo de clave. Reemplace {server_url} por uno de los servidores de claves GPG actuales compatibles con Maven:

      • keyserver.ubuntu.com

      • keys.openpgp.org

      • pgp.mit.edu

      gpg --keyserver {server_url} --recv-keys BDDC8671F1BE6F4D5464096624A4A8409351E954
      gpg: key BDDC8671F1BE6F4D5464096624A4A8409351E954: public key "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>" imported
      gpg: Total number processed: 1
      gpg: imported: 1
    3. Ejecute el siguiente comando para verificar el archivo de instalación del controlador JDBC de MongoDB. Reemplace detached_signature_file y artifact_to_verify con los nombres de los archivos descargados.

      gpg --verify {detached_signature_file} {artifact_to_verify}

      Por ejemplo, si descargó mongodb-jdbc-2.2.3-all.jar y mongodb-jdbc-2.2.3-all.jar.asc en su directorio actual, ejecute lo siguiente.

      gpg --verify mongodb-jdbc-2.2.3-all.jar.asc mongodb-jdbc-2.2.3-all.jar

      GPG debe devolver una respuesta similar a la siguiente:

      gpg: Signature made Wed May 22 13:24:36 2024 MDT
      gpg: using RSA key BDDC8671F1BE6F4D5464096624A4A8409351E954
      gpg: Good signature from "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>"

      Si el paquete está firmado correctamente, pero aún no confía en la clave de firma en su trustdb local, gpg también devolverá el siguiente mensaje:

      gpg: WARNING: This key is not certified with a trusted signature!
      gpg: There is no indication that the signature belongs to the owner.
      Primary key fingerprint: D2C4 5B7E 66A5 DCA1 8B76 57A8 91A2 1577 3066 6110

      Si recibes el siguiente mensaje de error, verifica que hayas importado la clave pública correcta:

      gpg: Can't check signature: public key not found

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

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto en la Organizations menú en 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:

    Nombre del conductor

    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. Haga clic en OK. Se cerrará el modal 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 ve MongoDB, seleccione 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 su 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.

Para obtener más información sobre los diferentes métodos que se pueden usar para conectarse a una instancia federada de base de datos, consulte Conecte su Herramienta BI.

Para ejecutar consultas MongoSQL en DBeaver:

1

DBeaver Database Navigator muestra tus bases de datos virtuales.

2
  1. Haz clic con el botón derecho en la base de datos virtual a la que deseas hacer una query.

  2. Seleccione SQL Editor.

  3. Seleccione Open SQL console.

    Se abre una nueva ventana de consola SQL conectada a la base de datos virtual que seleccionaste.

3
4

Si la query se realiza correctamente, MongoSQL mostrará los resultados en una vista en tabla debajo de su query.

Si seguiste la guía de Configuración Avanzada utilizando datos de muestra, intenta ejecutar las siguientes consultas MongoSQL contra los datos de muestra en tu instancia de base de datos federada.

De lo contrario, puede modificar estas consultas de ejemplo para sus espacios de nombres.

SELECT *
FROM Sessions

MongoSQL devuelve todos los documentos de la colección Sessions.

SELECT *
FROM Users
LIMIT 2

MongoSQL devuelve dos documentos de la colección Users.

SELECT *
FROM Users
WHERE name = 'Jon Snow'

MongoSQL devuelve documentos de la colección Users donde el name del usuario es Jon Snow.

Para obtener una referencia de comandos de MongoSQL, consulte Referencia del lenguaje MongoSQL.

Volver

Tutoriales de SQL