Overview of the ODCS Source
masterThe Open Data Contract Standard (ODCS) source ingests YAML-based data contracts following the Linux Foundation / Bitol standard.
Key Modeling Behavior:
- Logical Datasets: Instead of modeling contracts as
dataContractentities, the source models eachschema[]entry in an ODCS file as a logicalodcsDataset. - Physical Linking: When a
schema[]entry resolves to a physical dataset (viaservers[]), the source creates aPhysicalInstanceOfrelationship, linking the physical dataset to the logical one using thelogicalParentfield. - Assertions: Quality rules (
quality[]) and schema compliance are attached to the logical dataset, not the physical one. DataHub propagates these expectations to physical instances via the logical-to-physical relationship.
Note on Logical Models:
Logical Models are in private beta. To see logical odcs datasets and their assertions in the DataHub UI, you must enable the LOGICAL_MODELS_ENABLED feature flag (it is off by default).