Todos os produtos
Search
Central de documentação

DataWorks:RegisterLineageRelation

Última atualização: Jun 28, 2026

Registra a linhagem entre entidades autogerenciadas no DataWorks.

Descrição da operação

Esta operação de API está atualmente em fase de testes. Os usuários que desejarem testá-la podem enviar uma solicitação. Após o administrador adicionar o usuário à lista de testes, ele poderá chamar esta operação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

LineageRelationRegisterVO LineageRelationRegisterVO

Sim

A estrutura cuja linhagem você deseja registrar no DataWorks.

Formato do identificador exclusivo da entidade: EntityType.EntityGuid.

1: EntityType identifica o tipo de entidade
    1.1 Tipos de entidade disponíveis no DataWorks
        (1) Tabela do MaxCompute: maxcompute-table
        (2) Tabela do MySQL: mysql-table
        (3) Tabela do EMR: emr-table
        (4) Tabela do Hologres: holodb-table

    1.2 Tipos de entidade personalizados: custom-xxx
       Os seguintes tipos são recomendados com base nos requisitos do usuário
        (1) Tabela: custom-table
        (2) API: custom-api
        (3) Aplicativo: custom-app
        (4) Relatório: custom-report
        (5) Conjunto de dados: custom-dataset
        (6) Fonte de dados: custom-datasource

2: EntityGuid: Um identificador exclusivo para a entidade dentro do mesmo tipo de entidade
    Os usuários podem definir seu próprio ID exclusivo para entidades personalizadas.

3: Exemplos de entidades:
    3.1: Entidades de sistema integradas do DataWorks, que podem ser visualizadas no gráfico de linhagem na página Mapa de Dados
        (1) maxcompute-table.project.tableName  representa o ID exclusivo de uma tabela do MaxCompute
        (2) emr-table.kadfdfaccdd4ted   representa o ID exclusivo de uma tabela do EMR
    3.2: Entidades personalizadas: Os usuários definem seu próprio ID exclusivo com base em seus requisitos de negócios (dentro de 50 bytes)
        (1) custom-api.listUser   representa uma entidade de API personalizada com o identificador exclusivo listUser
        (2) custom-table.db1.table2  representa uma entidade de tabela personalizada com o identificador exclusivo db1.table2

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

OpenApiMetaResultModel.

HttpStatusCode

integer

O código de status HTTP.

200

ErrorMessage

string

A mensagem de erro.

The entity of lineage not exist, xxx

RequestId

string

O ID da solicitação. Você pode localizar logs e solucionar problemas com base no ID.

EE50E05E-028C-182B-****

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true

  • false

true

ErrorCode

string

O código de erro.

1010210001

LineageRelation

object

A linhagem.

SrcEntityQualifiedName

string

O identificador exclusivo da entidade de origem.

maxcompute-table.project.table

DestEntityQualifiedName

string

O identificador exclusivo da entidade de destino.

custom-report.month_stat_user

RelationshipGuid

string

O ID da linhagem entre entidades.

dfsldfdlsfdsaaaabbbb

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The entity of lineage not exist, xxx",
  "RequestId": "EE50E05E-028C-182B-****",
  "Success": true,
  "ErrorCode": "1010210001",
  "LineageRelation": {
    "SrcEntityQualifiedName": "maxcompute-table.project.table",
    "DestEntityQualifiedName": "custom-report.month_stat_user",
    "RelationshipGuid": "dfsldfdlsfdsaaaabbbb"
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.