Datomic中如何向已有实体的多值属性添加新引用实体？

需求回顾 #

已有drawing实体（:db/id为17592186047451），需向其多基数属性:drawing/shapes添加两个新shape实体。

正确写法1：使用符号类型临时ID #

[
  ;; 创建第一个shape实体，用符号作为临时ID
  {:shape/id "BKF806TXXTAFWII0", :db/id :shape-temp-0}
  ;; 创建第二个shape实体，用符号作为临时ID
  {:shape/id "YKIZU4CJC0JXJKVQ", :db/id :shape-temp-1}
  ;; 给drawing添加第一个shape引用
  [:db/add 17592186047451 :drawing/shapes :shape-temp-0]
  ;; 给drawing添加第二个shape引用
  [:db/add 17592186047451 :drawing/shapes :shape-temp-1]
]

正确写法2：嵌套实体创建（推荐） #

如果你的Datomic版本支持嵌套事务，且:drawing/shapes属性为多基数，可以直接在事务中嵌套定义新shape实体：

[
  {:db/id 17592186047451,
   :drawing/shapes [
     {:shape/id "GEMRMRFG0E6N262M"}
     {:shape/id "HTH2C7R90BQFFNXT"}
   ]}
]

之前写法的错误原因分析 #

1. 第一种/第三种写法错误：
   临时ID使用了字符串（如"22NF08ZVGH9N7QGG_0"），但Datomic要求临时ID必须是符号类型（以:开头，如:22NF08ZVGH9N7QGG_0）。字符串会被解析为普通值而非实体引用，导致“无法解释为关键字”的报错。此外，:db/add不支持直接传入集合作为多基数属性的值，需分多次调用或用嵌套写法。

2. 第二种写法错误：
   临时ID依然使用字符串，导致Datomic无法正确关联新创建的shape实体。若报错提示“两个datoms冲突”，需检查:drawing/shapes的属性定义是否为:db/cardinality :db.cardinality/many——如果属性是单基数，多次添加值必然冲突。

3. 第四种写法错误：
   若使用嵌套写法报错“无法解析实体”，可能是以下原因：

   • :drawing/shapes属性的基数不是:db.cardinality/many；
   • 使用的Datomic版本不支持嵌套多基数实体的创建；
   • 属性未设置:db/isComponent true（非必须，但部分场景下需要此配置才能自动解析嵌套实体）。

关键注意事项 #

• 确保:drawing/shapes属性定义为:db/cardinality :db.cardinality/many，且未设置:db/unique约束（多基数属性不允许唯一约束）；
• 临时ID必须为符号类型，不能用字符串；
• 嵌套写法更简洁，但需确认Datomic版本支持（Datomic Cloud及较新的On-Prem版本均支持）。

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