DataWorks:CreateLineageRelationship

1. Diperlukan DataWorks Professional Edition atau edisi yang lebih tinggi.

Objek entitas (SrcEntity / DstEntity)

Menjelaskan sumber dan tujuan dari hubungan lineage. Anda dapat mendaftarkan hubungan lineage antara jenis entitas berikut:

Catatan tambahan:

• Untuk tabel, kolom, dataset, dan versi dataset yang sudah dikumpulkan oleh DataWorks, jangan membuat Id secara manual. Gunakan Id yang dikembalikan oleh API Get atau List yang sesuai.

• Untuk objek kustom, gunakan pendekatan objek entitas kustom yang didaftarkan pengguna. Selesaikan definisi entitas dan pendaftaran objek entitas terlebih dahulu:

  1. Panggil CreateMetaEntityDef untuk membuat definisi entitas kustom.

  2. Panggil BatchCreateMetaEntities untuk membuat objek entitas tertentu.

  3. Gunakan Id entitas yang dikembalikan oleh BatchCreateMetaEntities sebagai SrcEntity.Id atau DstEntity.Id.

• Untuk objek kustom non-terkelola, Anda tidak perlu memanggil CreateMetaEntityDef atau BatchCreateMetaEntities. Cukup masukkan Id entitas dengan awalan custom- dan tentukan Name. Pendekatan ini terutama untuk kompatibilitas mundur dengan skenario lama dan tidak lagi direkomendasikan. Untuk integrasi baru, gunakan pendekatan objek entitas kustom yang terdaftar untuk kemudahan kueri, pengelolaan, dan ekstensi atribut kustom.

• SrcEntity.Attributes dan DstEntity.Attributes mewakili atribut ekstensi dari endpoint entitas. Tempatkan atribut dari hubungan lineage itu sendiri di Task.Attributes.

Informasi tugas (Task)

Menjelaskan pekerjaan atau tugas yang menghasilkan hubungan lineage.

Contoh permintaan.

Tabel yang dikumpulkan DataWorks dan objek entitas kustom

{
  "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"
    }
  }
}
```.

### Objek kustom non-terkelola dan tabel yang dikumpulkan DataWorks

> Pendekatan ini terutama untuk kompatibilitas mundur dengan penggunaan lama dan tidak lagi direkomendasikan. Untuk integrasi baru, daftarkan objek entitas kustom dengan menggunakan `CreateMetaEntityDef` dan `BatchCreateMetaEntities` terlebih dahulu, lalu gunakan `Id` entitas yang dikembalikan untuk mendaftarkan lineage.

```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-task",
    "Attributes": {
      "scene": "report_to_table"
    }
  }
}
```.