Storage output — storageOutput
Write the result of a flow to a cloud object store (AWS S3, Google Cloud Storage, Azure Blob Storage) or a local folder via a reusable Storage Connection. The result is serialized and uploaded after the rest of the flow succeeds — a write failure marks the run failed.
- 1InputStorage Inputs3://
raw-data/ orders.csv - 2CleanDrop Nulls
- 3TransformGroup By + Aggregaterevenue by region
- 4OutputStorage Outputs3://
reports/ summary.parquet · overwrite
Use cases
- Land a cleaned or aggregated result in a company bucket for downstream consumers.
- Write a daily report parquet to GCS on a schedule.
- Archive processed outputs to Azure Blob alongside raw files.
Configuration
| Config key | Type | Required | Description |
|---|---|---|---|
connection_id | string | Yes | The storage connection to write to |
path | string | Yes | Destination path inside the bucket/container/folder (e.g. reports/summary.parquet) |
format | string | No | parquet (default), csv, tsv, excel, json, jsonl, or text |
if_exists | string | No | overwrite (default) or error |
Generated Python code
The exported script is portable, so it never embeds cloud credentials or an upload call tied to one provider's SDK. Instead it leaves a marker for the write:
python
# storageOutput: write df_4 to your configured storage targetTips & common mistakes
- Parquet is the default format and the best choice for downstream data
pipelines — it preserves types and compresses well. Use
csvif the destination requires it. overwritereplaces the object silently. Setif_exists: errorto abort rather than overwrite an existing file, which is useful in append-style workflows where you'd rather fail loud than silently clobber old data.- The run is marked failed if the upload fails. No partial writes are left behind — Ciaren pushes the output only after every upstream node succeeds.
See also
- Storage input — read from the same bucket in the same or another flow
- Database Connections — create and manage storage connections
- File output — download the result as a local file instead