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 software cliente
Instale el siguiente software de cliente para conectarse y consultar sus datos con MongoSQL.
Instalar DBeaver
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).
Instalar el controlador JDBC
Descargue la última versión del controlador JDBC de MongoDB.
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.
.ascformato.Ejecute el siguiente comando para descargar el
.ascarchivo 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 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.comkeys.openpgp.orgpgp.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 Ejecute el siguiente comando para verificar el archivo de instalación del controlador JDBC de MongoDB. Reemplace
detached_signature_fileyartifact_to_verifycon los nombres de los archivos descargados.gpg --verify {detached_signature_file} {artifact_to_verify} Por ejemplo, si descargó
mongodb-jdbc-2.2.3-all.jarymongodb-jdbc-2.2.3-all.jar.asca 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
trustdblocal,gpgtambié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
Conecta a tu instancia de base de datos federada
Para conectarse a su instancia de base de datos federada desde DBeaver:
En Atlas, vaya a la instancia de base de datos federada para su proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto en la Organizations Menú en la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Data Federation en la sección Services.
Se muestra la página Federación de datos.
Seleccione JDBC Driver.
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.
Conectarse desde DBeaver.
Inicie DBeaver.
Agregar un nuevo controlador.
En DBeaver, haz clic en Database y selecciona Driver Manager en el menú desplegable.
Haz clic en New para abrir el modal Create new driver.
En la pestaña Settings, ingrese la siguiente información:
Nombre del conductor
MongoDBNombre de la clase
com.mongodb.jdbc.MongoDriverEn la pestaña Libraries, haga clic en Add File y agregue su archivo de controlador JDBC
all.jar.Haga clic en Find Class.
Haga clic en OK. Se cerrará el modal Create new driver.
Crear una conexión de base de datos.
En DBeaver, haga clic en Database y seleccione New Database Connection en el menú desplegable para abrir el modal Connect to a database.
De la lista de bases de datos, seleccione el controlador de base de datos
MongoDBque creó en el paso anterior.Si no ve
MongoDB, seleccione la categoría All dentro del modal.Haga clic en Next.
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.
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
Usernameen 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.
Ejecutar consultas MongoSQL
Para ejecutar consultas MongoSQL en DBeaver:
Ejemplos de consultas MongoSQL
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.
Sentencia SELECT
SELECT * FROM Sessions
MongoSQL devuelve todos los documentos de la colección Sessions.
Declaración LIMIT
SELECT * FROM Users LIMIT 2
MongoSQL devuelve dos documentos de la colección Users.
Declaración WHERE
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.