Entity - Bulk Create Or Update

Servicio:: Purview

Versión de la API:: 2023-09-01

Cree o actualice entidades de forma masiva. La entidad existente coincide con su guid único si se proporciona o por sus atributos únicos, por ejemplo: qualifiedName. No se admiten la asignación ni la matriz de colecciones. Por ejemplo, matriz<int, matriz<de matriz cadena>>,<<int>>. Para cada tipo de contacto, el número máximo de contactos es 20.

POST {endpoint}/datamap/api/atlas/v2/entity/bulk

Con parámetros opcionales:

POST {endpoint}/datamap/api/atlas/v2/entity/bulk?api-version=2023-09-01&collectionId={collectionId}&businessAttributeUpdateBehavior={businessAttributeUpdateBehavior}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)
api-version	query		string minLength: 1	Versión de la API que se va a usar para esta operación.
businessAttributeUpdateBehavior	query		BusinessAttributeUpdateBehavior	Se usa para definir el comportamiento de actualización de los atributos empresariales al actualizar entidades.
collectionId	query		string	Colección a la que se moverán las entidades. Especifique solo un valor si necesita mover una entidad a otra colección.

Cuerpo de la solicitud

Nombre	Tipo	Description
entities	AtlasEntity[]	Matriz de entidades.
referredEntities	<string, AtlasEntity>	Las entidades a las que se hace referencia.

Respuestas

Nombre	Tipo	Description
200 OK	EntityMutationResult	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

Entity_BulkCreateOrUpdate

Solicitud de ejemplo

HTTP

POST {endpoint}/datamap/api/atlas/v2/entity/bulk?api-version=2023-09-01

{
  "referredEntities": {},
  "entities": [
    {
      "typeName": "azure_storage_account",
      "attributes": {
        "owner": "ExampleOwner",
        "modifiedTime": 0,
        "createTime": 0,
        "qualifiedName": "exampleaccount1",
        "name": "ExampleStorageAccount1",
        "description": null,
        "publicAccessLevel": null
      },
      "contacts": {
        "Expert": [
          {
            "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
            "info": "Example Expert Info"
          }
        ],
        "Owner": [
          {
            "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
            "info": "Example Owner Info"
          }
        ]
      },
      "status": "ACTIVE",
      "createdBy": "ExampleCreator",
      "updatedBy": "ExampleUpdator",
      "version": 0
    },
    {
      "typeName": "azure_storage_account",
      "attributes": {
        "owner": "ExampleOwner",
        "modifiedTime": 0,
        "createTime": 0,
        "qualifiedName": "exampleaccount2",
        "name": "ExampleStorageAccount2",
        "description": "Example Description",
        "publicAccessLevel": null
      },
      "contacts": {
        "Expert": [
          {
            "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
            "info": "Example Expert Info"
          }
        ],
        "Owner": [
          {
            "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
            "info": "Example Owner Info"
          }
        ]
      },
      "status": "ACTIVE",
      "createdBy": "ExampleCreator",
      "updatedBy": "ExampleUpdator",
      "version": 0
    }
  ]
}

Respuesta de muestra

status code:: 200

{
  "mutatedEntities": {
    "UPDATE": [
      {
        "typeName": "azure_storage_account",
        "attributes": {
          "qualifiedName": "exampleaccount2"
        },
        "lastModifiedTS": "2",
        "guid": "b2f9c306-cf65-4bb0-878e-cfaafde156b1",
        "status": "ACTIVE"
      }
    ],
    "CREATE": [
      {
        "typeName": "azure_storage_account",
        "attributes": {
          "qualifiedName": "exampleaccount1"
        },
        "lastModifiedTS": "1",
        "guid": "321493e3-3fb7-4b3e-9df7-3b69154174c2",
        "status": "ACTIVE"
      }
    ]
  },
  "guidAssignments": {
    "-9514774903018192": "321493e3-3fb7-4b3e-9df7-3b69154174c2",
    "-9514774903018193": "b2f9c306-cf65-4bb0-878e-cfaafde156b1"
  }
}

Definiciones

Nombre	Description
AtlasClassification	Una instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.
AtlasEntitiesWithExtInfo	Instancia de una entidad junto con información extendida, como hive_table, hive_database.
AtlasEntity	Instancia de una entidad, como hive_table, hive_database.
AtlasEntityHeader	Instancia de una entidad, como hive_table, hive_database.
AtlasErrorResponse	Respuesta de error del servicio
AtlasTermAssignmentHeader	Encabezado para la asignación de términos.
AtlasTermAssignmentStatus	Estado de la asignación de términos
BusinessAttributeUpdateBehavior	Se usa para definir el comportamiento de actualización de los atributos empresariales al actualizar entidades.
EntityMutationResult	Resultado de la respuesta de mutación de la entidad.
EntityStatus	Estado: se puede activar o eliminar.
TimeBoundary	Captura los detalles del límite de tiempo

AtlasClassification

Object

Una 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 se quitarán las propagaciones en la eliminación de entidades.
typeName	string	Nombre del tipo.
validityPeriods	TimeBoundary[]	Matriz de límites de tiempo que indica períodos de validez.

AtlasEntitiesWithExtInfo

Object

Instancia de una entidad junto con información extendida, como hive_table, hive_database.

Nombre	Tipo	Description
entities	AtlasEntity[]	Matriz de entidades.
referredEntities	<string, AtlasEntity>	Las entidades a las que se hace referencia.

AtlasEntity

Object

Instancia de una entidad, como hive_table, hive_database.

Nombre	Tipo	Description
attributes		Atributos de la estructura.
businessAttributes		Atributos empresariales
classifications	AtlasClassification[]	Matriz de clasificaciones.
collectionId	string	Identificador de colección de la entidad.
contacts	object	Diccionario de contactos para entidades. La clave podría ser experto o propietario.
createTime	integer (int64)	Hora de creación del registro.
createdBy	string	Usuario que creó el registro.
customAttributes	object	Atributo personalizado
guid	string	GUID de la entidad.
homeId	string	Identificador de inicio de la entidad.
isIncomplete	boolean	Si es una entidad de shell
labels	string[]	Etiquetas
lastModifiedTS	string	ETag para el control de simultaneidad.
meanings	AtlasTermAssignmentHeader[]	Matriz de encabezados de asignación de términos que indican los significados de la entidad.
provenanceType	integer (int32)	Se usa para registrar la procedencia de una instancia de una entidad o relación.
proxy	boolean	Determina si hay un proxy.
relationshipAttributes		Atributos de la relación.
status	EntityStatus	Estado de la entidad: se puede activar o eliminar. Las entidades eliminadas no se quitan.
typeName	string	Nombre del tipo.
updateTime	integer (int64)	Hora de actualización del registro.
updatedBy	string	Usuario que actualizó el registro.
version	integer (int64)	Versión de la entidad.

AtlasEntityHeader

Object

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 para mostrar.
guid	string	GUID del registro.
isIncomplete	boolean	Si es una entidad de shell
labels	string[]	Etiquetas
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

Object

Respuesta de error del servicio

Nombre	Tipo	Description
errorCode	string	Código de error.
errorMessage	string	Mensaje de error.
requestId	string (uuid)	Identificador de solicitud.

AtlasTermAssignmentHeader

Object

Encabezado para la asignación de términos.

Nombre	Tipo	Description
confidence	integer (int32)	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 para mostrar.
expression	string	Expresión de la asignación de términos.
relationGuid	string (uuid)	GUID de la relación.
status	AtlasTermAssignmentStatus	Estado de la asignación de términos.
steward	string	El administrador del término.
termGuid	string (uuid)	GUID del término.

AtlasTermAssignmentStatus

Enumeración

Estado de la asignación de términos

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

BusinessAttributeUpdateBehavior

Enumeración

Se usa para definir el comportamiento de actualización de los atributos empresariales al actualizar entidades.

Valor	Description
ignore	Omita la carga del atributo empresarial para la actualización.
replace	Reemplace todos los atributos empresariales mediante la carga útil.
merge	Combine los atributos empresariales. Los atributos empresariales no se actualizarán si no se proporcionan.

EntityMutationResult

Object

Resultado de la respuesta de mutación de la entidad.

Nombre	Tipo	Description
guidAssignments	object	Mapa de asignaciones GUID con entidades.
mutatedEntities	object	Encabezados de entidad de entidades mutadas.
partialUpdatedEntities	AtlasEntityHeader[]	Matriz de encabezados de entidad que se actualizan parcialmente.

EntityStatus

Enumeración

Estado: se puede activar o eliminar.

Valor	Description
ACTIVE	El estado está activo.
DELETED	El estado se elimina.

TimeBoundary

Object

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 hora.
timeZone	string	Zona horaria del límite horario.

Compartir a través de

Entity - Bulk Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

OAuth2Auth

Ámbitos

Ejemplos

Entity_BulkCreateOrUpdate

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AtlasClassification

AtlasEntitiesWithExtInfo

AtlasEntity

AtlasEntityHeader

AtlasErrorResponse

AtlasTermAssignmentHeader

AtlasTermAssignmentStatus

BusinessAttributeUpdateBehavior

EntityMutationResult

EntityStatus

TimeBoundary