如何用邮箱作为唯一标识创建SurrealDB的person记录？

问题原因 #

你之前的写法出错是因为邮箱中的@属于SurrealQL的特殊字符，直接拼接成person:${person.email}会被SDK解析为表达式而非字面量ID，导致生成了带随机后缀的异常ID。

正确实现方式 #

1. 手动指定带特殊字符的ID（存在则报错，避免重复）

将ID部分用单引号包裹，让SDK识别为字面量：

for (const person of peopleFromSomewhere) {
  try {
    const created = await db.create(`person:'${person.email}'`, {
      email: person.email,
      fullName: person.fullName
    });
    console.log('创建成功:', created);
  } catch (err) {
    console.log('记录已存在，跳过:', person.email);
  }
}

执行后生成的记录ID会是person:some@email.com，重复执行时会因ID已存在抛出错误，可通过try/catch跳过已存在的记录。

2. 使用merge实现Upsert（存在则更新，不存在则创建）

如果希望重复执行时不报错，而是更新现有记录字段，推荐使用merge方法：

for (const person of peopleFromSomewhere) {
  const result = await db.merge(`person:'${person.email}'`, {
    email: person.email,
    fullName: person.fullName
  });
  console.log(result);
}

这种方式会自动处理：记录不存在则创建，已存在则更新指定字段，既避免重复插入又能同步数据。

3. 更清晰的参数格式（推荐）

通过对象形式指定表和ID，无需手动处理特殊字符转义：

for (const person of peopleFromSomewhere) {
  const result = await db.merge(
    { tb: 'person', id: person.email },
    { email: person.email, fullName: person.fullName }
  );
}

验证结果 #

执行上述正确代码后，生成的记录将符合预期：

{ 
  email: 'some@email.com',
  fullName: 'Some Name',
  id: 'person:some@email.com'
}

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