Write
Write is the standard relational or warehouse table writer. Configuration:- Connection and target object: Database, schema, table (or equivalent).
- Write mode: See Write modes below.
- Key columns (for upserts): Primary or business keys used for merge semantics.
- Column map: Source to target names and casts.
- Pre/post SQL (when supported): Run maintenance statements cautiously—document and review.
Cloud Destination
Cloud Destination writes to object stores (Amazon S3, Google Cloud Storage, Azure Blob) or similar with format options. Configuration:- Path template: Partition folders (
year=2025/month=03/) for query engines. - File format: Parquet, CSV, JSON Lines, Avro—match consumers.
- Compression: Snappy, ZSTD, gzip—balance CPU vs storage.
- Credentials: Via connections; avoid embedding keys in paths.
Iceberg Destination (professional+)
Iceberg Destination commits Apache Iceberg snapshots with ACID properties when your catalog is wired correctly. Configuration:- Table identifier and catalog.
- Write mode: Append vs overwrite partitions vs merge (per support matrix).
- Schema evolution: Coordinate with Schema Evolution nodes when columns change.
Webhook Action
Webhook Action POSTs (or otherwise invokes) an HTTP endpoint with a payload built upstream—often from a JSON Builder. Configuration:- URL, method, headers: Include auth headers via secret references.
- Body: Template bound to row batches or single aggregate payloads.
- Batching: Rows per request to respect API limits.
- Retry / timeout: Align with partner SLAs.
Write modes
- Insert
- Upsert
- Truncate and load
- Append
Insert appends new rows only. The run fails on unique-key violations if the target enforces constraints—good for append-only facts with surrogate keys generated upstream.
Pre-flight checklist
Confirm environment
Verify variables and environments so you do not write to production with dev credentials—or the reverse.
Align grain and keys
Upsert keys must match the grain you intend (per line item vs per order). Test with duplicate-source scenarios.
Dry run or preview
Preview upstream nodes; for relational targets, run against staging schemas first.
Related nodes
Sources
Read back what you wrote for reconciliation jobs.
Data quality
Validate before and after loads.