Skip to main content

REFRESH AGGREGATING INDEX

Introduced or updated: v1.2.151
ENTERPRISE EDITION FEATURE
AGGREGATING INDEX is an Enterprise Edition feature. Contact Databend Support for a license.

Refreshes an aggregating index to update its stored results. Databend recommends refreshing an aggregating index before executing a query that relies on it to retrieve the most up-to-date data.

note

When using Databend Cloud, manual execution of this refresh command is unnecessary, as the system automatically handles index updates for you.

Syntax

REFRESH AGGREGATING INDEX <index_name> [LIMIT <limit>]

The "LIMIT" parameter allows you to control the maximum number of blocks that can be updated with each refresh action. It is strongly recommended to use this parameter with a defined limit to optimize memory usage. Please also note that setting a limit may result in partial data updates. For example, if you have 100 blocks but set a limit of 10, a single refresh might not update the most recent data, potentially leaving some blocks unrefreshed. You may need to execute multiple refresh actions to ensure a complete update.

Examples

This example refreshes an aggregating index named my_agg_index:

REFRESH AGGREGATING INDEX my_agg_index;
Explore Databend Cloud for FREE
Low-cost
Fast Analytics
Easy Data Ingestion
Elastic Scaling
Try it today