Upserting assets by external ID

Upserting assets by external ID enables you to create or update assets by using the entity ID that is used in the external system. The combination external entity ID and external system ID serves to identify assets.

You need the following attributes to enable creating assets in Collibra DGC:

  • The name or ID of the default domain where the asset has to be upserted.
  • Optionally, the name or ID of the community in which the specified domain is located.

If there is no asset in Collibra DGC that corresponds with the asset name, then the asset is created.

If there is no domain in Collibra DGC that corresponds with the domain name, the domain is created, provided that the following attributes are specified:

  • domain type id and/or domain type name
  • domain name
  • community id and/or community name

If not all of the attributes are specified, the upsert operation fails.

If Collibra DGC has no community that corresponds with the upserted community name, the community is created if the community name is provisioned in the upsert operation. If the community name is not provisioned, the upsert operation fails.

If you upsert assets by external ID, note that you can move assets to any domain in Collibra DGC afterward because of the external ID which ensures that the asset can be found and updated.