// Docs

Writer model

How Refiner writer sinks run and finalize outputs

A writer is a sink attached to a pipeline. It receives output blocks from workers and writes files, media, metadata, or reducer inputs.

Common writer behavior

BehaviorWhy it matters
Shard-local writesWorkers can write independently.
Worker-aware filenamesAvoids collisions between workers.
Asset handlingMedia columns can be copied, uploaded, remuxed, or transcoded.
Follow-up stagesSome formats need final cleanup, merging, or metadata passes.

Attaching a writer

pipeline = pipeline.write_parquet("/tmp/output")

This returns a new pipeline with a sink. It does not write immediately.

Writers that need multiple execution stages expand automatically when the pipeline is launched. Keep using the normal write_* method; then(...) is only needed when you are composing separate pipelines yourself.

Launching

pipeline.launch_local(name="write-test", num_workers=2)