This document discusses Marquez, an open source metadata management system. It provides an overview of Marquez and how it can be used to track metadata in data pipelines. Specifically: - Marquez collects and stores metadata about data sources, datasets, jobs, and runs to provide data lineage and observability. - It has a modular framework to support data governance, data lineage, and data discovery. Metadata can be collected via REST APIs or language SDKs. - Marquez integrates with Apache Airflow to collect task-level metadata, dependencies between DAGs, and link tasks to code versions. This enables understanding of operational dependencies and troubleshooting. - The Marquez community aims to build an open

1. Data Lineage and
observability
Julien Le Dem
CTO and co-founder Datakin
@J_

2. AGENDA
Intro to Marquez
Marquez community
02
04
Why metadata?01
Airflow integration03

3. Why metadata?01

4. Need to create a healthy
data ecosystem

5. Team interdependencies
Team A Team B
Team C

6. DATA
● What is the data source?
● What is the schema?
● Who is the owner?
● How often is it updated?
● Where is it coming from?
● Who is using the data?
● What has changed?
Today: Limited context

7. Maslow’s Data hierarchy of needs
New Business Opportunities
Business optimization
Data Quality
Data Freshness
Data Availability

8. Intro to Marquez02

9. Data
Operations
Data
Governance
Data
Discovery
Marquez

10. http://cidrdb.org/cidr2017/papers/p111-hellerstein-cidr17.pdf

11. Metadata (Marquez)
Ingest Storage Compute
StreamingBatch/ETL
● Data Platform
built around
Marquez
● Integrations
○ Ingest
○ Storage
○ Compute
Flink
Airflow
Kafka
Iceberg / S3
BI

12. Marquez: Data model
Job
Dataset Job Version
Run
*
1
*
1
*
1
1*
1*
Source
1 *
● MYSQL
● POSTGRESQL
● REDSHIFT
● SNOWFLAKE
● KAFKA
● S3
● ICEBERG
● DELTALAKE
● BATCH
● STREAM
● SERVICE
Dataset Version

13. Marquez: Data model
DbTable Filesystem Stream
Job
Dataset Job Version
Run
*
1
*
1
*
1
1*
1*
Source
1 *
● MYSQL
● POSTGRESQL
● REDSHIFT
● SNOWFLAKE
● KAFKA
● S3
● ICEBERG
● DELTALAKE
● BATCH
● STREAM
● SERVICE
Dataset Version

14. v1 v4Dataset
v2
v4
v4
Job
v1
Dataset
v4
Job
v2
Marquez: Data model
● Debugging
○ What job version(s) produced and
consumed dataset version X?
● Backfilling
○ Full / incremental processing
Design benefits

15. Marquez: Metadata collection
How is metadata collected?
● Push-based metadata
collection
● REST API
● Language-specific SDKs
○ Java
○ Python
Marquez
Job
Dataset+job
metadata

16. ● Centralized metadata
management
○ Sources
○ Datasets
○ Jobs
● Modular framework
○ Data governance
○ Data lineage
○ Data discovery +
exploration
Metadata Service
Marquez: Design
Marquez
Core
Lineage
Search
REST API
ETL Batch Stream

17. Extensions
datakin
Lineage
analysis
Lineage collectionAPIs
Integrations
Client -
side
Metadata
Core
DB
Graph
Storage
Marquez UI
Listener
Core API

18. Marquez: Metadata collection
Source
{
"type":"POSTGRESQL",
"name":"analyticsdb”,
"connectionUrl":"jdbc:postgresql://localhost:5431/analytics”,
"description":“Contains tables such as office room bookings.”
}
01

19. Marquez: Metadata collection
{
"type":"POSTGRESQL",
"name":"analyticsdb”,
"connectionUrl":"jdbc:postgresql://localhost:5431/analytics”,
"description":“Contains tables such as office room bookings.”
}
{
"type":"DB_TABLE",
"name":"room_bookings”,
"physicalName":"public.room_bookings”,
"sourceName":"analyticsdb”,
"namespace":"datascience",
"fields": [...],
"description":“All global room bookings for each office.”
}
02 Dataset
Source01

20. Marquez: Metadata collection
{
"type":"POSTGRESQL",
"name":"analyticsdb”,
"connectionUrl":"jdbc:postgresql://localhost:5431/analytics”,
"description":“Contains tables such as office room bookings.”
}
{
"type":"DB_TABLE",
"name":"room_bookings”,
"physicalName":"public.room_bookings”,
"sourceName":"analyticsdb”,
"namespace":"datascience”,
"fields": [...],
"description":“All global room bookings for each office.”
}
{
"type":"BATCH",
"name":"room_bookings_7_days”,
"inputs":[{"namespace":"datascience","name":"room_bookings”}],
"outputs":[],
"location":"https://github.com/jobs/blob/124f6089...”,
"namespace":"datascience",
"description":“Weekly email of room bookings occupancy patterns.”
}
03 Job
Source01
02 Dataset

21. Marquez: Metadata collection
{
"type":"POSTGRESQL",
"name":"analyticsdb”,
"connectionUrl":"jdbc:postgresql://localhost:5431/analytics”,
"description":“Contains tables such as office room bookings.”
}
{
"type":"DB_TABLE",
"name":"room_bookings”,
"physicalName":"public.room_bookings”,
"sourceName":"analyticsdb”,
"namespace":"datascience”,
"fields": [...],
"description":“All global room bookings for each office.”
}
{
"type":"BATCH",
"name":"room_bookings_7_days”,
"inputs":[{"namespace":"datascience","name":"room_bookings”}],
"outputs":[],
"location":"https://github.com/jobs/blob/124f6089...”,
"namespace":"datascience”,
"description":“Weekly email of room bookings occupancy patterns.”
}
03 Job
Source01
LINK SOURCE
LINK DATASET
02 Dataset

22. 01 Job
v1
{
"type":"BATCH",
"name":"room_bookings_7_days”
"inputs":[{
"namespace":"datascience",
"name":"room_bookings”
}],
"outputs":[],
...
}
LINEAGE
JOBDATASET
Marquez: Metadata collection

23. {
"type":"BATCH",
"name":"room_bookings_7_days”
"inputs":[{
"namespace":"datascience",
"name":"room_bookings”
}],
"outputs":[],
...
}
JOBDATASET
Marquez: Metadata collection
02 Job
v2
{
"type":"BATCH",
"name":"room_bookings_7_days”
"inputs":[{
"namespace":"datascience",
"name":"room_bookings”
}],
"outputs":[{
"namespace":"datascience",
"name":"room_bookings_aggs”
}],
...
}
LINEAGE
LINEAGE
01 Job
v1

24. Airflow integration03

25. Airflow
DAG
DAG
DAG
DAG
Marquez Lib.
● Metadata
○ Task lifecycle
○ Task parameters
○ Task runs linked to versioned code
○ Task inputs / outputs
● Lineage
○ Track inter-DAG dependencies
● Built-in
○ SQL parser
○ Link to code builder (GitHub)
○ Metadata extractors
Marquez: Airflow
Airflow support for Marquez

26. DAG
MarquezLib.
Integration
Marquez
RESTAPI
Capturing task-level metadata in a
nutshell
Marquez: Airflow
Job
Dataset
Job
Version
Run
Dataset
Version
*
1
*
1
1*
1*
Source
1 *
*
1
Airflow

27. ● Open source: marquez-airflow
● Enables global task-level metadata collection
● Extends Airflow’s DAG class
from marquez_airflow import DAG
from airflow.operators.postgres_operator import PostgresOperator
...
room_bookings_7_days_dag.py
Marquez: Airflow
Marquez Airflow Lib.

28. airflow.operators.PostgresOperator
marquez_airflow.extractors.PostgresExtractor
Extractor
Operator
Metadata
Airflow
Marquez Airflow
Lib.
Example
Marquez: Airflow

29. Marquez: Airflow
t1=PostgresOperator(
task_id=’new_room_booking’,
postgres_conn_id=’analyticsdb’,
sql=’’’
INSERT INTO room_bookings VALUES(%s, %s, %s)
’’’
parameters=... # room booking
)
Operator Metadata
Source01
new_room_booking_dag.py

30. Marquez: Airflow
t1=PostgresOperator(
task_id=’new_room_booking’,
postgres_conn_id=’analyticsdb’,
sql=’’’
INSERT INTO room_bookings VALUES(%s, %s, %s)
’’’
parameters=... # room booking
)
Operator Metadata
Source01
02 Dataset
new_room_booking_dag.py

31. Marquez: Airflow
t1=PostgresOperator(
task_id=’new_room_booking’,
postgres_conn_id=’analyticsdb’,
sql=’’’
INSERT INTO room_bookings VALUES(%s, %s, %s)
’’’
parameters=... # room booking
)
Operator Metadata
02 Dataset
03 Job
new_room_booking_dag.py
Source01

32. Marquez: Airflow
new_room_bookings_dag.py top_room_bookings_dag.py
Managing inter-DAG dependencies

33. Marquez: Airflow
new_room_bookings_dag.py top_room_bookings_dag.py
Managing inter-DAG dependencies
b940314,1541624285,2
TSLOCATION ROOM
b648485,1541501885,9
b648485,1541710685,4
public.room_bookings

34. Marquez
API
● Marquez standardizes metadata collection
○ Job runs
○ parameters
○ version
○ inputs / outputs
● Datakin enables
○ Understanding operational dependencies
○ Impact analysis
○ Troubleshooting: What has changed
since the last time it worked?
Datakin leverages Marquez metadata
datakin
Lineage analysis
Graph
Integrations

35. Community04

36. https://marquezproject.github.io/marquez

37. Neutral
● Not controlled by
a company
● Community
driven
Community
● Build trust
● Grow adoption
● Everybody is on
an equal footing
Governance
● Decision
mechanisms
● Becoming a
maintainer
● Code of Conduct
Now part of the LF AI foundation

38. github.com/MarquezProject
@MarquezProject

39. Thanks! <o/

40. Questions?