Configuración del controlador de la interfaz SQL

Descarga el controlador JDBC de MongoDB.

Descargue el último controlador JDBC del centro de descargas de MongoDB.

Desplazar el archivo jar al directorio apropiado para tu sistema operativo.

Copia el archivo jar en el directorio correspondiente de tu herramienta de BI. Por ejemplo, si está instalando el controlador JDBC para Tableau:

• Windows: C:\Program Files\Tableau\Drivers

• macOS: ~/Library/Tableau/Drivers

• Linux: /opt/tableau/tableau_driver/jdbc

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 y sin alteraciones de MongoDB. MongoDB firma cada rama de lanzamiento con una clave PGP diferente en formato .asc.

1. Ejecuta el siguiente comando para descargar el archivo .asc desde el Repositorio Central de Maven. Reemplaza <versionNumber> con la versión del driver que descargaste y <artifactToVerify> con el nombre del archivo que descargaste.

   curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/<versionNumber>/<artifactToVerify>.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 <serverUrl> por uno de los servidores de claves GPG actuales compatibles con Maven:

   • keyserver.ubuntu.com

   • keys.openpgp.org

   • pgp.mit.edu

   gpg --keyserver <serverUrl> --recv-keys BDDC8671F1BE6F4D5464096624A4A8409351E954

   OCULTAR SALIDA

   gpg: key BDDC8671F1BE6F4D5464096624A4A8409351E954: public key "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1

3. Ejecuta el siguiente comando para verificar el archivo de instalación del driver MongoDB JDBC. Reemplaza <detachedSignatureFile> y <artifactToVerify> con los nombres de los archivos que descargaste.

   gpg --verify <detachedSignatureFile> <artifactToVerify>

   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ías en la clave de firma en tu trustdb local, gpg también mostrará 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

Configure el controlador para su aplicación Maven.

Copia el snippet de dependencia del Maven Central Repository. Edita el número de versión en el snippet de dependencia para que coincida con la versión de tu JDBC driver.

Por ejemplo:

<dependency>
   <groupId>org.mongodb</groupId>
   <artifactId>mongodb-jdbc</artifactId>
   <version>2.1.0</version>
</dependency>

Agrega la dependencia a tu proyecto Maven.

En el archivo pom.xml de tu proyecto, pega el snippet en la lista de dependencias como sigue:

<dependencies>
  <dependency>
      <groupId>org.mongodb</groupId>
      <artifactId>mongodb-jdbc</artifactId>
      <version>2.1.0</version>
  </dependency>
</dependencies>

Conéctate a tu instancia federada de base de datos.

Para conectarse a su instancia federada de base de datos, cree una cadena de conexión y abra una conexión desde su aplicación. La cadena de conexión para el controlador JDBC sigue el formato estándar de MongoDB, excepto con el prefijo jdbc::

jdbc:mongodb://[username:password]@[host].a.query.mongodb.net/<databaseName>[?option1=value1[&option2=value2]...]

Para obtener la cadena de conexión desde la interfaz de usuario de Atlas, haz lo siguiente:

1. En la interfaz de usuario Atlas, ve al Data Federation página y haga clic en Connect para la instancia federada de base de datos a la que desea conectarse.

2. En Access your data through tools, selecciona Atlas SQL.

3. En Select your driver, selecciona JDBC Driver en el menú desplegable.

4. En Get Connection String, selecciona la base de datos a la que deseas conectarte y copia la cadena de conexión.

El siguiente ejemplo demuestra cómo abrir una conexión. Además de la cadena de conexión, debe especificar también la base de datos a usar a través de un parámetro objeto Properties. Para aprender más, consulta Cadenas de Conexión y Propiedades de Conexión.

java.util.Properties p = new java.util.Properties();
p.setProperty("database", "<databaseName>");
Connection conn = DriverManager.getConnection("<connectionString>", p);