Query caching and scheduling
How to control when your queries run.
Last updated
How to control when your queries run.
Last updated
Caching must first be enabled in your workspace settings:
Query result caching is only available on paid plans.
In the right sidebar, when no objects are selected the current caching settings for the canvas are displayed. To update these settings, click the Change button.
These settings are only accessible by analysts and above.
In the caching settings menu, there are three options for caching query results:
Never cache results
With this setting, whenever your canvas or report is opened, the queries for any visible cells will be sent to your database, ensuring the most up-to-date data possible. This option will result in the largest load on your database.
Cache results for...
With this setting, query results are saved for the specified duration. If the same query is run repeatedly within that time window, then cached results are returned. This option is often a reasonable trade-off between improving result freshness while reducing load on your database.
If cells are edited or executed using the Run cell button, then queries are always re-run.
Cache results indefinitely
With this setting, queries will not run unless cells are edited or executed using the Run cell button. This option minimises database load, but may result in old data being displayed.
If a schedule is selected, Count will execute the cells in this canvas that are connected to databases periodically. These scheduled queries are always run, even if cached results are available, and the new results will update those in the cache.
By default all canvas cells are executed, but it is possible to execute fewer cells by hiding or disabling cells, and choosing the appropriate option.