大数据开发治理平台 DataWorks：CreateLineageRelationship - 注册数据地图血缘关系

1. 需要购买 DataWorks 专业版及以上版本才能使用。

实体对象 (SrcEntity / DstEntity)

用于描述血缘关系的源端和目标端，支持在以下类型的实体之间注册血缘关系：

补充说明：

• 对于 DataWorks 已采集到的表、字段、数据集、数据集版本，建议不要手动拼接 Id，应优先使用对应 Get 或 List API 返回的 Id。

• 对于自定义对象，推荐使用用户注册的自定义实体对象方式，需要先完成实体定义和实体对象注册：

  1. 调用 CreateMetaEntityDef 创建自定义实体定义。

  2. 调用 BatchCreateMetaEntities 创建具体实体对象。

  3. 使用 BatchCreateMetaEntities 返回的实体 Id 作为 SrcEntity.Id 或 DstEntity.Id。

• 对于非纳管自定义对象，不需要调用 CreateMetaEntityDef 或 BatchCreateMetaEntities。只需传入以 custom- 开头的实体 Id，并填写 Name。该方式主要用于兼容历史场景，目前已不再推荐；新接入场景建议使用注册自定义实体对象的方式，便于后续查询、管理和扩展自定义属性。

• SrcEntity.Attributes 和 DstEntity.Attributes 表示实体端点的扩展属性；血缘关系本身的属性请放在 Task.Attributes 中。

任务信息 (Task)

用于描述产生该血缘关系的作业或任务信息。

请求示例

DataWorks 已采集表与自定义实体对象

{
  "SrcEntity": {
    "Id": "custom_entity-customer_api:api_001",
    "Name": "api_001"
  },
  "DstEntity": {
    "Id": "mysql-table:rm-xxx::demo_db::demo_table",
    "Name": "demo_table"
  },
  "Task": {
    "Id": "api_to_table_001",
    "Type": "custom-lineage-task",
    "Attributes": {
      "scene": "api_to_table",
      "owner": "zhangsan"
    }
  }
}

非纳管自定义对象与 DataWorks 已采集表

{
  "SrcEntity": {
    "Id": "custom-report:report_001",
    "Name": "report_001"
  },
  "DstEntity": {
    "Id": "maxcompute-table:::demo_project:default:demo_table",
    "Name": "demo_table"
  },
  "Task": {
    "Id": "report_to_table_001",
    "Type": "custom-lineage-task",
    "Attributes": {
      "scene": "report_to_table"
    }
  }
}