Skip to content

doc: Design catalog-driven cluster lifecycle - #38694

Closed
aljoscha wants to merge 1 commit into
MaterializeInc:mainfrom
aljoscha:catalog-driven-cluster-lifecycle
Closed

doc: Design catalog-driven cluster lifecycle#38694
aljoscha wants to merge 1 commit into
MaterializeInc:mainfrom
aljoscha:catalog-driven-cluster-lifecycle

Conversation

@aljoscha

@aljoscha aljoscha commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Motivation

Decouple maintained storage and compute lifecycle from the adapter that initiated it. Catalog state should supply lifecycle authority, while independent query clients use a separate fast protocol.

Description

Add a minimal design and an append-only implementation log as the handoff for iterative implementation sessions. The design records ownership, readability, recovery, and query-ordering boundaries without prescribing catalog fields, protocol messages, or process topology.

Full multi-adapter operation remains the destination, not the immediate deliverable. Query-local dataflows stay on the fast protocol, and transparent query or session failover is out of scope. Completing the relevant catalog implication paths is included where needed.

This draft is the working PR for following the design and its implementation. It currently contains only the design document and makes no user-visible behavior changes.

Verification

No tests are added or modified because this is documentation only. The design calls for existing CI, nightly, and performance coverage, with targeted coverage for changed boundaries where needed during implementation.

Define catalog authority for maintained lifecycle and separate it from
request-scoped query execution. Record the ownership and readability
boundaries needed for independent clients, while leaving implementation
mechanisms open and full multi-adapter operation outside this deliverable.

Include an append-only implementation log for work across sessions.
@aljoscha aljoscha closed this Sep 7, 2026
@aljoscha
aljoscha deleted the catalog-driven-cluster-lifecycle branch September 7, 2026 11:58
@aljoscha

aljoscha commented Sep 7, 2026

Copy link
Copy Markdown
Contributor Author

Replaced by #38696, Decoupled coordination. The document and branch names now describe the architectural outcome rather than the catalog-driven mechanism. The agreed scope and contracts are unchanged.

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