pub struct Storage {
pub name: Ident,
pub comparison: Ident,
pub from: Conversion,
pub into: Conversion,
pub columns: Vec<PersistColumn>,
pub fills: Vec<Filled>,
pub aliases: AliasOptions,
}Expand description
What every backend carries, whatever its own vocabulary adds.
One struct embedded in each backend rather than six fields repeated four times — the emission reads these and nothing else for most of its work, and a field that meant something different per backend would not be here.
Fields§
§name: IdentThe name of the emitted ROW type — default_row_name unless row(rename = "…") named it.
comparison: IdentThe name of the emitted COMPARISON type — default_comparison_name unless
comparison(rename = "…") named it.
Its OWN block, because a database emits two types and a bare rename could not say which.
from: ConversionA conversion for the WHOLE row: from BUILDS this projection, so domain → row. A write.
into: ConversionA conversion for the WHOLE row: into LEAVES this projection, so row → domain. A read.
When it is not Conversion::Default it replaces the field-wise body, which is what lets a
PARTIAL row reach the record at all — the field-wise read can only be emitted when the row
carries every field.
columns: Vec<PersistColumn>THIS DATABASE’s columns, in the record’s declaration order.
§The participation MASK, and what it is a mask over
The universal list is every data field the record declares less the ones wearing skip — the
inversion’s own answer, and the whole list for a declaration that narrows nothing. This one is
that list masked by what each field said to THIS database: a bare <db> list keeps the
databases it names, and <db>(skip(default = "…")) drops the one it names.
So the databases may now DISAGREE about which columns exist, and every seat that reads a
per-database fact reads this one: the row struct, the INSERT list, the SELECT, this
database’s comparison and its own duplicate-name fence. The seats that must not vary with a
deployment’s storage choice read the INTERSECTION instead — see
RecordModel::stored_columns, where the shared query vocabulary is stated.
What a field withheld from this database still owes is the READ, and fills is
where that is answered.
fills: Vec<Filled>What THIS DATABASE’s raise supplies for the fields its row does not carry.
§A per-database seat, where skip at the field is the record’s own
A field wearing the bare skip is a column of no database, so every raise supplies it from the
one fill that word named and the answer does not vary — that stays read off the record’s own
fields. This is the OTHER absence: a field that IS a column of the record’s other databases and
not of this one, whose fill is therefore this database’s own.
EMPTY is the ordinary case, and is every declaration that narrows nothing. A partial absence with no fill never reaches here — it is a named refusal at the word that narrowed, because a value that round-trips out of one store and is invented out of the next is a difference only the declaration can record.
aliases: AliasOptionsalias(…) — the namespace and the depth this database’s row-source names are minted at.
Here rather than on the four backend structs because it is the same option in all four: an
alias is a name a NESTED scope calls a row source by, which every backend that nests one has.
Which is also why it is per BACKEND rather than per record — see AliasOptions.