fix: drop legacy clickhouse tables and remove v1 schema

[Flo4604]

What does this PR do?

This PR removes all legacy ClickHouse schema definitions and adds a migration to drop the corresponding database objects. The legacy v1 schema in separate databases (verifications, ratelimits, metrics, billing, business) is being fully replaced by the v2/v3 schema in the default database.

The migration drops materialized views, tables, and databases in the correct dependency order to avoid foreign key constraint issues. Additionally, temporary sync materialized views that were bridging data from v1 to v2 during the migration period are also removed.

Fixes # (issue)

Type of change

• Chore (refactoring code, technical debt, workflow improvements)
• Bug fix (non-breaking change which fixes an issue)
• Enhancement (small improvements)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How should this be tested?

• Verify the migration runs successfully against a test ClickHouse instance with legacy schema
• Confirm all legacy databases, tables, and views are properly dropped
• Ensure the new v2/v3 schema in the default database continues to function correctly
• Test that applications using the new schema are unaffected

Checklist

Required

• Filled out the "How to test" section in this PR
• Read Contributing Guide
• Self-reviewed my own code
• Commented on my code in hard-to-understand areas
• Ran pnpm build
• Ran pnpm fmt
• Ran make fmt on /go directory
• Checked for warnings, there are none
• Removed all console.logs
• Merged the latest changes from main onto my branch with git pull origin main
• My changes don't cause any responsiveness issues

Appreciated

• If a UI change was made: Added a screen recording or screenshots to this PR
• Updated the Unkey Docs if changes were necessary

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dashboard	Ready	Preview, Comment	Mar 16, 2026 11:55am

[Flo4604]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• fix: drop legacy clickhouse tables and remove v1 schema #5230 👈 (View in Graphite)
• fix: drop v2 key verification aggregation chain from default db #5231
• fix: remove v2 aggregation tables from default allowed tables #5229
• fix: use v3 verification aggregation tables in keys overview #5228
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 9d656d1f-a66b-476a-ad06-d5a30010f296

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/drop-legacy-clickhouse-tables

📝 Coding Plan

• Generate coding plan for human review comments

---

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