Module mz_catalog::durable::persist
source ยท Structsยง
- Catalog
State ๐Inner Applies updates for an opened catalog. - Persist
Handle ๐A handle for interacting with the persist catalog shard. - Applies updates for an unopened catalog.
Enumsยง
- An error that can occur while executing
PersistHandle::compare_and_append
. - Fenceable
Token ๐Enum representing the fenced state of the catalog. - Mode ๐Durable catalog mode that dictates the effect of mutable operations.
Constantsยง
- Seed used to generate the persist shard ID for builtin table migrations.
- CATALO
G_ ๐SEED Seed used to generate the persist shard ID for the catalog. - CATALO
G_ ๐SHAR D_ NAME Human readable catalog shard name. - Seed used to generate the persist shard ID for the expression cache.
- MIN_
EPOCH ๐The minimum value of an epoch. - UPGRAD
E_ ๐SEED Seed used to generate the catalog upgrade shard ID. - UPGRAD
E_ ๐SHAR D_ NAME Human readable catalog upgrade shard name.
Traitsยง
- Apply
Update ๐
Functionsยง
- Convert an
Antichain<Timestamp>
to aTimestamp
. - as_of ๐Generates a timestamp for reading from
read_handle
that is as fresh as possible, givenupper
. - Deterministically generate a builtin table migration shard ID for the given
organization_id
. - desc ๐Returns the schema of the
Row
s/SourceData
s stored in the persist shard backing the catalog. - Deterministically generate an expression cache shard ID for the given
organization_id
. - Fetch the persist version of the catalog upgrade shard, if one exists. A version will not exist if we are creating a brand-new environment.
- shard_
id ๐Deterministically generate a shard ID for the givenorganization_id
andseed
. - snapshot_
binary ๐Generates an iterator ofStateUpdate
that contain all updates to the catalog state up to, and including,as_of
. - Generates an iterator of
StateUpdate
that contain all updates to the catalog state up to, and including,as_of
.
Type Aliasesยง
- Persist
Catalog ๐State A durable store of the catalog state using Persist as an implementation. The durable store can serve any catalog data and transactionally modify catalog data. - Timestamp ๐New-type used to represent timestamps in persist.
- A Handle to an unopened catalog stored in persist. The unopened catalog can serve
Config
data,Setting
data, or the current epoch. All other catalog data may be un-migrated and should not be read until the catalog has been opened. TheUnopenedPersistCatalogState
is responsible for opening the catalog, seeOpenableDurableCatalogState::open
for more details.