使用免费 SQL 工具连接和查询数据

安装 DBeaver

DBeaver 是一个免费的通用数据库工具。您可以使用它来探索本教程中的示例数据。下载并安装 DBeaver（社区版）。

安装 JDBC 驱动程序

1. 下载最新的 MongoDB JDBC 驱动程序版本。

2. 验证下载包的完整性：

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

   1. 运行以下命令从 Maven 中央存储库下载 .asc 文件。将 {version-number} 替换为您下载的驱动程序版本，并将 {artifact_to_verify} 替换为您下载的文件名。

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/{version-number}/{artifact_to_verify}.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. 运行以下命令，下载并导入密钥文件。将 {server_url} 替换为 Maven 支持的当前 GPG 密钥服务器之一：

      • 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. 运行以下命令，验证 MongoDB JDBC 驱动程序安装文件。将 detached_signature_file 和 artifact_to_verify 替换为您下载的文件名。

      gpg --verify {detached_signature_file} {artifact_to_verify}

      例如，如果您将 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

在 Atlas 中，转到项目的联合数据库实例。

1. 如果尚未显示，请选择包含您的项目的组织导航栏中的 Organizations菜单。

2. 如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。

3. 在侧边栏中，单击 Services 标题下的 Data Federation。

显示Data Federation 页面。

单击 Connect（连接）以打开联合数据库实例连接模态窗口。

选择 MongoSQL（Atlas SQL）。

选择 JDBC Driver（Atlas SQL）。

保存您的连接信息。

Atlas Data Federation 提供了连接字符串来连接到您的联合数据库实例。您将在稍后的步骤中用到它。

从 DBeaver 连接。

1. 启动 DBeaver。

2. 添加新的驱动程序。

   1. 在 DBeaver 中，单击 Database（数据库），然后从下拉菜单中选择 Driver Manager（驱动程序管理器）。

   2. 单击 New 打开 Create new driver 模式。

   3. 在 Settings（设置）标签页中，输入以下信息：

      驱动程序名称	MongoDB
      类名	com.mongodb.jdbc.MongoDriver

   4. 在 Libraries 标签页中，单击 Add File 并添加 JDBC 驱动程序 all.jar 文件。

      单击 Find Class（连接）。

   5. 单击 OK（确定）。Create new driver 模式窗口将关闭。

3. 创建一个数据库连接。

   1. 在 DBeaver 中，单击 Database 并从下拉菜单中选择 New Database Connection，打开 Connect to a database 模式。

   2. 从数据库列表中，选择您在上一步中创建的 MongoDB 数据库驱动程序。

      如果没有看到 MongoDB，请在模式窗口中选择 All（全部）类别。

      单击 Next（连接）。

   3. 在 Main（设置）标签页中，输入以下信息：

      JDBC URL	第 5 步中的连接字符串。
      用户名	要连接的 MongoDB 用户。
      密码	MongoDB 用户的密码。

   4. 在 Driver properties（驱动程序属性）标签页中，展开 User Properties（用户属性）。添加以下键值属性：

      database	虚拟数据库的名称。
      user	用于连接的 MongoDB 用户。如果您在上一步中输入了 Username，则不是必需的。
      密码	MongoDB 用户的密码。如果您在上一步中输入了 Password，则不是必需的。

4. 单击 Finish（连接）。

（可选）确认您可以访问联合数据库实例数据。

在 Database Navigator 中，扩展 MongoDB 连接，验证映射到数据的联邦数据库实例存储是否可访问。

展开您的 MongoDB 连接。

DBeaver Database Navigator 显示虚拟数据库。

打开 SQL 控制台。

1. 右键单击要查询的虚拟数据库。

2. 选择 SQL Editor 。

3. 选择 Open SQL console 。

   将打开一个新的 SQL 控制台窗口，该窗口连接到您选择的虚拟数据库。

在控制台中输入 SQL 查询。

单击 Execute SQL Statement（执行 SQL 语句）以运行您的 SQL 查询。

如果查询成功，MongoSQL 会在查询下方的表视图中显示结果。