SAService Architect Back to designer
SAService ArchitectDocumentation
Stream typesKeys and state
Stream type T → KeyValue<K,V>

KeyBy

Extracts a comparable key and creates a keyed stream.

When to use

Use KeyBy before Join or MultiJoin to make correlation explicit.

Behavior

  • The function extracts K from every T.
  • Downstream keyed operators require identical keyType values.

General properties

Identity, ownership and operator-specific mode.

PropertyTypeDescription
typeTransformationType

Operator kind. It controls available properties, valid sources and generated interfaces.

RequiredAllowed: Input, Map, Filter, Join, MultiJoin, Process, FlatMap, FlatMapIterable, KeyBy, Merge, Split, Case, Sink, CycleLink, Error, Delay, When
namestring

Human-readable stream name shown in the designer and used to derive default generated symbols.

Required
serviceService

Service that owns the stream. Connected streams must belong to the same service.

Required

Connections properties

Upstream graph references accepted by this operator.

PropertyTypeDescription
sourceStream

Single upstream stream. The designer only offers structurally and type-compatible candidates.

Required

Data Types properties

Message contracts visible at this node.

PropertyTypeDescription
keyTypeType

Comparable key contract produced by KeyBy.

RequiredDefault: UnknownType
valueTypeType

Output or response message contract. The exact meaning is operator-specific.

RequiredDefault: UnknownType

Function properties

Generated business-logic implementation and its placement.

PropertyTypeDescription
functionNamesymbol

Generated business-logic type or function name.

Required
functionPackagestring

Subdirectory under the generated functions package.

publicFunctionboolean

Places the generated function in a shared package instead of the service-internal package.

Default: false
functionDescriptiontext

Documentation comment emitted with the generated function.

functionInitializerGroupstring

Dependency-injection initialization group for the generated function.

functionModuleModule

Shared module that owns the function.

Visible when publicFunction is true.

Execution properties

Pipeline placement and runtime policy.

PropertyTypeDescription
pipelinestring

Visual and configuration grouping inside the owning service.

Position properties

Designer-only canvas coordinates.

PropertyTypeDescription
xPosnumber

Horizontal designer coordinate. It has no runtime effect.

Required
yPosnumber

Vertical designer coordinate. It has no runtime effect.

Required

Configuration example

type: KeyBy
source: orderInput
keyType: string
valueType: Order
functionName: OrderByCustomer