Skip to content

Advanced Data Governance Summit HOL: SQL bug fixes and content cleanup#3330

Open
sfc-gh-ankgupta wants to merge 11 commits into
Snowflake-Labs:masterfrom
sfc-gh-ankgupta:advanced-data-governance-summit-hol-tweaks
Open

Advanced Data Governance Summit HOL: SQL bug fixes and content cleanup#3330
sfc-gh-ankgupta wants to merge 11 commits into
Snowflake-Labs:masterfrom
sfc-gh-ankgupta:advanced-data-governance-summit-hol-tweaks

Conversation

@sfc-gh-ankgupta
Copy link
Copy Markdown
Contributor

Summary

Targeted fixes and content cleanup for the Advanced Data Governance Summit HOL quickstart. Focus areas: correct broken SQL queries against DATA_CLASSIFICATION_LATEST and ENTITLEMENT_REPORT views, simplify lab content, and clean up terminology.

Changes

Step 2 (Classification & Policies)

  • Reword classification section to remove AI-Powered framing
  • Flip order: run SYSTEM$CLASSIFY manually first, then attach profile for auto-classification
  • Remove Section 2.5 (custom classifier for credit cards) — out of scope for the lab
  • Renumber subsequent steps and clean up references

Step 3 (Trust Center)

  • Restructure: UI walkthrough first, then SQL with USE block adjacent to queries
  • Add disclaimer about auto-classification timing in Trust Center UI
  • Add Information Schema as primary verification (immediate, no latency)
  • Fix all broken DATA_CLASSIFICATION_LATEST queries — use LATERAL FLATTEN on RESULT JSON
  • Remove Step 3.5 Governance Gap Analysis (broken queries; covered elsewhere)
  • Fix Entitlement Report queries: remove TABLE_CATALOG (not in preview schema), use dynamic RUN_ID subquery, rename CREATED_TIME → CREATED_ON

Step 6 (Cortex Code skills)

  • Replace 3 broken DATA_CLASSIFICATION_LATEST queries with TAG_REFERENCES (correct flat columns for custom DATA_CLASSIFICATION tags)
  • Fix GET_DDL object type: 'MASKING POLICY' → 'POLICY'
  • Update OBSERVE/Key Takeaways comments

Teardown

  • Add Step 5 with UI instructions to disable Sensitive Data Entitlement Report (account-level config not removed by dropping HRZN_DB)
  • Header cleanup

Cross-cutting

  • Remove AI-Powered language from file headers (steps 2, 3, 4, 5, 6, teardown)
  • Update What You'll Learn / What You'll Build sections in guide.md
  • Move Trust Center bullet from AI-Powered Governance to Core Governance

Test plan

  • Step 2 SQL runs end-to-end (classification, masking, row access, aggregation, projection policies)
  • Step 3 Information Schema verification query returns custom DATA_CLASSIFICATION tags immediately
  • Step 3 ACCOUNT_USAGE LATERAL FLATTEN query parses RESULT JSON correctly
  • Step 3 Entitlement Report queries work with the dynamic RUN_ID subquery
  • Step 6 governance maturity score query runs against TAG_REFERENCES
  • GET_DDL('POLICY', ...) returns masking policy DDL

- Remove 'AI-Powered' from guide heading, descriptions, and SQL script
- Flip order in SQL: run SYSTEM$CLASSIFY manually first, then attach profile
- Update comments: clarify manual test vs auto-classification intent
- Update Step 2.4 header to reflect new flow
- Remove Section 2.5 (CREDITCARD custom classifier) from SQL script
- Renumber subsequent steps 2.6-2.11 to 2.5-2.10
- Update overview list in SQL script
- Remove 'custom classifiers' from key features table in guide.md
- Remove CREDITCARD classifier reference from teardown comments
- Remove 'AI-Powered' from SQL file header
- Move USE block to just before Step 3.2 SQL (UI sections first)
- Add auto-classification disclaimer to Step 3.1 UI section
- Restructure Step 3.2: Information Schema (primary/immediate) +
  corrected ACCOUNT_USAGE queries using LATERAL FLATTEN on RESULT JSON
- Remove Step 3.5 Governance Gap Analysis from SQL file and Key Takeaways
- Remove Governance Gap Analysis section from guide.md
- Fix broken inline SQL in guide.md (replace with pointer to script)
- Remove TABLE_CATALOG (not available in preview schema)
- Use dynamic RUN_ID subquery (latest run) instead of hardcoded UUIDs
- Replace ad-hoc queries with 3 focused lab-ready queries:
  list runs, who has access, role summary with ARRAY_AGG
- Remove AI-Powered from file header
- Replace 3 broken DATA_CLASSIFICATION_LATEST queries with TAG_REFERENCES
  (custom DATA_CLASSIFICATION tag has flat columns; classification_latest is
   table-level JSON requiring FLATTEN)
- Update OBSERVE/Key Takeaways comments to match new view references
- Preserved AI terminology where it describes Cortex Code itself or AI-assisted
  governance value (lines 23, 153, 446)
@github-actions
Copy link
Copy Markdown
Contributor

👋 Helpful Information

💡 Non-Image Files in Assets Folder

Non-image files found in /assets folders will NOT be uploaded to snowflake.com. If you are referencing them in your guide, you should link to them directly (e.g. using permanent GitHub links).

  • site/sfguides/src/advanced-data-governance-summit-hol/assets/2-classification-and-policies.sql
  • site/sfguides/src/advanced-data-governance-summit-hol/assets/3-trust-center-data-security.sql
  • site/sfguides/src/advanced-data-governance-summit-hol/assets/4-audit-trail.sql
  • site/sfguides/src/advanced-data-governance-summit-hol/assets/5-ai-redact.sql
  • site/sfguides/src/advanced-data-governance-summit-hol/assets/6-cortex-code-governance-skills.sql
  • site/sfguides/src/advanced-data-governance-summit-hol/assets/99-teardown.sql

These are informational messages and will not block your PR from being merged.

@sfc-gh-ankgupta sfc-gh-ankgupta self-assigned this May 30, 2026
@github-actions
Copy link
Copy Markdown
Contributor

🔗 Staging Preview Ready

Quickstart: advanced-data-governance-summit-hol
Language: en

👉 Preview URL: https://publish-p57963-e462098.adobeaemcloud.com/en/developers/guides/advanced-data-governance-summit-hol-6fe7596b0c71a8280d570dbee9c544d1d3ddb262

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


Generated by GitHub Actions

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