Skip to content

Writes project tables to a document account as Apache ORC files, one file for each table. ORC is a columnar format read by Hive, Spark, and most cloud data platforms, with the schema carried in the file. Pair it with Import ORC.

The step form has a File Parameters page for the target file, prefix, compression and what happens when the file exists, and a Record Parameters page that lists the tables to export, each with its own table data selection and data filters. Migrated KNIME workflows use this step for ORC writers.

  • Target File (output_file) — the Document account and folder the files are written to.
  • Target File Prefix (file_name) — the file prefix. Each table is written as <prefix><table name>.orc.
  • Compression Option (compression) — the ORC codec used inside the file: Snappy, zlib, gzip (written as zlib), Zstandard or LZ4. None writes the file uncompressed.
  • Record Parameters (frames) — the tables to export. Each frame carries its own table settings; a table-level setting placed at the top of the step instead of inside a frame is not read.
    • id — the table’s label in warnings.
    • source — the project table to export. Each file is named from it.
    • source_columns and target_columns — the columns read and the columns written, with any rename, type, and per-column aggregation.
    • source_where — a filter on the source rows.
    • aggregate and aggregation_type — summarize the rows; aggregation_type is the summarization applied to columns that do not set their own.
    • having — a filter on the summarized rows.
    • distinct — write distinct rows only.
    • use_target_slicer, limit_target_start, and limit_target_end — write only the rows from the start position up to the end position of the result.
    • sort_columns — set with an AI assistant or the REST API to order the written rows by these source columns, first key first, each {source, ascending, nulls}. A key column need not be written. nulls defaults to first ascending and last descending. Not used with aggregate or distinct.
  • A File That Exists (if_exists), under If the File Exists — Overwrite it (overwrite, default) replaces a file that is already there; Fail the step, writing nothing (fail) stops the step, writing nothing, when a file it would write already exists.