Merry Christmas & Happy 2027! Less downtime. More good times. Celebrating 13 years of sorlavit.com
Skip to content
Sorlavit KimIT Support, Network & Infrastructure Services Let’s talk

ปุ่มแปลไทยจะเปิดบทความผ่าน Google Translate เพื่อแปลอัตโนมัติ โดยคงโค้ดและคำสั่งไว้ตามต้นฉบับ

Data Monitoring / Pipeline Freshness & Data Quality

Data pipelines: Schema contract changes

A compatible-looking API response changes a field's business meaning. Compare field names, types, units and semantic definitions with the agreed contract.

Compiled for Sorlavit Kim · Published · Updated · 2 min read

Environment and inputs: Data pipelines and analytical datasets; Apache Airflow is an orchestration example. Quality acceptance rules must match the dataset contract.

Failure scenario

A compatible-looking API response changes a field's business meaning. Confirm the cause before choosing a fix.

Evidence to collect

Compare field names, types, units and semantic definitions with the agreed contract. Record the time, affected scope and a healthy comparison interval.

Fix the confirmed cause

Version the contract and validate consumer behavior before accepting the new payload. Write the expected result first. Change one relevant setting at a time.

Check the result and hand over

Repeat the check for schema contract changes using the same scope and a representative interval. Check that the symptom is resolved, expected records are present and downstream results are correct. If coverage, correctness or latency worsens, restore the recorded configuration through the agreed rollback process.

Scope and precautions

Prefer read-only access and limit queries to the relevant period or dataset. This example has not been tested on your systems. Test changes in an approved environment. Keep credentials and sensitive data out of shared evidence.

Share this article

Back to all articles