Skip to content

Add Comprehensive Guide to Snowflake Data Quality Monitoring - #3542

Draft
sfc-gh-yostrinsky wants to merge 7 commits into
masterfrom
yostrinsky/comprehensive-guide-to-data-quality-monitoring
Draft

sfc-gh-yostrinsky wants to merge 7 commits into
masterfrom
yostrinsky/comprehensive-guide-to-data-quality-monitoring

Conversation

@sfc-gh-yostrinsky

Copy link
Copy Markdown
Collaborator

Summary

Comprehensive guide to Snowflake Data Quality Monitoring, built on Data Metric Functions — system and custom DMFs, scheduling, expectations, and alerting on violations.

The guide was deployed and live-validated end to end against a real database before submission, rather than written from documentation.

Why this replaces #3506

Same content, moved from a fork branch to a branch in this repository so the staging preview workflow can run. Fork-based PRs do not get the AEM staging deploy job, so #3506 could never produce a preview URL for reviewers.

This branch is also rebased onto current master, which fixes a second problem: the original branch predated scripts/requirements.txt (added 2026-09-04 in "Harden workflows" #3507), so validate_and_prepare failed with No file ... matched to [scripts/requirements.txt or **/pyproject.toml]. Validation passes on this branch.

Supersedes #3506.

Verification

  • Guide deployed end to end and live-validated; all DMF associations exercised against real data.
  • validate_and_prepare passing.

Note for reviewers

Opening as a draft. There is an outstanding question to the Data Quality team about roadmap direction that may affect one section; I will mark this ready once that is settled. Feedback on the rest is welcome in the meantime.

sfc-gh-yostrinsky and others added 2 commits September 18, 2026 10:56
Example-led guide: a small shared setup plus self-contained recipes, so a
reader can run any single example without working through the others.

Part 1 only (overview, setup, profiling, anatomy of a check). All SQL
verified against a live account; result tables are real output.

Covers two behaviours that are easy to get wrong: time-relative metrics
reject TIMESTAMP_NTZ, and UNSET DATA_METRIC_SCHEDULE reverts to the
default hourly cadence rather than suspending monitoring.

.... Generated with [Cortex Code](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-Authored-By: Cortex Code <noreply@snowflake.com>
Adds the metric catalogue and decision table, twelve failure-mode
recipes, custom metrics, schema-wide monitoring, AI-suggested checks,
anomaly detection, remediation, notifications, the circuit breaker,
layer strategy, quality as code, cost and cleanup.

Every SQL block runs against a live account and the result tables are
real output. Findings worth noting in the prose:

- FRESHNESS can return a negative value when a future-dated row is the
  newest timestamp, so a freshness check alone can be defeated by one
  bad timestamp. Paired with the clock-skew check.
- SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS does not record its result;
  the _PERSIST_RESULT variant does. Anything reading monitoring history
  needs the latter.
- The circuit breaker uses an ALERT because the native notification
  settings have no action hook. Proven end to end: alert TRIGGERED and
  the downstream task suspended.

.... Generated with [Cortex Code](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-Authored-By: Cortex Code <noreply@snowflake.com>
@github-actions

Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: comprehensive-guide-to-data-quality-monitoring
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/comprehensive-guide-to-data-quality-monitoring-7008610fb697714074843e310bc22db823f9e3c0

Note: Images are uploaded asynchronously. If images are missing, wait a few minutes and refresh.


Generated by GitHub Actions

…pes into themed sections

Generated with [Snowflake CoCo](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-authored-by: Snowflake CoCo <noreply@snowflake.com>
@github-actions

Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: comprehensive-guide-to-data-quality-monitoring
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/comprehensive-guide-to-data-quality-monitoring-affd69d0de9a7fa0b743da4e9e03fac156cf1d9f

Note: Images are uploaded asynchronously. If images are missing, wait a few minutes and refresh.


Generated by GitHub Actions

Generated with [Snowflake CoCo](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-authored-by: Snowflake CoCo <noreply@snowflake.com>
@github-actions

Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: comprehensive-guide-to-data-quality-monitoring
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/comprehensive-guide-to-data-quality-monitoring-2aa952a9dcc22bb8cd5f1def686c2e20e21ed8e6

Note: Images are uploaded asynchronously. If images are missing, wait a few minutes and refresh.


Generated by GitHub Actions

…x Code its own block, and move cost to the end

Generated with [Snowflake CoCo](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-authored-by: Snowflake CoCo <noreply@snowflake.com>
@github-actions

Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: comprehensive-guide-to-data-quality-monitoring
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/comprehensive-guide-to-data-quality-monitoring-a3b0298f67a931040cdab7cf6452dcfb7778a387

Note: Images are uploaded asynchronously. If images are missing, wait a few minutes and refresh.


Generated by GitHub Actions

…metric categories, and replace the deprecated model allowlist with model RBAC

Generated with [Snowflake CoCo](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-authored-by: Snowflake CoCo <noreply@snowflake.com>
@github-actions

Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: comprehensive-guide-to-data-quality-monitoring
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/comprehensive-guide-to-data-quality-monitoring-aa38da074e9c66e6b5d48b976d739f4857e4458b

Note: Images are uploaded asynchronously. If images are missing, wait a few minutes and refresh.


Generated by GitHub Actions

…le, drop the Covered in column, and link Checks as code to the DCM pipelines guide

Generated with [Snowflake CoCo](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-authored-by: Snowflake CoCo <noreply@snowflake.com>
@github-actions

Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: comprehensive-guide-to-data-quality-monitoring
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/comprehensive-guide-to-data-quality-monitoring-85a58c910f6991268a0e5e98bfb30dfeb691dcc6

Note: Images are uploaded asynchronously. If images are missing, wait a few minutes and refresh.


Generated by GitHub Actions

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant