DataWorks:CreateLineageRelationship

1. É necessário o DataWorks Professional Edition ou uma edição superior.

Objeto de entidade (SrcEntity / DstEntity)

Descreve a origem e o destino de uma relação de linhagem. Você pode registrar relações de linhagem entre os seguintes tipos de entidades:

Notas adicionais:

• Para tabelas, colunas, conjuntos de dados e versões de conjuntos de dados já coletados pelo DataWorks, recomendamos que você evite construir manualmente o Id e, em vez disso, use o Id retornado pela API Get ou List correspondente.

• Para objetos personalizados, recomendamos que você use a abordagem de objeto de entidade personalizado registrado pelo usuário. Conclua primeiro a definição da entidade e o registro do objeto de entidade:

  1. Chame CreateMetaEntityDef para criar uma definição de entidade personalizada.

  2. Chame BatchCreateMetaEntities para criar objetos de entidade específicos.

  3. Use o Id da entidade retornado por BatchCreateMetaEntities como SrcEntity.Id ou DstEntity.Id.

• Para objetos personalizados não gerenciados, você não precisa chamar CreateMetaEntityDef ou BatchCreateMetaEntities. Basta passar um Id de entidade com o prefixo custom- e especificar o Name. Esta abordagem é principalmente para compatibilidade com versões anteriores de cenários legados e não é mais recomendada. Para novas integrações, use a abordagem de objeto de entidade personalizado registrado para facilitar a consulta, o gerenciamento e a extensão de atributos personalizados.

• SrcEntity.Attributes e DstEntity.Attributes representam atributos estendidos dos pontos de extremidade da entidade. Coloque os atributos da própria relação de linhagem em Task.Attributes.

Informações da tarefa (Task)

Descreve o job ou tarefa que produz a relação de linhagem.

Exemplos de solicitação.

Tabela coletada pelo DataWorks e objeto de entidade personalizado

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

Objeto personalizado não gerenciado e tabela coletada pelo 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"
    }
  }
}