Lineage - Get Next Page

Servicio:

Purview

Versión de la API:

2023-09-01

Devolver información de linaje de página siguiente inmediata sobre la entidad con paginación

GET {endpoint}/datamap/api/lineage/{guid}/next?api-version=2023-09-01&direction={direction}

Con parámetros opcionales:

GET {endpoint}/datamap/api/lineage/{guid}/next?api-version=2023-09-01&direction={direction}&offset={offset}&limit={limit}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string
guid	path	True	string	Identificador único global de la entidad.
api-version	query	True	string	Versión de API que se usará para la operación.
direction	query	True	LineageDirection	Dirección del linaje, que podría ser INPUT, OUTPUT o BOTH.
limit	query		integer int32	Tamaño de página: de forma predeterminada, no hay paginación.
offset	query		integer int32	Desplazamiento con fines de paginación.

Respuestas

Nombre	Tipo	Description
200 OK	AtlasLineageInfo	La solicitud se ha realizado correctamente.
Other Status Codes	AtlasErrorResponse	Una respuesta de error inesperada.

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

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

Ejemplos

Lineage_GetNextPage

Solicitud de ejemplo

HTTP

GET {endpoint}/datamap/api/lineage/a6894eb3-81f3-829b-2adc-52f3e603411a/next?api-version=2023-09-01&direction=INPUT&offset=0&limit=5

Respuesta de muestra

status code:

200

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

Definiciones

Nombre	Description
AtlasClassification	Instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.
AtlasEntityHeader	Instancia de una entidad, como hive_table, hive_database.
AtlasErrorResponse	Una respuesta de error del servicio
AtlasLineageInfo	Información de linaje.
AtlasTermAssignmentHeader	Encabezado de asignación de términos.
AtlasTermAssignmentStatus	Estado de la asignación de términos
EntityStatus	Estado: se puede activar o eliminar
LineageDirection	Dirección del linaje
LineageRelation	Relación de linaje con el GUID de de y a la entidad.
ParentRelation	Relación de los elementos primarios de linaje con el GUID de la entidad primaria y de la entidad secundaria.
TimeBoundary	Captura los detalles del límite de tiempo.

AtlasClassification

Instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.

Nombre	Tipo	Description
attributes		Atributos de la estructura.
entityGuid	string	GUID de la entidad.
entityStatus	EntityStatus	Estado de la entidad: se puede activar o eliminar. Las entidades eliminadas no se quitan.
lastModifiedTS	string	ETag para el control de simultaneidad.
removePropagationsOnEntityDelete	boolean	Determina si las propagaciones se quitarán en la eliminación de entidades.
typeName	string	Nombre del tipo.
validityPeriods	TimeBoundary[]	Matriz de límites de tiempo que indican períodos de validez.

AtlasEntityHeader

Instancia de una entidad, como hive_table, hive_database.

Nombre	Tipo	Description
attributes		Atributos de la estructura.
classificationNames	string[]	Matriz de nombres de clasificación.
classifications	AtlasClassification[]	Matriz de clasificaciones.
displayText	string	Texto que se muestra.
guid	string	GUID del registro.
isIncomplete	boolean	Si es una entidad de shell
labels	string[]	labels
lastModifiedTS	string	ETag para el control de simultaneidad.
meaningNames	string[]	Matriz de significados.
meanings	AtlasTermAssignmentHeader[]	Matriz de encabezados de asignación de términos.
status	EntityStatus	Estado de la entidad: se puede activar o eliminar. Las entidades eliminadas no se quitan.
typeName	string	Nombre del tipo.

AtlasErrorResponse

Una respuesta de error del servicio

Nombre	Tipo	Description
errorCode	string	Código de error.
errorMessage	string	El mensaje de error.
requestId	string	El identificador de solicitud.

AtlasLineageInfo

Información de linaje.

Nombre	Tipo	Description
baseEntityGuid	string	GUID de la entidad base.
childrenCount	integer	Número de nodos secundarios.
guidEntityMap	<string,  AtlasEntityHeader>	Mapa de entidades GUID.
lineageDepth	integer	Profundidad del linaje.
lineageDirection	LineageDirection	Enumeración de la dirección del linaje.
lineageWidth	integer	Ancho del linaje.
parentRelations	ParentRelation[]	Matriz de relaciones parentRelations.
relations	LineageRelation[]	Matriz de relaciones de linaje.
widthCounts	object	Recuento de entidades en dirección específica.

AtlasTermAssignmentHeader

Encabezado de asignación de términos.

Nombre	Tipo	Description
confidence	integer	Confianza de la asignación de términos.
createdBy	string	Usuario que creó el registro.
description	string	Descripción de la asignación de términos.
displayText	string	Texto que se muestra.
expression	string	Expresión de la asignación de términos.
relationGuid	string	GUID de la relación.
status	AtlasTermAssignmentStatus	Estado de la asignación de términos.
steward	string	Administrador del término.
termGuid	string	GUID del término.

AtlasTermAssignmentStatus

Estado de la asignación de términos

Nombre	Tipo	Description
DEPRECATED	string	El estado está en desuso.
DISCOVERED	string	El estado se detecta.
IMPORTED	string	El estado se importa.
OBSOLETE	string	El estado está obsoleto.
OTHER	string	Otro estado.
PROPOSED	string	Se propone el estado.
VALIDATED	string	El estado se valida.

EntityStatus

Estado: se puede activar o eliminar

Nombre	Tipo	Description
ACTIVE	string	El estado está activo.
DELETED	string	El estado se elimina.

LineageDirection

Dirección del linaje

Nombre	Tipo	Description
BOTH	string	Ambos
INPUT	string	input
OUTPUT	string	output

LineageRelation

Relación de linaje con el GUID de de y a la entidad.

Nombre	Tipo	Description
fromEntityId	string	GUID de from-entity.
relationshipId	string	GUID de relación.
toEntityId	string	GUID de a entidad.

ParentRelation

Relación de los elementos primarios de linaje con el GUID de la entidad primaria y de la entidad secundaria.

Nombre	Tipo	Description
childEntityId	string	GUID de la entidad secundaria.
parentEntityId	string	GUID de la entidad primaria.
relationshipId	string	GUID de relación.

TimeBoundary

Captura los detalles del límite de tiempo.

Nombre	Tipo	Description
endTime	string	Fin del límite de tiempo.
startTime	string	Inicio del límite de tiempo.
timeZone	string	Zona horaria del límite de tiempo.