UpdateRecord 2025.10.9.21

Bundle

org.apache.nifi | nifi-standard-nar

Description

Updates the contents of a FlowFile that contains Record-oriented data (i.e., data that can be read via a RecordReader and written by a RecordWriter). This Processor requires that at least one user-defined Property be added. The name of the Property should indicate a RecordPath that determines the field that should be updated. The value of the Property is either a replacement value (optionally making use of the Expression Language) or is itself a RecordPath that extracts a value from the Record. Whether the Property value is determined to be a RecordPath or a literal value depends on the configuration of the <Replacement Value Strategy> Property.

Tags

avro, csv, freeform, generic, json, log, logs, record, schema, text, update

Input Requirement

REQUIRED

Supports Sensitive Dynamic Properties

false

Properties

PropertyDescription
Record ReaderSpecifies the Controller Service to use for reading incoming data
Record WriterSpecifies the Controller Service to use for writing out the records
Replacement Value StrategySpecifies how to interpret the configured replacement values

Relationships

NameDescription
failureIf a FlowFile cannot be transformed from the configured input format to the configured output format, the unchanged FlowFile will be routed to this relationship
successFlowFiles that are successfully transformed will be routed to this relationship

Writes attributes

NameDescription
record.indexThis attribute provides the current row index and is only available inside the literal value expression.
record.error.messageThis attribute provides on failure the error message encountered by the Reader or Writer.

Use cases

Combine multiple fields into a single field.
Change the value of a record field to an explicit value.
Copy the value of one record field to another record field.
Enrich data by injecting the value of an attribute into each Record.
Change the format of a record field’s value.

See also