Skip to content

🔀 Write Disposition in Ferry

Write Disposition determines how Ferry handles data when writing to a destination. It defines whether new data should be replaced, appended, or merged with existing data.

Ferry supports multiple write strategies to accommodate different data ingestion use cases.

📌 Supported Write Dispositions

DispositionBehavior
replaceDrops existing data in the destination and writes the new dataset.
appendAdds new records without modifying existing data.
mergeMerges incoming records with existing ones based on a primary key.

🔄 Choosing the Right Write Disposition

  • Use replace when you need a fresh dataset every time (e.g., full data refresh).
  • Use append when you want to continuously add data (e.g., log files, time-series data).
  • Use merge when you need to consolidate updates with existing data.

Released under the MIT License.