Lineage - Get

Referenz

Dienst:: Purview

API-Version:: 2023-09-01

Rufen Sie die Herkunftsinformationen der von der GUID angegebenen Entität ab.

GET {endpoint}/datamap/api/atlas/v2/lineage/{guid}?direction={direction}

Mit optionalen Parametern:

GET {endpoint}/datamap/api/atlas/v2/lineage/{guid}?depth={depth}&direction={direction}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string
guid	path	True	string	Der global eindeutige Bezeichner der Entität.
direction	query	True	LineageDirection	Die Richtung der Herkunft, die INPUT, OUTPUT oder BOTH sein kann.
depth	query		integer int32	Die Anzahl der Hops für die Herkunft.

Antworten

Name	Typ	Beschreibung
200 OK	AtlasLineageInfo	Die Anforderung wurde erfolgreich durchgeführt.
Other Status Codes	AtlasErrorResponse	Eine unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

Lineage_Get

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
AtlasClassification	Ein instance einer Klassifizierung. Es verfügt über keine Identität, dieses Objekt ist nur vorhanden, wenn es einer Entität zugeordnet ist.
AtlasEntityHeader	Ein instance einer Entität – z. B. hive_table, hive_database.
AtlasErrorResponse	Eine Fehlerantwort des Diensts
AtlasLineageInfo	Die Herkunftsinformationen.
AtlasTermAssignmentHeader	Der Header für die Ausdruckszuweisung.
AtlasTermAssignmentStatus	Status für Begriffszuweisung
EntityStatus	Status: kann aktiv oder gelöscht werden
LineageDirection	Herkunftsrichtung
LineageRelation	Die Herkunftsbeziehung mit der GUID der von und zur Entität.
ParentRelation	Die Beziehung der Stammeltern mit der GUID der übergeordneten Entität und der untergeordneten Entität.
TimeBoundary	Erfasst Details zur Zeitgrenze

AtlasClassification

Ein instance einer Klassifizierung. Es verfügt über keine Identität, dieses Objekt ist nur vorhanden, wenn es einer Entität zugeordnet ist.

Name	Typ	Beschreibung
attributes		Die Attribute der Struktur.
entityGuid	string	Die GUID der Entität.
entityStatus	EntityStatus	Status der Entität – kann aktiv oder gelöscht sein. Gelöschte Entitäten werden nicht entfernt.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
removePropagationsOnEntityDelete	boolean	Bestimmt, ob Weitergaben beim Löschen von Entitäten entfernt werden.
typeName	string	Der Name des Typs.
validityPeriods	TimeBoundary[]	Ein Array von Zeitgrenzen, die Gültigkeitsdauern angeben.

AtlasEntityHeader

Ein instance einer Entität – z. B. hive_table, hive_database.

Name	Typ	Beschreibung
attributes		Die Attribute der Struktur.
classificationNames	string[]	Ein Array von Klassifizierungsnamen.
classifications	AtlasClassification[]	Ein Array von Klassifizierungen.
displayText	string	Der Anzeigetext.
guid	string	Die GUID des Datensatzes.
isIncomplete	boolean	Gibt an, ob es sich um eine Shellentität handelt
labels	string[]	Bezeichnungen
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
meaningNames	string[]	Ein Array von Bedeutungen.
meanings	AtlasTermAssignmentHeader[]	Ein Array von Begriffszuweisungsheadern.
status	EntityStatus	Status der Entität – kann aktiv oder gelöscht sein. Gelöschte Entitäten werden nicht entfernt.
typeName	string	Der Name des Typs.

AtlasErrorResponse

Eine Fehlerantwort des Diensts

Name	Typ	Beschreibung
errorCode	string	Der Fehlercode.
errorMessage	string	Die Fehlermeldung.
requestId	string	Die Anforderungs-ID.

AtlasLineageInfo

Die Herkunftsinformationen.

Name	Typ	Beschreibung
baseEntityGuid	string	Die GUID der Basisentität.
childrenCount	integer	Die Anzahl der untergeordneten Knoten.
guidEntityMap	<string, AtlasEntityHeader>	Die GUID-Entitätszuordnung.
lineageDepth	integer	Die Tiefe der Herkunft.
lineageDirection	LineageDirection	Die Enumeration der Herkunftsrichtung.
lineageWidth	integer	Die Breite der Herkunft.
parentRelations	ParentRelation[]	Ein Array von parentRelations-Beziehungen.
relations	LineageRelation[]	Ein Array von Herkunftsbeziehungen.
widthCounts	object	Die Entitätsanzahl in eine bestimmte Richtung.

AtlasTermAssignmentHeader

Der Header für die Ausdruckszuweisung.

Name	Typ	Beschreibung
confidence	integer	Die Konfidenz der Begriffszuweisung.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
description	string	Die Beschreibung der Begriffszuweisung.
displayText	string	Der Anzeigetext.
expression	string	Der Ausdruck des Begriffs Zuweisung.
relationGuid	string	Die GUID der Beziehung.
status	AtlasTermAssignmentStatus	Die status der Begriffszuweisung.
steward	string	Der Steward des Begriffs.
termGuid	string	Die GUID des Begriffs.

AtlasTermAssignmentStatus

Status für Begriffszuweisung

Name	Typ	Beschreibung
DEPRECATED	string	Die status ist veraltet.
DISCOVERED	string	Die status wird ermittelt.
IMPORTED	string	Die status wird importiert.
OBSOLETE	string	Die status ist veraltet.
OTHER	string	Andere status.
PROPOSED	string	Die status wird vorgeschlagen.
VALIDATED	string	Die status wird überprüft.

EntityStatus

Status: kann aktiv oder gelöscht werden

Name	Typ	Beschreibung
ACTIVE	string	Die status ist aktiv.
DELETED	string	Die status wird gelöscht.

LineageDirection

Herkunftsrichtung

Name	Typ	Beschreibung
BOTH	string	beide
INPUT	string	input
OUTPUT	string	output

LineageRelation

Die Herkunftsbeziehung mit der GUID der von und zur Entität.

Name	Typ	Beschreibung
fromEntityId	string	Die GUID von der Entität.
relationshipId	string	Die GUID der Beziehung.
toEntityId	string	Die GUID der Entität.

ParentRelation

Die Beziehung der Stammeltern mit der GUID der übergeordneten Entität und der untergeordneten Entität.

Name	Typ	Beschreibung
childEntityId	string	Die GUID der untergeordneten Entität.
parentEntityId	string	Die GUID der übergeordneten Entität.
relationshipId	string	Die GUID der Beziehung.

TimeBoundary

Erfasst Details zur Zeitgrenze

Name	Typ	Beschreibung
endTime	string	Das Ende der Zeitgrenze.
startTime	string	Der Beginn der Zeitgrenze.
timeZone	string	Die Zeitzone der Zeitgrenze.

Freigeben über