使用合规ID导入节点CSV至AGE时报错：label_id必须为1-65535

你遇到的错误核心是混淆了节点ID和label_id的概念：错误提示的label_id是Apache AGE为图标签（比如:Product、:User）分配的内部唯一ID，范围限制在1-65535，和你设置的产品节点ID（product_id）无关。以下是针对性的解决步骤：

1. 修正导入命令，避免直接操作系统表 #

确保你使用的是针对具体标签的导入命令，而非直接操作AGE的系统表。比如：

• 先提前创建标签：

  CREATE LABEL Product;
  

• 再导入对应CSV（CSV仅需包含节点属性，无需label_id字段）：

  COPY your_graph_name.Product FROM '/path/to/products.csv' WITH (FORMAT csv, HEADER true);
  

如果错误地使用COPY _ag_label FROM ...这类操作系统表的命令，会强制要求指定label_id，一旦超出范围就会触发报错。

2. 检查转换后的CSV格式 #

确认你的products.csv没有包含label_id、graph_id这类AGE系统内部字段，列名需和标签的属性完全匹配。比如正确的CSV结构应该是：

product_id,name,price,store_id
1,智能手机,2999,101
2,无线耳机,399,101

如果CSV里误加了label_id列且值超出1-65535，直接删除该列即可。

3. 检查现有标签数量 #

AGE的label_id是16位无符号整数，最多支持65535个不同标签。如果你的图中已创建大量标签，可能导致新标签的自动分配ID超出范围。执行以下查询查看所有标签的ID：

SELECT label_id, name FROM _ag_label;

如果发现label_id接近65535，删除不必要的标签或合并相似标签即可。

4. 确认标签已提前创建 #

导入数据前务必先创建对应标签，避免AGE自动创建标签时因已有标签过多，分配的label_id超出范围。创建标签的命令示例：

CREATE LABEL User;
CREATE LABEL Store;

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