DataHub Documentation

repository·master·Indexed 27 days ago

https://github.com/datahub-project/datahub

An open-source AI data catalog for discovery, governance, and observability. This documentation covers the unified metadata graph, Metadata Model Extensions (including Custom Validators, Model Plugins, Custom Aspects, and Entity Extensions), and the DataHub Actions pipeline for event-driven workflows such as documentation propagation.

Tokens
311.5K
Snippets
644
Records
1.6K
Agent score
95%

What's inside DataHub

  1. Overview of the ODCS Source

    master

    The 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 dataContract entities, the source models each schema[] entry in an ODCS file as a logical odcs Dataset.
    • Physical Linking: When a schema[] entry resolves to a physical dataset (via servers[]), the source creates a PhysicalInstanceOf relationship, linking the physical dataset to the logical one using the logicalParent field.
    • 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).

  2. Overview of ClickHouse ingestion for DataHub

    master

    The DataHub integration for ClickHouse allows you to ingest metadata from ClickHouse data platforms into DataHub. The integration captures the following metadata entities:

    • Core technical assets: Datasets, tables, and views.
    • Schema information: Schema fields/columns.
    • Containers: Organizational structures.
    • Lineage: Table-level and column-level lineage (when supported and enabled).
    • Usage & Quality: Usage statistics, data profiling, and stateful deletion detection.