DataWorks:CreateLineageRelationship

1. DataWorks Professional Edition 以上のエディションが必須です。

エンティティオブジェクト (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-タスク",
    "Attributes": {
      "scene": "api_to_table",
      "owner": "zhangsan"
    }
  }
}
```。

### 非管理カスタムオブジェクトと DataWorks 収集済みテーブル

> このアプローチは主にレガシー使用との後方互換性のためであり、推奨されなくなりました。新しい統合には、先に `CreateMetaEntityDef` と `BatchCreateMetaEntities` を使用してカスタムエンティティオブジェクトを登録し、返されたエンティティ `Id` を使用してリネージを登録してください。

```json
{
  "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-タスク",
    "Attributes": {
      "scene": "report_to_table"
    }
  }
}
```。