Skip to content

docs: BYOB restore — document restore_access_entities_with_current_grants (26.4+)#6455

Draft
garrettthomaskth wants to merge 5 commits into
mainfrom
byob-restore-access-entities-with-current-grants
Draft

docs: BYOB restore — document restore_access_entities_with_current_grants (26.4+)#6455
garrettthomaskth wants to merge 5 commits into
mainfrom
byob-restore-access-entities-with-current-grants

Conversation

@garrettthomaskth

Copy link
Copy Markdown

What

Documents the new restore_access_entities_with_current_grants RESTORE setting in the BYOB "restore using commands" guide.

The previous example used RESTORE ALL EXCEPT TABLES system.users, system.roles to work around the ACCESS_DENIED failure that occurs when a backup's access entities (e.g. default_role) carry more grants than the restoring user can grant. On ClickHouse Cloud 26.4 (build 26.4.1.1942+) you can instead RESTORE ALL with SETTINGS restore_access_entities_with_current_grants = 1, which clamps restored grants to what the restoring user may grant (same semantics as GRANT CURRENT GRANTS) instead of failing.

Details

  • Primary example switched to RESTORE ALL ... SETTINGS restore_access_entities_with_current_grants = 1.
  • Added a version note (Cloud 26.4 / build 26.4.1.1942+) with SELECT version() to check the running version.
  • Kept the EXCEPT TABLES system.users, system.roles form documented as the pre-26.4 fallback.

Upstream feature PR: ClickHouse/ClickHouse#98795
Rollout: ClickHouse/data-plane-base-configurations#2084

English source only; translations handled by the docs i18n flow.

🤖 Generated with Claude Code

…ants (26.4+)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jun 26, 2026 10:27pm
clickhouse-docs-jp Building Building Preview, Comment Jun 26, 2026 10:27pm
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview Jun 26, 2026 10:27pm
clickhouse-docs-ru Ignored Ignored Preview Jun 26, 2026 10:27pm
clickhouse-docs-zh Ignored Ignored Preview Jun 26, 2026 10:27pm

Request Review

garrettthomaskth and others added 4 commits June 26, 2026 14:53
… note

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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