对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

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

本教程将指导您使用免费工具MongoDB JDBC驱动程序和 DBeaver(社区版)连接到Atlas专用集群或联合数据库实例。

如果您将示例数据加载到部署中,本教程还可以指导您对其进行查询。

在开始之前,将部署部署为接受SQL连接。要学习;了解如何操作,请参阅SQL接口服务器设置。

安装以下客户端软件以使用 MongoSQL 连接并查询数据。

1

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

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

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

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

    1. 运行以下命令以从.asc Maven 中央存储库下载 文件。将{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

选择部署类型以获取连接字符串并配置 DBeaver:

要详细学习;了解可用于连接的不同方法,请参阅将SQL工具连接到MongoDB。

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

1

DBeaver Database Navigator 显示虚拟数据库。

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

  2. 选择 SQL Editor 。

  3. 选择 Open SQL console 。

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

3
4

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

如果已将示例数据加载到部署中,请尝试对其运行以下 MongoSQL 查询。

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

SELECT *
FROM Sessions

MongoSQL 返回 Sessions集合中的所有文档。

SELECT *
FROM Users
LIMIT 2

MongoSQL 从 Users集合中返回两个文档。

SELECT *
FROM Users
WHERE name = 'Jon Snow'

MongoSQL 返回 Users集合中用户的 name 为 Jon Snow 的文档。

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

给本页内容打分