使用 AQL 查询数据

上一页
下一页

在本章中，我们将讨论如何使用 AQL 查询数据。我们已经在前面的章节中讨论过，ArangoDB 开发了自己的查询语言，它被称为 AQL。

现在让我们开始与 AQL 进行交互。如下图所示，在 Web 界面中，点击导航栏顶部的**AQL 编辑器**选项卡。将出现一个空白的查询编辑器。

需要时，您可以通过点击右上角的“查询”或“结果”选项卡在编辑器和结果视图之间切换，如下图所示。

Switch To the Editor From The Result View

除其他功能外，编辑器还具有语法高亮显示、撤消/重做功能和查询保存功能。有关详细参考，您可以查看官方文档。我们将重点介绍 AQL 查询编辑器的一些基本和常用功能。

AQL 基础

在 AQL 中，查询表示要达到的最终结果，而不是达到最终结果的过程。此功能通常称为语言的声明式属性。此外，AQL 可以查询和修改数据，因此可以通过组合这两个过程来创建复杂的查询。

请注意，AQL 完全符合 ACID。读取或修改查询要么完全完成，要么完全不完成。即使读取文档的数据也会以一致的数据单元结束。

我们向已创建的歌曲集合中添加两首新**歌曲**。您可以复制以下查询，然后将其粘贴到 AQL 编辑器中，而不是手动输入。

FOR song IN [
   {
      title: "Air-Minded Executive", lyricist: "Johnny Mercer",
      composer: "Bernie Hanighen", Year: 1940, _key: "Air-Minded"
   },
   
   {
      title: "All Mucked Up", lyricist: "Johnny Mercer", composer:
      "Andre Previn", Year: 1974, _key: "All_Mucked"
   }
]
INSERT song IN songs

按下左下角的“执行”按钮。

它将在**songs**集合中写入两个新文档。

此查询描述了 FOR 循环在 AQL 中的工作方式；它迭代 JSON 编码文档列表，对集合中每个文档执行编码操作。不同的操作可以是创建新结构、过滤、选择文档、修改或将文档插入数据库（参考即时示例）。从本质上讲，AQL 可以有效地执行 CRUD 操作。

要查找数据库中的所有歌曲，让我们再次运行以下查询，相当于 SQL 类型数据库中的**SELECT * FROM songs**(因为编辑器会记住最后一个查询，请按**“新建”**按钮清除编辑器)。

FOR song IN songs
RETURN song

结果集将显示到目前为止保存在**songs**集合中的歌曲列表，如下面的屏幕截图所示。

List of Songs

可以将**FILTER、SORT**和**LIMIT**等操作添加到**For 循环**体中以缩小和排序结果。

FOR song IN songs
FILTER song.Year > 1940
RETURN song

上述查询将在“结果”选项卡中显示 1940 年以后创作的歌曲（请参见下图）。

Query Songs Created After Year_1940

本例中使用了文档键，但任何其他属性也可以用作过滤的等价物。由于文档键保证是唯一的，因此最多只有一个文档与该过滤器匹配。对于其他属性，情况可能并非如此。要返回活动用户（由名为 status 的属性确定）的子集，并按名称升序排序，我们使用以下语法。

FOR song IN songs
FILTER song.Year > 1940
SORT song.composer
RETURN song
LIMIT 2

我们特意包含了此示例。在这里，我们观察到 AQL 以红色突出显示的查询语法错误消息。此语法突出显示错误，有助于调试查询，如下面的屏幕截图所示。

Syntax Highlights The Errors

现在让我们运行正确的查询（注意更正）。

FOR song IN songs
FILTER song.Year > 1940
SORT song.composer
LIMIT 2
RETURN song

Run The Correct Query

AQL 中的复杂查询

AQL 配备了所有支持数据类型的多个函数。查询内的变量赋值允许构建非常复杂的嵌套结构。这样，数据密集型操作会更靠近后端的数据，而不是靠近客户端（例如浏览器）。为了理解这一点，让我们首先将任意时长（长度）添加到歌曲中。

让我们从第一个函数开始，即 Update 函数。

UPDATE { _key: "All_Mucked" }
WITH { length: 180 }
IN songs

Complex Query in AQL

我们可以看到已写入了一个文档，如上图所示。

现在让我们更新其他文档（歌曲）。

UPDATE { _key: "Affable_Balding" }
WITH { length: 200 }
IN songs

现在我们可以检查我们的所有歌曲是否都有一个新的属性**length**。

FOR song IN songs
RETURN song

输出

[
   {
      "_key": "Air-Minded",
      "_id": "songs/Air-Minded",
      "_rev": "_VkC5lbS---",
      "title": "Air-Minded Executive",
      "lyricist": "Johnny Mercer",
      "composer": "Bernie Hanighen",
      "Year": 1940,
      "length": 210
   },
   
   {
      "_key": "Affable_Balding",
      "_id": "songs/Affable_Balding",
      "_rev": "_VkC4eM2---",
      "title": "Affable Balding Me",
      "lyricist": "Johnny Mercer",
      "composer": "Robert Emmett Dolan",
      "Year": 1950,
      "length": 200
   },
   
   {
      "_key": "All_Mucked",
      "_id": "songs/All_Mucked",
      "_rev": "_Vjah9Pu---",
      "title": "All Mucked Up",
      "lyricist": "Johnny Mercer",
      "composer": "Andre Previn",
      "Year": 1974,
      "length": 180
   },
   
   {
      "_key": "Accentchuate_The",
      "_id": "songs/Accentchuate_The",
      "_rev": "_VkC3WzW---",
      "title": "Accentchuate The Politics",
      "lyricist": "Johnny Mercer",
      "composer": "Harold Arlen",
      "Year": 1944,
      "length": 190
   }
]

为了说明 AQL 其他关键字（如 LET、FILTER、SORT 等）的使用，我们现在将歌曲的时长格式化为**mm:ss**格式。

查询

FOR song IN songs
FILTER song.length > 150
LET seconds = song.length % 60
LET minutes = FLOOR(song.length / 60)
SORT song.composer
RETURN
{
   Title: song.title, 
   Composer: song.composer, 
   Duration: CONCAT_SEPARATOR(':',minutes, seconds) 
}

Complex Query in AQL 2

这次我们将返回歌曲标题和时长。**Return**函数允许您创建新的 JSON 对象以返回每个输入文档。

我们现在将讨论 AQL 数据库的“联接”功能。

让我们首先创建一个名为**composer_dob**的集合。此外，我们将通过在查询框中运行以下查询来创建四个文档，其中包含作曲家的假设出生日期。

FOR dob IN [
   {composer: "Bernie Hanighen", Year: 1909}
   ,
   {composer: "Robert Emmett Dolan", Year: 1922}
   ,
   {composer: "Andre Previn", Year: 1943}
   ,
   {composer: "Harold Arlen", Year: 1910}
]
INSERT dob in composer_dob

Composer DOB

为了突出与 SQL 的相似性，我们在 AQL 中提供了一个嵌套的 FOR 循环查询，从而导致 REPLACE 操作，首先在内部循环中迭代所有作曲家的出生日期，然后迭代所有关联的歌曲，创建一个包含属性**song_with_composer_key**而不是**song**属性的新文档。

以下是查询。

FOR s IN songs
FOR c IN composer_dob
FILTER s.composer == c.composer

LET song_with_composer_key = MERGE(
   UNSET(s, 'composer'),
   {composer_key:c._key}
)
REPLACE s with song_with_composer_key IN songs

Song Wth Composer Key

现在让我们再次运行查询**FOR song IN songs RETURN song**，以查看歌曲集合发生了哪些变化。

输出

[
   {
      "_key": "Air-Minded",
      "_id": "songs/Air-Minded",
      "_rev": "_Vk8kFoK---",
      "Year": 1940,
      "composer_key": "5501",
      "length": 210,
      "lyricist": "Johnny Mercer",
      "title": "Air-Minded Executive"
   },
   
   {
      "_key": "Affable_Balding",
      "_id": "songs/Affable_Balding",
      "_rev": "_Vk8kFoK--_",
      "Year": 1950,
      "composer_key": "5505",
      "length": 200,
      "lyricist": "Johnny Mercer",
      "title": "Affable Balding Me"
   },
   
   {
      "_key": "All_Mucked",
      "_id": "songs/All_Mucked",
      "_rev": "_Vk8kFoK--A",
      "Year": 1974,
      "composer_key": "5507",
      "length": 180,
      "lyricist": "Johnny Mercer",
      "title": "All Mucked Up"
   },
   
   {
      "_key": "Accentchuate_The",
      "_id": "songs/Accentchuate_The",
      "_rev": "_Vk8kFoK--B",
      "Year": 1944,
      "composer_key": "5509",
      "length": 190,
      "lyricist": "Johnny Mercer",
      "title": "Accentchuate The Politics"
   }
]

上述查询完成了数据迁移过程，将**composer_key**添加到每首歌曲中。

现在下一个查询再次是一个嵌套的 FOR 循环查询，但这次导致联接操作，将关联的作曲家姓名（使用`composer_key`获取）添加到每首歌曲中。

FOR s IN songs
FOR c IN composer_dob
FILTER c._key == s.composer_key
RETURN MERGE(s,
{ composer: c.composer }
)

输出

[
   {
      "Year": 1940,
      "_id": "songs/Air-Minded",
      "_key": "Air-Minded",
      "_rev": "_Vk8kFoK---",
      "composer_key": "5501",
      "length": 210,
      "lyricist": "Johnny Mercer",
      "title": "Air-Minded Executive",
      "composer": "Bernie Hanighen"
   },
   
   {
      "Year": 1950,
      "_id": "songs/Affable_Balding",
      "_key": "Affable_Balding",
      "_rev": "_Vk8kFoK--_",
      "composer_key": "5505",
      "length": 200,
      "lyricist": "Johnny Mercer",
      "title": "Affable Balding Me",
      "composer": "Robert Emmett Dolan"
   },

   {
      "Year": 1974,
      "_id": "songs/All_Mucked",
      "_key": "All_Mucked",
      "_rev": "_Vk8kFoK--A",
      "composer_key": "5507",
      "length": 180,
      "lyricist": "Johnny Mercer",
      "title": "All Mucked Up",
      "composer": "Andre Previn"
   },

   {
      "Year": 1944,
      "_id": "songs/Accentchuate_The",
      "_key": "Accentchuate_The",
      "_rev": "_Vk8kFoK--B",
      "composer_key": "5509",
      "length": 190,
      "lyricist": "Johnny Mercer",
      "title": "Accentchuate The Politics",
      "composer": "Harold Arlen"
   }
]

Adding Composer Key To Each Song
打印页面
上一页
下一页
广告

© . All rights reserved.