Get Table Lineage

Get upstream/downstream table lineage.

Args: table_id: Full table identifier (format: database.schema.table or similar path) direction: Lineage direction - “upstream”, “downstream”, or “both” (default: “both”) depth: Maximum traversal depth (default: configured system depth, typically 3-5 hops)

Returns: TableLineageResponse containing:

• dataset: The requested table/view with metadata
• upstream: List of source tables this dataset depends on
• downstream: List of dependent tables that use this dataset
• edges: Dependency relationships between all returned datasets

Example:

• Get full lineage: table_id=“analytics.fact_orders”, direction=“both”
• Get only sources: table_id=“analytics.fact_orders”, direction=“upstream”, depth=2
• Get only consumers: table_id=“raw.customers”, direction=“downstream”

Note: depth parameter is interpolated into Cypher query using f-string because Cypher does not support parameterized variable-length path patterns (*1..). Input is validated as int by FastAPI.