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 software cliente
Instale el siguiente software cliente para conectarse a y query sus datos con MongoSQL.
Instalar DBeaver
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).
Instalar el controlador JDBC
Descarga la última versión del MongoDB JDBC Driver.
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
.ascformato.Ejecuta el siguiente comando para descargar el archivo
.ascdesde 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 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.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.ascen 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
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 recibes el siguiente mensaje de error, verifica que hayas 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 federada de base de datos desde DBeaver:
En Atlas, ve a tu instancia federada de base de datos para tu 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 Data Federation.
Abra su DBeaver aplicación.
Agrega un controlador a DBeaver.
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, especifique la siguiente información:
Nombre del conductor
MongoSQLNombre de la clase
com.mongodb.jdbc.MongoDriverEn la pestaña Libraries, haz clic en Add File y añade tu archivo de controlador JDBC
all.jar.Haga clic en Find Class.
Haga clic en OK. Se cerrará el modal Create new driver.
Crea una conexión de base de datos.
En DBeaver, haz clic en Database y selecciona New Database Connection del menú desplegable para abrir el modal Connect to a database.
De la lista de bases de datos, selecciona el controlador de base de datos
MongoDBque creaste 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
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.
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
Usernameen 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.
Ejecutar consultas de MongoSQL
Para ejecutar consultas MongoSQL en DBeaver:
Ejemplo MongoSQLQueries
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.
Instrucción 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.
Instrucció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.