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 lo guía a través de la consulta de datos de muestra.

Instale el siguiente software de cliente para conectarse y consultar sus datos con MongoSQL.

1

DBeaver es una herramienta de base de datos universal y gratuita. Puedes usarla para explorar tus datos de muestra en este tutorial. Descárgala e instálala. DBeaver (Edición Comunitaria).

2
  1. Descargue la última versión del controlador JDBC de MongoDB.

  2. Verifique la integridad del paquete descargado:

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

    1. Ejecute el siguiente comando para descargar el .asc archivo del repositorio central de Maven. Reemplace {version-number} con la versión del controlador {artifact_to_verify} que descargó y con el nombre del archivo que descargó.

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

      Por ejemplo, si descargaste mongodb-jdbc-2.2.3-all.jar, deberás 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. Ejecute el siguiente comando para descargar e importar el archivo de clave. Reemplace {server_url} con uno de los servidores de claves GPG 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 a su directorio actual, deberá ejecutar lo siguiente.

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

      GPG debería 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 recibe el siguiente mensaje de error, confirme que haya importado la clave pública correcta:

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

Para conectarse a su instancia de base de datos federada 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 Federación de datos.

2
3
4

Nota

Este tutorial utiliza el controlador JDBC para la conexión.Consulte "Conectarse mediante la interfaz SQL de Atlas" para conocer otros métodos de conexión.

5

Atlas Data Federation proporciona una cadena de conexión para conectarse a su instancia de base de datos federada. La necesitará más adelante.

6
  1. Inicie DBeaver.

  2. Agregar un nuevo controlador.

    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, ingrese la siguiente información:

      Nombre del conductor

      MongoDB

      Nombre de la clase

      com.mongodb.jdbc.MongoDriver

    4. En la pestaña Libraries, haga clic en Add File y agregue su archivo de controlador JDBC all.jar.

      Haga clic en Find Class.

    5. Haga clic en OK. Se cerrará el modal Create new driver.

  3. Crear una conexión de base de datos.

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

    2. De la lista de bases de datos, seleccione el controlador de base de datos MongoDB que creó 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

      Su cadena de conexión del paso 5.

      Nombre de usuario

      El usuario de MongoDB con el que conectarse.

      Contraseña

      La contraseña del usuario de MongoDB.

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

      database

      El nombre de su base de datos virtual.

      usuario

      El usuario de MongoDB con el que se conectará. No es necesario si ingresó un Username en el paso anterior.

Para obtener más información sobre los diferentes métodos que puede utilizar para conectarse a una instancia de base de datos federada, consulte Conectarse mediante la interfaz SQL de Atlas.

Para ejecutar consultas MongoSQL en DBeaver:

1

El DBeaver Database Navigator muestra sus bases de datos virtuales.

2
  1. Haga clic derecho en la base de datos virtual que desea consultar.

  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 usted seleccionó.

3
4

Si la consulta es exitosa, MongoSQL muestra los resultados en una vista de tabla debajo de la consulta.

Si siguió la guía de configuración avanzada utilizando datos de muestra, intente ejecutar las siguientes consultas MongoSQL contra los datos de muestra en su 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