DataChonk maintains an up-to-date knowledge base of dbt documentation, best practices, and your project's schema. This context powers Chonk's code generation.
What Gets Synced
dbt Documentation
Official dbt-core documentation
Adapter-specific guides
Best practices and patterns
Package documentation
Your Project
Database schema (tables, columns, types)
Detected relationships and foreign keys
Previously generated models
Your conversation history
How It Works
Knowledge Sync happens automatically, but understanding the process helps you get better results.
1
Schema Discovery
Scans your connected databases to understand table structure, column types, and indexes.
2
Relationship Detection
Infers connections from foreign keys, naming patterns (customer_id → customers), and explicit relationships.
3
Context Building
Combines your schema with dbt knowledge to create a rich context for code generation.
4
Continuous Learning
Updates as you make changes—new models, renamed columns, and new tables are automatically detected.
Version Support
DataChonk tracks multiple dbt versions to generate compatible code for your project.
Property
Type
Default
Description
dbt 1.9.x
-
-
Fully Supported — Latest features including semantic layer improvements
dbt 1.8.x
-
-
Fully Supported — Stable release with all core features
dbt 1.7.x
-
-
Supported — May not include newest syntax options
dbt 1.6.x
-
-
Legacy Support — Basic generation, limited new features
DataChonk auto-detects your dbt version from dbt_project.yml and generates compatible code. You can also set it manually in project settings.
Sync Frequency
dbt Documentation
Updated weekly
Includes new dbt releases and package updates
Your Schema
On-demand
Click 'Scan' to refresh your database schema
Generated Code
Real-time
Models are tracked as you create them
Relationships
On scan
Updated when you rescan your database
Manual Sync
Sometimes you need to force a refresh of your project's knowledge graph.
How to Sync
Go to Settings → Knowledge and click Sync Now. This will:
Re-scan all connected data sources
Update relationship mappings
Refresh the AI's context
Detect new tables and columns
When to Manual Sync
Sync after major schema changes, adding new data sources, or if Chonk seems unaware of recent changes to your database.
