Apache HugeGraph中CUSTOMIZE_UUID策略的使用指南

理解顶点ID策略

在Apache HugeGraph图数据库中，顶点ID策略是一个关键的设计决策。CUSTOMIZE_UUID策略允许用户自定义UUID格式的顶点标识符，这为数据集成和迁移提供了灵活性。

CUSTOMIZE_UUID策略的核心要点

1. ID必须显式提供：与自动生成的ID策略不同，使用CUSTOMIZE_UUID时必须明确指定顶点ID值。

2. ID格式要求：必须提供符合UUID标准的字符串格式，如"123e4567-e89b-12d3-a456-426614174000"。

3. ID位置规范：ID值必须放在JSON请求体的顶层，不能嵌套在properties对象内。

正确添加顶点的JSON结构

{
    "label": "person",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "properties": {
        "name": "marko",
        "age": 29
    }
}

常见错误及解决方案

1. ID未提供错误：当忘记提供ID时，系统会提示"Must customize vertex string id"。

2. ID格式错误：确保ID是有效的UUID格式，避免使用简单数字或不合规的字符串。

3. ID位置错误：ID必须放在JSON顶层，放在properties内会导致解析失败。

建立边关系的注意事项

1. 顶点必须存在：在创建边之前，确保源顶点和目标顶点都已存在。

2. 标签匹配：边的outVLabel和inVLabel必须与对应顶点的标签一致。

3. ID一致性：边的端点ID必须与顶点创建时使用的ID完全一致。

最佳实践建议

1. 批量操作前验证：在大规模导入前，先测试少量数据确保ID策略配置正确。

2. ID生成策略：考虑使用标准UUID库生成ID，避免手动输入错误。

3. 文档记录：明确记录系统中使用的ID策略，便于团队协作和维护。

通过正确理解和应用CUSTOMIZE_UUID策略，可以充分利用HugeGraph的灵活性，实现复杂业务场景下的图数据建模需求。