yujunjun/datahub
2
0
Fork 0
mirror of https://github.com/datahub-project/datahub.git synced 2025-07-19 07:30:54 +00:00
Code Issues Packages Projects Releases Wiki Activity
datahub/docs/how/entity-onboarding.md
Jyoti Wadhwani 6a309332f3
refactor(gms): move gms restli resources (#1619) 
Move dataset and identity resources and subresources to gms/impl/src/main/java/com/linkedin/metadata/resources
Update docs to reflect the change
2020-04-01 16:30:59 -07:00

2.1 KiB
Raw Blame History

How to onboard an entity?

Refer to this doc if you're only interested in adding a new aspect to an existing entity

Currently, DataHub only has a support for 3 entity types: datasets, users and groups. If you want to extend DataHub with your own use cases such as metrics, charts, dashboards etc, you should follow the below steps in order.

1. Define URN

Refer to here for URN definition.

2. Model your metadata

Refer to metadata modelling section. Make sure to do the following:

  1. Define Aspect models.
  2. Define aspect union model. Refer to DatasetAspect as an example.
  3. Define Snapshot model. Refer to DatasetSnapshot as an example.
  4. Add your newly defined snapshot to Snapshot Union model.

3. GMA search onboarding

Refer to search onboarding.

4. GMA graph onboarding

Refer to graph onboarding.

5. Add rest.li resource endpoints

See CorpUsers for an example of top-level resource endpoint. Optionally add aspect-specific sub-resource endpoint such as CorpUsersEditableInfoResource.

6. UI for entity onboarding [WIP]