Skip to content

Docs: add warning about use of cache dictionary layouts in Cloud#5999

Open
Blargian wants to merge 1 commit intoClickHouse:mainfrom
Blargian:dictionary-best-practice-for-cloud
Open

Docs: add warning about use of cache dictionary layouts in Cloud#5999
Blargian wants to merge 1 commit intoClickHouse:mainfrom
Blargian:dictionary-best-practice-for-cloud

Conversation

@Blargian
Copy link
Copy Markdown
Member

@Blargian Blargian commented Apr 9, 2026

Summary

Together with ClickHouse/ClickHouse#102288 closes #5993

Since we use autoscaling in cloud, nodes can be replaced at any moment and if a node is replaced the dictionary is wiped clean. This can result in ingestion issues if they are using a dictionary to denormalize data in an MV. tl;dr only use complex key hashed or another dictionary lay out that prepopulates dictionaries, instead of populating them via caching mechanisms. See https://clickhouse.com/docs/dictionary/best-practices for more info on choosing dicationary cache layouts.

Checklist

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 9, 2026

@Blargian is attempting to deploy a commit to the ClickHouse Team on Vercel.

A member of the Team first needs to authorize it.

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 9, 2026

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

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview Apr 9, 2026 8:09pm

Request Review

@Blargian Blargian marked this pull request as ready for review April 9, 2026 19:58
@Blargian Blargian requested a review from a team as a code owner April 9, 2026 19:58
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.

Recommend customers not use cache layouts on dictionaries in CHC

1 participant