Split Processor
editSplit Processor
editSplits a field into an array using a separator character. Only works on string fields.
Table 63. Split Options
Name | Required | Default | Description |
---|---|---|---|
|
yes |
- |
The field to split |
|
yes |
- |
A regex which matches the separator, eg |
|
no |
|
The field to assign the split value to, by default |
|
no |
|
If |
|
no |
|
Preserves empty trailing fields, if any. |
|
no |
- |
Conditionally execute this processor. |
|
no |
- |
Handle failures for this processor. See Handling Failures in Pipelines. |
|
no |
|
Ignore failures for this processor. See Handling Failures in Pipelines. |
|
no |
- |
An identifier for this processor. Useful for debugging and metrics. |
If the preserve_trailing
option is enabled, any trailing empty fields in the input will be preserved. For example,
in the configuration below, a value of A,,B,,
in the my_field
property will be split into an array of five elements
["A", "", "B", "", ""]
with two empty trailing fields. If the preserve_trailing
property were not enabled, the two
empty trailing fields would be discarded resulting in the three-element array ["A", "", "B"]
.
{ "split": { "field": "my_field", "separator": ",", "preserve_trailing": true } }