Docs 菜单
Docs 主页
/
MongoDB Atlas
/ / /

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

本教程将指导您使用免费工具 MongoDB JDBC Driver 和 DBeaver(社区版)连接到联合数据库实例。

如果您遵循高级配置指南,本教程还将指导您完成示例数据的查询。

安装以下客户端软件以使用 Atlas SQL 连接并查询您的数据。

1

DBeaver 是一个免费的通用数据库工具。 您可以使用它来探索本教程中的示例数据。 下载并安装 DBeaver(MongoDB Community Edition)。

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

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

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

    1. 运行以下命令从 Maven 中央资源库 下载 .asc 文件。

      curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.1.2/mongodb-jdbc-2.1.2.jar.asc
    2. 运行以下命令,下载并导入密钥文件。将 {server_url} 替换为 Maven 支持的当前 GPG 密钥服务器之一:

      • keyserver.ubuntu.com

      • keys.openpgp.org

      • pgp.mit.edu

      gpg --keyserver {server_url} --recv-keys 91A2157730666110
      gpg: key 91A2157730666110: public key "Huan Li <huan.li@10gen.com>" imported
      gpg: Total number processed: 1
      gpg: imported: 1
    3. 运行以下命令,验证 MongoDB JDBC 驱动程序安装文件。

      gpg --verify mongodb-jdbc-2.1.2.jar.asc mongodb-jdbc-2.1.2.jar

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

      gpg: Signature made Wed May 22 13:24:36 2024 MDT
      gpg: using RSA key 91A2157730666110
      gpg: Good signature from "Huan Li <huan.li@10gen.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

要从 DBeaver 连接到联合数据库实例,请执行以下操作:

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

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

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

    显示Data Federation 页面。

2
3
4

注意

本教程使用 JDBC 驱动程序进行连接。有关其他连接方法,请参阅使用 Atlas SQL 接口连接

5

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

6
  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(连接)。

7

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

要进一步了解连接联合数据库实例的不同方法,请参阅使用 Atlas SQL 接口连接

要在 DBeaver 中运行 Atlas SQL 查询,请执行以下操作:

1

DBeaver Database Navigator 显示虚拟数据库。

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

  2. 选择 SQL Editor

  3. 选择 Open SQL console

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

3
4

如果查询成功,Atlas SQL 将在查询下方的表视图中显示结果。

如果您按照高级配置指南使用样本数据,请尝试在联合数据库实例中针对样本数据运行以下 Atlas SQL 查询。

否则,您可以针对您的命名空间修改这些示例查询。

SELECT *
FROM Sessions

Atlas SQL 会返回 Sessions 集合中的所有文档。

SELECT *
FROM Users
LIMIT 2

Atlas SQL 会返回 Users 集合中的两个文档。

SELECT *
FROM Users
WHERE name = 'Jon Snow'

Atlas SQL 可返回 Users 集合中用户 name Jon Snow 为以下名称的文档。

有关 Atlas SQL 命令参考,请参阅 Atlas SQL 语言参考。

后退

SQL 教程