Updating data in data sources

(Enterprise customers only) Hoverfly Cloud supports the use of CSV data sources so that you can do key value data lookups and simulate persistence within your simulations.

Updating data in a CSV Data Source

You can update data within a CSV data source on the fly within your simulation just as if your API were updating a real data source. The data is modified for the duration that the service is running. When the service is restarted, the data will revert to what was in the original uploaded CSV.

For illustration we will use this data source called "pets":

id	category	name	status
1000	birds	Archie	available
1001	dogs	Zipper	available
1002	dogs	Teddy	sold

Update data with {{csvSqlCommand}}

A simplified SQL like syntax can be used to update the data in a csv data source. (This syntax can also be used to SELECT and DELETE from the data source. You cannot insert using this syntax however there is a mechanism which can be read about here.)

You can read more about using this SQL like syntax here.

Syntax:

{{ csvSqlCommand '(sql-update-statement)' }}

Template Example: Set the status of pets with a name of 'Archie' to 'sold'

{{ csvSqlCommand "UPDATE pets SET status = 'sold' WHERE name = 'Archie' }}

Result:

There is no output from an UPDATE statement but the data in memory for all subsequent calls to the API simulation will be modified as follows:

id	category	name	status
1000	birds	Archie	sold
1001	dogs	Zipper	available
1002	dogs	Teddy	sold