使用免费 SQL 工具连接和查询数据复制页面本教程将指导您使用免费工具 MongoDB JDBC Driver 和 DBeaver（社区版）连接到联合数据库实例。
如果您遵循高级配置指南，则本教程还将指导您完成示例数据的查询。
安装客户端软件安装以下客户端软件以使用 MongoSQL 连接并查询数据。
1安装 DBeaverDBeaver 是一个免费的通用数据库工具。您可以使用它来探索本教程中的示例数据。下载并安装DBeaver（社区版）。
2安装 JDBC 驱动程序下载最新的 MongoDB JDBC 驱动程序版本。
验证下载包的完整性：
MongoDB 发布团队对所有软件包进行数字签名，证明特定的 MongoDB 包是有效且未经更改的 MongoDB 版本。MongoDB 使用格式为 .asc 的不同 PGP 密钥对每个发布分支进行签名。
运行以下命令从 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运行以下命令，下载并导入密钥文件。将 {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
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.jarGPG 应返回类似于以下内容的响应：
gpg: Signature made Wed May 22 13:24:36 2024 MDTgpg: using RSA key BDDC8671F1BE6F4D5464096624A4A8409351E954gpg: Good signature from "MongoDB JDBC Driver Release Signing Key
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连接到联合数据库实例要从 DBeaver 连接到联合数据库实例，请执行以下操作：
1在 Atlas 中，转到项目的联合数据库实例。如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含项目的组织。
如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中，单击 Services 标题下的 Data Federation。
显示Data Federation 页面。
2单击 Connect 打开联合数据库实例连接模态。3选择 MongoSQL。4选择 JDBC Driver。5保存您的连接信息。Atlas Data Federation 提供了连接字符串来连接到您的联合数据库实例。您将在稍后的步骤中用到它。
6打开DBeaver应用程序。7向 DBeaver 添加驱动程序。在 DBeaver 中，单击 Database（数据库），然后从下拉菜单中选择 Driver Manager（驱动程序管理器）。
单击 New 打开 Create new driver 模式。
在 Settings标签页中，指定以下信息：
驱动程序名称
MongoSQL
类名
com.mongodb.jdbc.MongoDriver
在 Libraries 标签页中，单击 Add File 并添加 JDBC 驱动程序 all.jar 文件。
单击 Find Class（连接）。
单击 OK（确定）。Create new driver 模式窗口将关闭。
8创建一个数据库连接。在 DBeaver 中，单击 Database 并从下拉菜单中选择 New Database Connection，打开 Connect to a database 模式。
从数据库列表中，选择您在上一步中创建的 MongoDB 数据库驱动程序。
如果没有看到 MongoDB，请在模式窗口中选择 All（全部）类别。
单击 Next（连接）。
在 Main（设置）标签页中，输入以下信息：
JDBC URL
从上一步中获取的连接字符串。
用户名
已获得连接授权的MongoDB用户。
密码
与MongoDB用户关联的密码。
在 Driver properties（驱动程序属性）标签页中，展开 User Properties（用户属性）。添加以下键值属性：
database
虚拟数据库的名称。
user
用于连接的 MongoDB 用户。如果您在上一步中输入了 Username，则不是必需的。
要详细学习；了解可用于连接到联合数据库实例的不同方法，请参阅连接BI工具。
运行 MongoSQL 查询要在 DBeaver 中运行MongoSQL 查询，请执行以下操作：
1展开您的 MongoDB 连接。DBeaver Database Navigator 显示虚拟数据库。
2打开 SQL 控制台。右键单击要查询的虚拟数据库。
选择 SQL Editor 。
选择 Open SQL console 。
将打开一个新的 SQL 控制台窗口，该窗口连接到您选择的虚拟数据库。
3在控制台中输入 SQL 查询。4单击Execute SQL Statement 运行SQL查询。如果查询成功，MongoSQL 会在查询下方的表视图中显示结果。
MongoSQLQueries 示例如果您按照使用示例数据的高级配置指南进行操作，请尝试对联合数据库实例中的示例数据运行以下 MongoSQL 查询。
否则，您可以针对您的命名空间修改这些示例查询。
SELECT 声明SELECT *FROM SessionsMongoSQL 返回 Sessions集合中的所有文档。
LIMIT 声明SELECT *FROM UsersLIMIT 2MongoSQL 从 Users集合中返回两个文档。
WHERE 语句SELECT *FROM UsersWHERE name = 'Jon Snow'MongoSQL 返回 Users集合中用户的 name 为 Jon Snow 的文档。
有关 MongoSQL 命令参考，请参阅 MongoSQL 语言参考。