Entity - Bulk Create Or Update

Referência

Serviço:: Purview

Versão da API:: 2023-09-01

Criar ou atualizar entidades em massa. A entidade existente é correspondida usando seu guid exclusivo se fornecida ou por seus atributos exclusivos, por exemplo: qualifiedName. Não há suporte para o mapa e a matriz de coleções. Por exemplo, matriz<matriz>, matriz<cadeia de<de mapa, int>>. Para cada tipo de contato, o número máximo de contatos é 20.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string (uri)
api-version	query		string minLength: 1	A versão da API a ser usada para esta operação.
businessAttributeUpdateBehavior	query		BusinessAttributeUpdateBehavior	Usado para definir o comportamento de atualização para atributos de negócios ao atualizar entidades.
collectionId	query		string	A coleção para a qual as entidades serão movidas. Especifique apenas um valor se precisar mover uma entidade para outra coleção.

Corpo da solicitação

Nome	Tipo	Description
entities	AtlasEntity[]	Uma matriz de entidades.
referredEntities	<string, AtlasEntity>	As entidades mencionadas.

Respostas

Nome	Tipo	Description
200 OK	EntityMutationResult	A solicitação foi bem-sucedida.
Other Status Codes	AtlasErrorResponse	Uma resposta de erro inesperada.

Segurança

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

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

Exemplos

Entity_BulkCreateOrUpdate

Solicitação de exemplo

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
    }
  ]
}

Resposta de exemplo

Código de status:: 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"
  }
}

Definições

Nome	Description
AtlasClassification	Uma instância de uma classificação; ele não tem uma identidade, esse objeto existe somente quando associado a uma entidade.
AtlasEntitiesWithExtInfo	Uma instância de uma entidade juntamente com informações estendidas , como hive_table, hive_database.
AtlasEntity	Uma instância de uma entidade , como hive_table, hive_database.
AtlasEntityHeader	Uma instância de uma entidade , como hive_table, hive_database.
AtlasErrorResponse	Uma resposta de erro do serviço
AtlasTermAssignmentHeader	O cabeçalho da atribuição de termo.
AtlasTermAssignmentStatus	Status da atribuição de termos
BusinessAttributeUpdateBehavior	Usado para definir o comportamento de atualização para atributos de negócios ao atualizar entidades.
EntityMutationResult	O resultado da resposta de mutação da entidade.
EntityStatus	Status – pode ser ativo ou excluído
TimeBoundary	Captura detalhes de limite de tempo

AtlasClassification

Objeto

Uma instância de uma classificação; ele não tem uma identidade, esse objeto existe somente quando associado a uma entidade.

Nome	Tipo	Description
attributes		Os atributos do struct.
entityGuid	string	O GUID da entidade.
entityStatus	EntityStatus	Status da entidade – pode estar ativo ou excluído. Entidades excluídas não são removidas.
lastModifiedTS	string	ETag para controle de simultaneidade.
removePropagationsOnEntityDelete	boolean	Determina se as propagações serão removidas na exclusão da entidade.
typeName	string	O nome do tipo.
validityPeriods	TimeBoundary[]	Uma matriz de limites de tempo que indica períodos de validade.

AtlasEntitiesWithExtInfo

Objeto

Uma instância de uma entidade juntamente com informações estendidas , como hive_table, hive_database.

Nome	Tipo	Description
entities	AtlasEntity[]	Uma matriz de entidades.
referredEntities	<string, AtlasEntity>	As entidades mencionadas.

AtlasEntity

Objeto

Uma instância de uma entidade , como hive_table, hive_database.

Nome	Tipo	Description
attributes		Os atributos do struct.
businessAttributes		Atributos de negócios
classifications	AtlasClassification[]	Uma matriz de classificações.
collectionId	string	A ID da coleção da entidade.
contacts	object	O dicionário de contatos para entidades. A chave pode ser Especialista ou Proprietário.
createTime	integer (int64)	A hora criada do registro.
createdBy	string	O usuário que criou o registro.
customAttributes	object	Atributo Personalizado
guid	string	O GUID da entidade.
homeId	string	A ID inicial da entidade.
isIncomplete	boolean	Se é uma entidade de shell
labels	string[]	Rótulos
lastModifiedTS	string	ETag para controle de simultaneidade.
meanings	AtlasTermAssignmentHeader[]	Uma matriz de cabeçalhos de atribuição de termo que indica os significados da entidade.
provenanceType	integer (int32)	Usado para registrar a procedência de uma instância de uma entidade ou relação.
proxy	boolean	Determina se há um proxy.
relationshipAttributes		Os atributos da relação.
status	EntityStatus	Status da entidade – pode estar ativo ou excluído. Entidades excluídas não são removidas.
typeName	string	O nome do tipo.
updateTime	integer (int64)	A hora de atualização do registro.
updatedBy	string	O usuário que atualizou o registro.
version	integer (int64)	A versão da entidade.

AtlasEntityHeader

Objeto

Uma instância de uma entidade , como hive_table, hive_database.

Nome	Tipo	Description
attributes		Os atributos do struct.
classificationNames	string[]	Uma matriz de nomes de classificação.
classifications	AtlasClassification[]	Uma matriz de classificações.
displayText	string	O texto de exibição.
guid	string	O GUID do registro.
isIncomplete	boolean	Se é uma entidade de shell
labels	string[]	Rótulos
lastModifiedTS	string	ETag para controle de simultaneidade.
meaningNames	string[]	Uma matriz de significados.
meanings	AtlasTermAssignmentHeader[]	Uma matriz de cabeçalhos de atribuição de termos.
status	EntityStatus	Status da entidade – pode estar ativo ou excluído. Entidades excluídas não são removidas.
typeName	string	O nome do tipo.

AtlasErrorResponse

Objeto

Uma resposta de erro do serviço

Nome	Tipo	Description
errorCode	string	O código de erro.
errorMessage	string	A mensagem de erro.
requestId	string (uuid)	A ID da solicitação.

AtlasTermAssignmentHeader

Objeto

O cabeçalho da atribuição de termo.

Nome	Tipo	Description
confidence	integer (int32)	A confiança da atribuição de termo.
createdBy	string	O usuário que criou o registro.
description	string	A descrição da atribuição de termo.
displayText	string	O texto de exibição.
expression	string	A expressão da atribuição de termo.
relationGuid	string (uuid)	O GUID da relação.
status	AtlasTermAssignmentStatus	O status da atribuição de termos.
steward	string	O administrador do termo.
termGuid	string (uuid)	O GUID do termo.

AtlasTermAssignmentStatus

Enumeração

Status da atribuição de termos

Valor	Description
DEPRECATED	O status foi preterido.
DISCOVERED	O status é descoberto.
IMPORTED	O status é importado.
OBSOLETE	O status é obsoleto.
OTHER	Outro status.
PROPOSED	O status é proposto.
VALIDATED	O status é validado.

BusinessAttributeUpdateBehavior

Enumeração

Usado para definir o comportamento de atualização para atributos de negócios ao atualizar entidades.

Valor	Description
ignore	Ignore o conteúdo do atributo de negócios para atualização.
merge	Mesclar os atributos de negócios. Os atributos comerciais não serão atualizados se não forem fornecidos.
replace	Substitua todos os atributos de negócios usando o conteúdo.

EntityMutationResult

Objeto

O resultado da resposta de mutação da entidade.

Nome	Tipo	Description
guidAssignments	object	Um mapa de atribuições guid com entidades.
mutatedEntities	object	Os cabeçalhos de entidade de entidades mutadas.
partialUpdatedEntities	AtlasEntityHeader[]	Uma matriz de cabeçalhos de entidade que foram parcialmente atualizados.

EntityStatus

Enumeração

Status – pode ser ativo ou excluído

Valor	Description
ACTIVE	O status está ativo.
DELETED	O status é excluído.

TimeBoundary

Objeto

Captura detalhes de limite de tempo

Nome	Tipo	Description
endTime	string	O limite de fim do tempo.
startTime	string	O início do limite de tempo.
timeZone	string	O fuso horário do limite de tempo.

Compartilhar via

Entity - Bulk Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

OAuth2Auth

Escopos

Exemplos

Entity_BulkCreateOrUpdate

Solicitação de exemplo

Resposta de exemplo

Definições

AtlasClassification

AtlasEntitiesWithExtInfo

AtlasEntity

AtlasEntityHeader

AtlasErrorResponse

AtlasTermAssignmentHeader

AtlasTermAssignmentStatus

BusinessAttributeUpdateBehavior

EntityMutationResult

EntityStatus

TimeBoundary