如何在ArangoDB中存储简单键值数据？

嘿，我来帮你理清楚在ArangoDB里存储简单键值数据的方法，还有你提到的GitHub Issue里的相关问题~

基础存储方案 #

1. 用文档集合模拟键值存储（全版本兼容） #

这是最通用的方式，适合所有ArangoDB版本。创建一个普通文档集合，用内置的_key字段作为键，再自定义一个value字段存储对应的值：

// 创建集合
db._create("keyValueStore");

// 插入键值对
db.keyValueStore.insert({ _key: "user:123", value: { name: "Alice", age: 30 } });
db.keyValueStore.insert({ _key: "config:theme", value: "dark" });

// 查询对应值
db.keyValueStore.document("user:123").value;

_key是ArangoDB的原生主键，会自动建立索引，查询速度很快，完全能满足常规键值存储需求。

2. 使用专用键值集合（ArangoDB 3.10+） #

从3.10版本开始，ArangoDB推出了专门的键值集合（Key-Value Collections），针对键值场景做了底层优化，API也更贴合键值操作习惯：

// 创建键值集合（type=3指定为键值类型）
db._create("simpleKV", { type: 3 });

// 插入键值
db.simpleKV.put("foo", "bar");
db.simpleKV.put("count", 42);

// 获取值
db.simpleKV.get("foo"); // 返回 "bar"

// 删除键值
db.simpleKV.remove("count");

这种方式无需手动构建文档结构，直接用put/get/remove等原生操作，非常轻量化。

GitHub Issue中提到的常见问题 #

社区讨论里大家常碰到这几个痛点：

• 旧版本无专用键值集合：3.10之前的版本只能用文档集合模拟，虽然能用，但对于追求极简键值操作的场景，会觉得不够便捷。
• _key长度限制：_key默认最大长度是256字节，如果需要存储超长键，得额外处理（比如对原键哈希后作为_key，再把原键存在文档字段里）。
• 事务兼容性差异：键值集合的事务行为和文档集合略有不同，比如部分批量操作的事务支持需要注意，具体可以参考官方文档的细节说明。

总结 #

如果你的ArangoDB是3.10及以上版本，优先用专用键值集合，操作更高效直观；旧版本就用文档集合+_key的方式，也能稳定实现键值存储，根据你的版本和需求选择即可。

内容的提问来源于stack exchange，提问作者Kamil