使用免费 SQL 工具连接和查询数据
本教程将指导您使用免费工具 MongoDB JDBC Driver 和 DBeaver(社区版)连接到联合数据库实例。
如果您遵循高级配置指南,本教程还将指导您完成示例数据的查询。
安装客户端软件
安装以下客户端软件以使用 Atlas SQL 连接并查询您的数据。
安装 DBeaver
DBeaver 是一个免费的通用数据库工具。 您可以使用它来探索本教程中的示例数据。 下载并安装 DBeaver(MongoDB Community Edition)。
安装 JDBC 驱动程序
下载最新的 MongoDB JDBC 驱动程序版本。
验证下载包的完整性:
MongoDB 发布团队对所有软件包进行数字签名,证明特定的 MongoDB 包是有效且未经更改的 MongoDB 版本。MongoDB 使用不同的 PGP 密钥对每个发布分支进行签名,格式为
.asc
。运行以下命令从 Maven 中央资源库 下载
.asc
文件。curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.1.2/mongodb-jdbc-2.1.2.jar.asc 运行以下命令,下载并导入密钥文件。将
{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 运行以下命令,验证 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 连接到联合数据库实例,请执行以下操作:
在 Atlas 中,转到项目的联合数据库实例。
如果尚未显示,请选择包含您的项目的组织导航栏中的 Organizations菜单。
如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中,单击 Services 标题下的 Data Federation。
显示Data Federation 页面。
选择 JDBC Driver(Atlas SQL)。
注意
本教程使用 JDBC 驱动程序进行连接。有关其他连接方法,请参阅使用 Atlas SQL 接口连接。
从 DBeaver 连接。
启动 DBeaver。
添加新的驱动程序。
在 DBeaver 中,单击 Database(数据库),然后从下拉菜单中选择 Driver Manager(驱动程序管理器)。
单击 New 打开 Create new driver 模式。
在 Settings(设置)标签页中,输入以下信息:
驱动程序名称MongoDB
类名com.mongodb.jdbc.MongoDriver
在 Libraries 标签页中,单击 Add File 并添加 JDBC 驱动程序
all.jar
文件。单击 Find Class(连接)。
单击 OK(确定)。Create new driver 模式窗口将关闭。
创建一个数据库连接。
在 DBeaver 中,单击 Database 并从下拉菜单中选择 New Database Connection,打开 Connect to a database 模式。
从数据库列表中,选择您在上一步中创建的
MongoDB
数据库驱动程序。如果没有看到
MongoDB
,请在模式窗口中选择 All(全部)类别。单击 Next(连接)。
在 Main(设置)标签页中,输入以下信息:
JDBC URL第 5 步中的连接字符串。用户名要连接的 MongoDB 用户。密码MongoDB 用户的密码。在 Driver properties(驱动程序属性)标签页中,展开 User Properties(用户属性)。添加以下键值属性:
database虚拟数据库的名称。user用于连接的 MongoDB 用户。如果您在上一步中输入了Username
,则不是必需的。密码MongoDB 用户的密码。如果您在上一步中输入了Password
,则不是必需的。
单击 Finish(连接)。
要进一步了解连接联合数据库实例的不同方法,请参阅使用 Atlas SQL 接口连接。
运行 Atlas SQL 查询
要在 DBeaver 中运行 Atlas SQL 查询,请执行以下操作:
Atlas SQLQueries 示例
如果您按照高级配置指南使用样本数据,请尝试在联合数据库实例中针对样本数据运行以下 Atlas SQL 查询。
否则,您可以针对您的命名空间修改这些示例查询。
SELECT 声明
SELECT * FROM Sessions
Atlas SQL 会返回 Sessions
集合中的所有文档。
LIMIT 声明
SELECT * FROM Users LIMIT 2
Atlas SQL 会返回 Users
集合中的两个文档。
WHERE 语句
SELECT * FROM Users WHERE name = 'Jon Snow'
Atlas SQL 可返回 Users
集合中用户 name
Jon Snow
为以下名称的文档。
有关 Atlas SQL 命令参考,请参阅 Atlas SQL 语言参考。