命令

在 DataEase 中，导入文件中的每一行都可以包含一个命令。这个命令告诉应用程序如何处理该行的数据。它可以更新现有项目，创建新项目，删除某些内容，甚至完全跳过该行。

DataEase 中的每种数据类型可能支持额外的自定义命令，这些命令记录在其特定的实体页面中。

---

⚙️ 默认命令：MERGE

• 应用程序将尝试查找现有项目并使用该行中的数据更新它。
• 如果未找到项目，它将创建一个新项目。

✅ 这是最常用的命令，适用于更新和添加新记录。

---

✳️ 创建命令：CREATE

• 应用程序将尝试创建一个新项目。
• 如果项目已存在（具有相同的 ID 或 handle），该行将失败。

✅ 仅在导入全新数据时使用。
❌ 如果某些数据可能已经存在，请勿使用。

---

🔁 更新命令：UPDATE

• 应用程序将搜索现有项目并更新它。
• 如果找不到匹配项，该行将失败。

✅ 最适合仅更新现有记录。
❌ 不会创建新项目。

---

♻️ 替换命令：REPLACE

• 应用程序将查找现有项目。
• 如果找到，它将删除它。
• 然后使用该行中的仅有数据创建一个新项目。

⚠️ 请注意：如果该行中缺少某些数据，新项目将不包括它。

✅ 适用于使用干净数据完全重建记录。

---

❌ 删除命令：DELETE

• 应用程序将查找并删除该项目。
• 如果找不到项目，该行将失败。

✅ 用于删除旧的或不正确的记录。

---

⏭️ 忽略命令：IGNORE

• 应用程序将跳过此行，不对其进行任何操作。

✅ 有助于在不从文件中删除的情况下暂时移除导入行。

---

📝 命令摘要表

命令	功能描述	创建新项目？	更新现有项目？	删除现有项目？
MERGE	更新或在未找到项目时创建	✅	✅	❌
CREATE	仅创建新项目	✅	❌	❌
UPDATE	仅在项目已存在时更新	❌	✅	❌
REPLACE	删除现有项目并使用当前值创建新项目	✅	❌	✅
DELETE	删除现有项目	❌	❌	✅
IGNORE	完全跳过该行	❌	❌	❌

---

💡 如何在文件中添加命令

在您的导入文件中，包含一个名为 command 的列，并用支持的值（如 MERGE、CREATE 等）填充它。

title,handle,price,command
"Red T-shirt","red-tee",19.99,MERGE
"Blue T-shirt","blue-tee",21.99,CREATE
"Old Product","old-handle",,DELETE