A filtered view is a queryable filter of a table or another view. A filtered view can be created by filtering an existing table or view using the /filter endpoint.
Filtered views can be updated to insert the missing data points for a series from the underlying table using /update/records/byseries.
Given the need to minimize memory usage, filtered views are given a default time-to-live, after which they will expire and be removed from memory. Each access of the filtered view causes the remaining time-to-live to be reset. Thus, a filtered view accessed more frequently than its time-to-live will effectively remain in memory indefinitely.
Creating a Filtered View
To create a filtered view, the /filter endpoint requires three parameters:
- the name of the data set to create the filtered view from
- the name of the filtered view to create
- an expression used to filter the source data set
In Python, given the nyctaxi demo table, a filtered view can be created for all taxi rides from the YCAB vendor via:
The resulting filtered view can then be further filtered for expensive single-passenger rides:
Limitations and Cautions
- When a record contained in a filtered view is modified by an update of the underlying data set, the record is removed from the filtered view regardless of whether the update impacted the record's qualifications for membership in the filtered view.
- When a table or view is dropped, all of the filtered views created from it are also automatically cleared.
- Records accessible through a filtered view cannot be added, edited, or deleted through that same view.
- A filtered view is transient, by default, and will expire after the default TTL setting.
- A filtered view is not persisted, and will not survive a database restart.