PersistedAggregation is a datatype for a persisted aggregation configuration.

This datatype is used by the createPersistedAggregation(), enablePersistedAggregation(), disablePersistedAggregation(), updatePersistedAggregation(), and deletePersistedAggregation() mutations. It's also used by the persistedAggregations() query.

Table: PersistedAggregation

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Mar 30, 2026
descriptionstring  PreviewThe description of the persisted aggregation.
enabledbooleanyes PreviewWhether the persisted aggregation is enabled.
idstringyes PreviewThe unique identifier of the persisted aggregation.
labels[string]yes PreviewThe labels associated with the aggregation.
namestringyes PreviewThe name of the persisted aggregation.
queryOwnershipTypestringyes PreviewThe ownership type of the query.
queryStringstringyes PreviewThe query string for the aggregation.
schedulePersistedAggregationScheduleyes PreviewThe schedule configuration for the aggregation. See PersistedAggregationSchedule.
viewNamestringyes PreviewThe name of the view to which the persisted aggregation belongs.