从零开始学AQL：ArangoDB WebUI配置+示例数据集介绍

在学习AQL（ArangoDB Query Language）的过程中，“搭好环境”和“看懂数据”是迈出第一步的关键。这篇文章就从ArangoDB的Web界面配置入手，再带你认识我们后续实操会用到的《权力的游戏》数据集，帮你夯实AQL学习的基础。

一、ArangoDB Web Interface（企业版）：配置与登录

想要用AQL操作数据，首先得完成ArangoDB Web界面的初始化配置并登录。这部分步骤不复杂，但有几个细节需要注意，避免后续操作出问题。

原课程链接：https://university.arangodb.com/courses/aql-fundamentals/lessons/setup/

1. 配置操作：创建初始空数据库

点击界面上的“设置”按钮后，系统会自动帮你创建一个空数据库——这个数据库是后续存储和操作数据的基础，后续课程推进时会逐步加载所需数据，不用手动创建。

这里有个关键注意事项：完成设置后，要等页面自动刷新。刷新完成后，界面才会显示登录所需的详细信息，不要提前点击登录按钮，否则会因为信息未加载完全导致登录失败。

2. 登录信息：妥善保存这几个关键参数

页面刷新后，会生成登录信息，建议截图或记录下来（后续登录会反复用到），具体包括：

• 数据库名称（dbName）
• 主机名（hostname）
• 用户名（username）
• 密码（password）
• 端口（port）

3. 登录入口：访问Web界面

当配置完成后，会看到提示“You have already configured ArangoGraph”，这说明ArangoGraph已经配置好，可以登录了。

登录入口的网址是：https://tutorials.arangodb.cloud:8529/
打开链接后，输入上面记录的“数据库名称、用户名、密码”，就能成功进入ArangoDB的Web操作界面。

二、《权力的游戏》数据集：我们要操作的数据长什么样？

为了让AQL学习更直观，后续实操会基于《权力的游戏》的数据集展开。这个数据集包含三种核心数据类型，结构清晰，很适合新手练习。

1. 数据集整体说明

• 数据来源：基于《权力的游戏》小说及电视剧第一季内容，角色、地点等信息都贴合原作设定。
• 数据特点：包含“角色、属性、拍摄地点”三类数据，组合多样，能覆盖AQL的各种操作场景（比如查询、关联、筛选等）。
• 导入方式：不用你手动导入数据！这些数据会作为后续AQL查询的一部分自动提供，你只需要在Web界面上管理集合、执行查询即可。

2. 三大核心数据类别详解

下面分别介绍三类数据的结构和关键信息，帮你后续写AQL时能快速定位“要操作哪些字段”。

（1）Characters（角色数据）

这部分包含《权力的游戏》中的43个核心角色，每个角色的属性分为“必含”和“可选”两类：

• 必含属性：每个角色都有这三个字段
  • name：角色名（如Ned、Robert）
  • alive：存活状态（布尔值，true表示存活，false表示死亡）
  • traits：角色特征（用字母数组表示，比如[“A”,“H”,“C”]，后续会解析这些字母对应的具体含义）
• 可选属性：不是所有角色都有，比如
  • surname：姓氏（如Stark、Lannister，部分角色可能没有姓氏）
  • age：年龄（部分角色未记录年龄，字段会缺失）

另外要注意：如果看到数据表格中有“属性（已解析）”列，那只是截图中为了方便查看角色特征而添加的，不属于实际可用的数据字段，不用在AQL中引用这个列。

（2）Traits（角色属性数据）

这部分是对“Characters”中traits字段的补充——前面提到的字母（如A、B），对应的就是这里的属性，总共包含18个唯一属性：

• 文档键（_key）：每个属性对应一个随机字母（比如A、B、C），这个字母就是Characters中traits数组里的元素。
• 双语言标签：每个属性都有英文和德文两种描述，方便多语言场景使用，比如：
  • 字母A对应的英文是“strong”，德文是“stark”
  • 字母B对应的英文是“polite”，德文是“freundlich”

（3）Locations（拍摄地点数据）

包含8个《权力的游戏》中的关键拍摄地点，核心属性很简单：

• name：地点名称（如Winterfell、King’s Landing）
• coordinate：地理坐标（用数组存储，格式是[纬度, 经度]，比如Winterfell的坐标是[54.368321, -5.581312]）

需要注意：如果在截图中看到坐标被拆成“coordinate[0]”（纬度）和“coordinate[1]”（经度）两列，只是为了显示清晰，实际存储时还是一个数组字段，后续查询坐标时要按数组格式引用（如loc.coordinate[0]获取纬度）。

三、小结

到这里，ArangoDB的Web界面配置、登录，以及《权力的游戏》数据集的核心结构就介绍完了。总结一下关键要点：

1. 配置ArangoDB时，一定要等页面刷新后再登录，登录信息要妥善保存；
2. 数据集包含角色、属性、地点三类数据，后续AQL操作会围绕这三类数据展开；
3. 重点记住各数据的核心字段（比如角色的name、traits，地点的coordinate），这是后续写查询语句的基础。

下一篇文章，我们会进入实操环节，教你用AQL完成“集合创建”和“文档增删改查（CRUD）”——这是AQL最核心的基础操作，做好准备一起动手吧！

注意：本文仅代表个人学习记录，如需生产环境级方案，请咨询艾体宝团队。