GraalVM FileTransform

GraalVM FileTransform

Certified

Transform rows with JavaScript on GraalVM

Streams rows from from (kestra:// URI, map, or list), lets JavaScript mutate row, and writes the result as an ION file. Set concurrent for parallel processing (order not preserved). Set row = null to drop a record; set rows array to emit multiple rows.

yaml
type: io.kestra.plugin.graalvm.js.FileTransform
yaml
id: transformJs
namespace: company.team

tasks:
  - id: download
    type: io.kestra.plugin.core.http.Download
    uri: https://dummyjson.com/carts/1
  - id: jsonToIon
    type: io.kestra.plugin.serdes.json.JsonToIon
    from: "{{outputs.download.uri}}"
  - id: transformJs
    type: io.kestra.plugin.graalvm.js.FileTransform
    from: "{{ outputs.jsonToIon.uri }}"
    script: |
      if (row['id'] === 666) {
        // remove un-needed row
        row = null
      } else {
        // remove the 'products' column
        row['products'] = null;
        // add a 'totalItems' column
        row['totalItems'] = row['totalProducts'] * row['totalQuantity']
      }
Properties

Source file containing rows to transform

Accepts a kestra:// internal storage URI, map, or list; rows stream into the script before being rewritten as ION

Script body to execute

Template-rendered source code run by GraalVM in the selected language; flow variables are resolved before execution

Parallel transformations to execute

Number of concurrent workers; ordering is not preserved when set and execution defaults to sequential when null

Reference (ref) of the pluginDefaults to apply to this task.

Formaturi

URI of a temporary result file

The file will be serialized as an ION file.

Unitcount

Number of records or entities processed by the JavaScript script. This includes both modified and filtered rows from the input file.