Skip to content

Add Data Vault 2.0 modeling reference guide#351

Open
anandgupta42 wants to merge 3 commits intomainfrom
claude/add-datavault-support-iwVan
Open

Add Data Vault 2.0 modeling reference guide#351
anandgupta42 wants to merge 3 commits intomainfrom
claude/add-datavault-support-iwVan

Conversation

@anandgupta42
Copy link
Contributor

Summary

Added comprehensive Data Vault 2.0 modeling reference documentation to the dbt-develop skill. This new guide covers the complete Data Vault methodology including:

  • Core concepts (hubs, links, satellites) with naming conventions and grain definitions
  • Layer mapping between Data Vault and traditional dbt patterns
  • Detailed implementation patterns with SQL examples for:
    • Staging with hash keys and load metadata
    • Hub creation (business key registry) with multi-source loading
    • Link tables (relationships between entities)
    • Satellites (historized attributes) including effectivity satellites
    • Business Vault (derived logic)
    • Information Marts (business-ready tables)
  • Best practices for hash key generation, incremental loading, and change detection
  • Common mistakes and how to avoid them
  • Guidance on when to use Data Vault vs. other patterns
  • Reference to the automate-dv dbt package for automation

Updated the skill description to reflect Data Vault 2.0 coverage alongside existing medallion architecture patterns.

Test Plan

N/A — Documentation-only change. Content accuracy verified against Data Vault 2.0 methodology standards and dbt best practices.

Checklist

  • Documentation updated (new reference guide added)
  • Tests added/updated (not applicable)
  • CHANGELOG updated (documentation reference only)

https://claude.ai/code/session_01KksQUQebvg5P8XmvTkoeNM

claude added 3 commits March 21, 2026 20:32
Adds a comprehensive reference guide for Data Vault 2.0 (hubs, links,
satellites, business vault) with dbt SQL templates, naming conventions,
hash key patterns, and incremental loading strategies. Updates the
dbt-develop skill to surface Data Vault as a first-class modeling option
alongside traditional layer patterns and medallion architecture.

https://claude.ai/code/session_01KksQUQebvg5P8XmvTkoeNM
…l errors

Adversarial review found and fixed:
- Replace NOT IN with LEFT JOIN WHERE NULL in hub/link templates (NULL-safe, faster)
- Add multi-source hub loading example (core Data Vault use case)
- Add satellite-on-link SQL template (was referenced but missing)
- Add effectivity satellite pattern for tracking link validity periods
- Fix dbtvault/automate-dv: they are the same package (renamed), not two
- Add dialect note for qualify (Snowflake/BigQuery/Databricks only)
- Add 3 common mistakes: NOT IN, inconsistent hashing, NULL-unsafe comparisons
- Update SKILL.md Plan step to mention Data Vault layers

https://claude.ai/code/session_01KksQUQebvg5P8XmvTkoeNM
Copy link

@claude claude bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review.

@coderabbitai
Copy link

coderabbitai bot commented Mar 21, 2026

Warning

Rate limit exceeded

@anandgupta42 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 18 minutes and 47 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 776672ac-c2c1-4eb3-8ff1-ab5445bd4eac

📥 Commits

Reviewing files that changed from the base of the PR and between 623d1ac and b782017.

⛔ Files ignored due to path filters (1)
  • bun.lock is excluded by !**/*.lock
📒 Files selected for processing (2)
  • .opencode/skills/dbt-develop/SKILL.md
  • .opencode/skills/dbt-develop/references/datavault-modeling.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/add-datavault-support-iwVan

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants