从 MongoDB Shell 进行连接

在此页面上

先决条件

步骤
聚合事务语法和简式事务语法

本页介绍如何通过 MongoDB Shell (mongosh) 连接到联合数据库实例。

先决条件

映射到一个或多个数据存储的联合数据库实例。
注意
如果部分或全部数据来自 Atlas 集群，则必须为该集群使用 MongoDB 5.0 或更高版本才能利用 Atlas SQL。

步骤

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

如果尚未显示，请选择包含您的项目的组织导航栏中的 Organizations菜单。
如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中，单击 Services 标题下的 Data Federation。
显示Data Federation 页面。

单击Connect 打开联合数据库实例连接模态。

选择Shell 。

安装 MongoDB Shell（如果尚未安装）。

如果您没有安装 MongoDB Shell：

在连接模态框中选择 I do not have the MongoDB Shell installed。
从模式下拉菜单中选择操作系统。
请按照模态中提供的适用于您的操作系统的安装说明进行操作。
（可选）确认 mongosh 安装成功。
要检查安装是否成功，请在终端中运行：
```
mongosh --version
```
如果安装成功，mongosh 将显示版本。

如果已安装 MongoDB Shell：

在连接模态框中选择 I have the MongoDB Shell installed。
从模态框下拉菜单中选择 mongosh。
注意
MongoDB Shell 或 mongosh 与模式下拉菜单中的 mongo 版本是分开的。
如果要确保已安装 mongosh，请在终端中运行：
```
mongosh --version
```
如果安装了 mongosh，则会显示版本。

选择身份验证方法。

身份验证方法取决于数据库访问的配置方式。要了解有关数据库访问的更多信息，请参阅配置数据库用户。

您可以选择：

Password (SCRAM)，或
X.509.

Atlas Data Federation 可为身份验证方法提供连接字符串。

复制并运行连接字符串。

如果选择了 Password (SCRAM) 身份验证方法，系统会提示您输入连接用户的密码。

（可选）确认与联合数据库实例的连接。

要确认您已连接到联合数据库实例，请使用mongosh，运行：

show dbs

如果成功连接到映射到数据存储的联合数据库实例，mongosh 将显示虚拟数据库名称。

聚合事务语法和简式事务语法

Atlas SQL 支持用于构建 SQL 查询的聚合管道阶段语法和短格式语法。您可以使用这些语法之一在 MongoDB Shell 中编写查询。

聚合管道阶段事务语法

您可以使用 $sql 聚合管道阶段来编写 Atlas SQL 查询。请参阅 $sql，了解必须向 $sql 提供的属性列表。

以下示例使用 $sql 语法来执行 Atlas SQL 语句 select * from Users limit 2：

db.aggregate( [ {
    $sql: {
       statement: "SELECT *
                   FROM users
                   LIMIT 2",
       format: "jdbc",
       dialect: "mongosql"
   }
} ] )

注意

Atlas SQL 使用 mongosql 方言。

简短形式语法

您可以使用简短语法 db.sql，直接提供 Atlas SQL 语句。

重要

简短形式语法并不稳定，将来可能会发生变化。

db.sql(`
  SELECT *
  FROM users
  LIMIT 2
`);

后退

连接

来年

JDBC 驱动程序