使用 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 为以下名称的文档。

展平

FLATTEN 会将半结构化数据（JSON 中的名称-值对）展平为单独的列。字段名变成列名，在行中存储该字段的所有值。

展平嵌套文档的语法是一个 FLATTEN 函数，该函数可以在 FROM 子句中与数据源和选项结合使用。

SELECT *
FROM FLATTEN(<data source>
 WITH DEPTH => <integer>,
 SEPARATOR => <string>
)

展平示例

在一个示例场景中，一个 customerInfo 集合包含了采用如下结构的文档：

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  }
}

如果运行查询 SELECT * FROM customerInfo，Atlas SQL 会返回包含以下顶级字段的文档：

如果运行查询 SELECT * FROM FLATTEN(customerInfo)，Atlas SQL 会返回包含以下顶级字段的文档：

当您使用 FLATTEN 时，原始文档中的每个扁平化字段都会成为结果集中的顶级字段。嵌套字段与其父字段名称连接并使用默认分隔符 _ 分隔。

Unwind

UNWIND 从输入数据源解构数组字段，为该数组中的每个项目输出一行。 要了解有关展开的更多信息，请参阅 $unwind聚合阶段文档。

展开数组字段的语法是一个UNWIND 函数，该函数可以在FROM 子句中与数据源和选项结合使用。

SELECT *
FROM UNWIND(<data source>
 WITH PATH => <array_path>,
 INDEX => <identifier>,
 OUTER => <bool>
)

展开示例

在一个示例场景中，一个 customerInfo 集合包含了采用如下结构的文档：

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

如果运行查询 SELECT * FROM customerInfo，Atlas SQL 会返回包含以下顶级字段的文档：

如果运行查询 SELECT * FROM UNWIND(customerInfo WITH PATH => visits, INDEX => idx)，Atlas SQL 会返回包含以下顶级字段的文档：

当您将 UNWIND 与 PATH => visits 一起使用时，每个 visits 对象都会成为一个表格行。

FLATTEN 和 UNWIND 组合示例

以下示例结合了 FLATTEN 和UNWIND 函数。

在一个示例场景中，一个 customerInfo 集合包含了采用如下结构的文档：

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

如果运行查询 SELECT * FROM customerInfo，Atlas SQL 会返回包含以下顶级字段的文档：

如果运行查询 Select * from FLATTEN(UNWIND(customerInfo WITH PATH => visits, INDEX => idx))，Atlas SQL 会返回包含以下顶级字段的文档：

当您同时使用FLATTEN和UNWIND函数时， visits大量将展开，然后生成的文档将被展平。