SQL接口驱动程序设置

下载 MongoDB JDBC 驱动程序。

从 MongoDB下载中心。 下载最新的 JDBC 驱动程序。

将jar 文件移至操作系统的相应目录。

将 jar 文件复制到 BI 工具的相应目录中。示例，如果您要安装Tableau的JDBC驱动程序：

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

• macOS： ~/Library/Tableau/Drivers

• Linux: /opt/tableau/tableau_driver/jdbc

验证下载包的完整性。

MongoDB 发布团队对所有软件包进行数字签名，证明特定的 MongoDB 包是有效且未经更改的 MongoDB 版本。MongoDB 使用格式为 .asc 的不同 PGP 密钥对每个发布分支进行签名。

1. 运行以下命令从 Maven 中央存储库下载 .asc 文件。将 <versionNumber> 替换为您下载的驱动程序版本，并将 <artifactToVerify> 替换为您下载的文件名。

   curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/<versionNumber>/<artifactToVerify>.asc

   例如，如果下载了 mongodb-jdbc-2.2.3-all.jar，您将运行以下命令。

   curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.2.3/mongodb-jdbc-2.2.3-all.jar.asc

2. 运行以下命令，下载并导入密钥文件。将 <serverUrl> 替换为 Maven 支持的当前 GPG 密钥服务器之一：

   • keyserver.ubuntu.com

   • keys.openpgp.org

   • pgp.mit.edu

   gpg --keyserver <serverUrl> --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. 运行以下命令以验证MongoDB JDBC 驱动程序安装文件。将 <detachedSignatureFile> 和 <artifactToVerify> 替换为您下载的文件的名称。

   gpg --verify <detachedSignatureFile> <artifactToVerify>

   例如，如果您将 mongodb-jdbc-2.2.3-all.jar 和 mongodb-jdbc-2.2.3-all.jar.asc 下载到当前目录，则可以运行以下命令。

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

   GPG 应返回类似于以下内容的响应：

   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>"

   如果包已正确签名，但目前不信任本地 trustdb 中的签名密钥，则 gpg 还将返回以下消息：

   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

   如果收到以下错误消息，请确认已导入正确的公钥：

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

为 Maven 应用程序配置驱动程序。

从 Maven 中央存储库复制依赖项片段。编辑依赖项片段中的版本号以匹配 JDBC驱动程序版本。

例如：

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

将依赖项添加到 Maven 项目。

在您项目的 pom.xml 文件中，将代码片段粘贴到依赖项列表中，如下所示：

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

连接到您的联合数据库实例。

要连接到联合数据库实例，请创建连接字符串并从应用程序打开连接。JDBC 驱动程序的连接字符串遵循标准MongoDB连接字符串的格式，但带有 jdbc: 前缀：

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

要从 Atlas 用户界面获取连接字符串，请执行以下操作：

1. 在 Atlas UI 中，转到 Data Federation 页面，然后单击要连接的联合数据库实例的 Connect 。

2. 在 Access your data through tools 下，选择 Atlas SQL 。

3. 在 Select your driver 下拉菜单中选择 JDBC Driver。

4. 在 Get Connection String 下，选择要连接的数据库并复制连接字符串。

以下示例演示了如何打开连接。除了连接字符串之外，还必须通过 Properties对象参数指定要使用的数据库。 要学习；了解更多信息，请参阅连接字符串和连接属性。

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