다음을 통해 공유

Lineage - Get

서비스:
Purview
API 버전:
2023-09-01

GUID로 지정된 엔터티의 계보 정보를 가져옵니다.

GET {endpoint}/datamap/api/atlas/v2/lineage/{guid}?direction={direction}
선택적 매개 변수: 
GET {endpoint}/datamap/api/atlas/v2/lineage/{guid}?depth={depth}&direction={direction}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
 path True

string (uri)

guid
 path True

string

엔터티의 전역적으로 고유한 식별자입니다.
direction
 query True

LineageDirection

입력, 출력 또는 둘 다일 수 있는 계보의 방향입니다.
depth
 query

integer (int32)

계보의 홉 수입니다.

응답

Name 형식 Description
200 OK

AtlasLineageInfo

요청이 성공했습니다.
Other Status Codes

AtlasErrorResponse

예기치 않은 오류 응답입니다.

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
https://purview.azure.net/.default

예제

Lineage_Get

샘플 요청

GET {endpoint}/datamap/api/atlas/v2/lineage/a6894eb3-81f3-829b-2adc-52f3e603411a?depth=1&direction=INPUT

샘플 응답

상태 코드:
200 
{
  "baseEntityGuid": "a6894eb3-81f3-829b-2adc-52f3e603411a",
  "lineageDirection": "INPUT",
  "lineageDepth": 1,
  "lineageWidth": 1,
  "childrenCount": 1,
  "guidEntityMap": {},
  "widthCounts": {},
  "relations": [],
  "parentRelations": []
}

정의

Name Description
AtlasClassification

분류의 인스턴스입니다. ID가 없습니다. 이 개체는 엔터티와 연결된 경우에만 존재합니다.
AtlasEntityHeader

엔터티 인스턴스(예: hive_table, hive_database)
AtlasErrorResponse

서비스의 오류 응답
AtlasLineageInfo

계보 정보입니다.
AtlasTermAssignmentHeader

용어 할당의 헤더입니다.
AtlasTermAssignmentStatus

용어 할당 상태
EntityStatus

상태 - 활성 또는 삭제 가능
LineageDirection

계보 방향
LineageRelation

원본 및 엔터티의 GUID를 사용하는 계보 관계입니다.
ParentRelation

부모 엔터티 및 자식 엔터티의 GUID와 계보 부모 관계입니다.
TimeBoundary

시간 경계 세부 정보를 캡처합니다.

AtlasClassification

Object

분류의 인스턴스입니다. ID가 없습니다. 이 개체는 엔터티와 연결된 경우에만 존재합니다.

Name 형식 Description
attributes

구조체의 특성입니다.
entityGuid

string

엔터티의 GUID입니다.
entityStatus

EntityStatus

엔터티의 상태 - 활성 또는 삭제할 수 있습니다. 삭제된 엔터티는 제거되지 않습니다.
lastModifiedTS

string

동시성 제어를 위한 ETag입니다.
removePropagationsOnEntityDelete

boolean

엔터티 삭제 시 전파가 제거될지 여부를 결정합니다.
typeName

string

형식의 이름입니다.
validityPeriods

TimeBoundary[]

유효 기간을 나타내는 시간 경계의 배열입니다.

AtlasEntityHeader

Object

엔터티 인스턴스(예: hive_table, hive_database)

Name 형식 Description
attributes

구조체의 특성입니다.
classificationNames

string[]

분류 이름의 배열입니다.
classifications

AtlasClassification[]

분류의 배열입니다.
displayText

string

표시 텍스트입니다.
guid

string

레코드의 GUID입니다.
isIncomplete

boolean

셸 엔터티인지 여부
labels

string[]

레이블
lastModifiedTS

string

동시성 제어를 위한 ETag입니다.
meaningNames

string[]

의미의 배열입니다.
meanings

AtlasTermAssignmentHeader[]

용어 할당 헤더의 배열입니다.
status

EntityStatus

엔터티의 상태 - 활성 또는 삭제할 수 있습니다. 삭제된 엔터티는 제거되지 않습니다.
typeName

string

형식의 이름입니다.

AtlasErrorResponse

Object

서비스의 오류 응답

Name 형식 Description
errorCode

string

오류 코드입니다.
errorMessage

string

오류 메시지입니다.
requestId

string (uuid)

요청 ID입니다.

AtlasLineageInfo

Object

계보 정보입니다.

Name 형식 Description
baseEntityGuid

string

기본 엔터티의 GUID입니다.
childrenCount

integer (int32)

자식 노드의 수입니다.
guidEntityMap

<string,  AtlasEntityHeader>

GUID 엔터티 맵입니다.
lineageDepth

integer (int32)

계보의 깊이입니다.
lineageDirection

LineageDirection

계보 방향의 열거형입니다.
lineageWidth

integer (int32)

계보의 너비입니다.
parentRelations

ParentRelation[]

parentRelations 관계의 배열입니다.
relations

LineageRelation[]

계보 관계의 배열입니다.
widthCounts

object

엔터티 개수는 특정 방향으로 계산됩니다.

AtlasTermAssignmentHeader

Object

용어 할당의 헤더입니다.

Name 형식 Description
confidence

integer (int32)

용어 할당의 신뢰도입니다.
createdBy

string

레코드를 만든 사용자입니다.
description

string

용어 할당에 대한 설명입니다.
displayText

string

표시 텍스트입니다.
expression

string

용어 할당의 식입니다.
relationGuid

string (uuid)

관계의 GUID입니다.
status

AtlasTermAssignmentStatus

조건 할당의 상태입니다.
steward

string

용어의 청지기입니다.
termGuid

string (uuid)

용어의 GUID입니다.

AtlasTermAssignmentStatus

열거형

용어 할당 상태

값 Description
DISCOVERED

상태가 검색됩니다.
PROPOSED

상태가 제안됩니다.
IMPORTED

상태를 가져옵니다.
VALIDATED

상태의 유효성이 검사됩니다.
DEPRECATED

상태는 더 이상 사용되지 않습니다.
OBSOLETE

상태가 사용되지 않습니다.
OTHER

기타 상태입니다.

EntityStatus

열거형

상태 - 활성 또는 삭제 가능

값 Description
ACTIVE

상태가 활성 상태입니다.
DELETED

상태가 삭제됩니다.

LineageDirection

열거형

계보 방향

값 Description
INPUT

입력
OUTPUT

출력
BOTH

둘 다

LineageRelation

Object

원본 및 엔터티의 GUID를 사용하는 계보 관계입니다.

Name 형식 Description
fromEntityId

string

엔터티의 GUID입니다.
relationshipId

string

관계의 GUID입니다.
toEntityId

string

엔터티에 대한 GUID입니다.

ParentRelation

Object

부모 엔터티 및 자식 엔터티의 GUID와 계보 부모 관계입니다.

Name 형식 Description
childEntityId

string

자식 엔터티의 GUID입니다.
parentEntityId

string

부모 엔터티의 GUID입니다.
relationshipId

string

관계의 GUID입니다.

TimeBoundary

Object

시간 경계 세부 정보를 캡처합니다.

Name 형식 Description
endTime

string

시간 경계의 끝입니다.
startTime

string

시간 경계의 시작입니다.
timeZone

string

시간 경계의 표준 시간대입니다.