mz_compute_client

Module controller

Source
Expand description

A controller that provides an interface to the compute layer, and the storage layer below it.

The compute controller manages the creation, maintenance, and removal of compute instances. This involves ensuring the intended service state with the orchestrator, as well as maintaining a dedicated compute instance controller for each active compute instance.

For each compute instance, the compute controller curates the creation of indexes and sinks installed on the instance, the progress of readers through these collections, and their eventual dropping and resource reclamation.

The state maintained for a compute instance can be viewed as a partial map from GlobalId to collection. It is an error to use an identifier before it has been β€œcreated” with create_dataflow(). Once created, the controller holds a read capability for each output collection of a dataflow, which is manipulated with set_read_policy(). Eventually, a collection is dropped with drop_collections().

Created dataflows will prevent the compaction of their inputs, including other compute collections but also collections managed by the storage layer. Each dataflow input is prevented from compacting beyond the allowed compaction of each of its outputs, ensuring that we can recover each dataflow to its current state in case of failure or other reconfiguration.

Modules§

  • Errors returned by the compute controller.
  • instance πŸ”’
    A controller for a compute instance.
  • replica πŸ”’
    A client for replicas of a compute instance.
  • Sequential dataflow hydration support for replicas.

Structs§

Enums§

Traits§

  • A composite trait for types that serve as timestamps in the Compute Controller. Into<Datum<'a>> is needed for writing timestamps to introspection collections.

Type Aliases§