Cohesive.Adapters.Elastic 0.1.0-alpha.78

Cohesive.Adapters.Elastic

Cohesive.Adapters.Elastic interprets Cohesive Relations as Elasticsearch queries and aggregations and realizes the Storage materialization lifecycle with generation-isolated indexes.

Install

dotnet add package Cohesive.Adapters.Elastic

Bind a placed source

When semantic paths match Elasticsearch _source paths, conventions provide the ordinary binding surface:

var binding = ElasticRelationQueryBinding.For(placedLoads)
    .Index("loads-read")
    .Identity(load => load.Id)
    .FieldsBySemanticPath()
    .Build()
    .RequireValue();

Use explicit field mappings when retrieval paths, keyword fields, nested scope, encodings, ordering evidence, or special query facilities differ from the semantic paths. The successful binding remains affine to the exact compiled plan and placement.

Implemented interpretations

• Native Elasticsearch request compilation for the declared Relation/query capability profile.
• Filters, projections, supported aggregation, ordering, paging, and mapped nested correlation.
• Exact physical field bindings with retrieval and query-channel evidence.
• Durable materialization targets using one isolated index per generation.
• Atomic publication through a stable read alias and hidden ownership fencing.
• Materialization lifecycle telemetry and sanitized transport diagnostics.

Important boundaries

The adapter supports only semantics justified by the index mapping and target profile. Scalar arrays may participate in supported membership queries but are not generally projectable result fields. Structured collection correlation requires an attested Elasticsearch nested mapping. Temporal filtering, unrestricted Unicode ordinal ordering, and mutable multi-request pagination require stronger evidence than Elasticsearch supplies by default.

Offset requests describe one bounded view. search_after and composite continuation sequences require a declared stable search view; point-in-time lifecycle support remains outside the current profile.

Continue

• Internals contains generation materialization, the complete query example, exact mappings, aggregation, pagination, and compiler boundaries.
• Relations getting started introduces the semantic query first.
• Relations capability reference records the generated profile.
• Cohesive.Storage owns the materialization lifecycle semantics.