What is Iceberg Maintenance?

In Apache Iceberg, table maintenance is the process of keeping tables efficient and performant as data is continuously added, updated, or deleted. As an Iceberg table evolves, it can accumulate small data files, delete files, and additional metadata. Over time, this can make the table less efficient for querying and increase storage and compute overhead.

Maintenance operations helps address this by keeping the table well-organized, compact, and efficient for query engines, ensuring consistent performance as data grows.

When is Table Maintenance Required?

In Apache Iceberg, table maintenance should be performed periodically to ensure consistent query performance and efficient storage as data evolves.

You should consider running maintenance in the following scenarios:

• Frequent Data Ingestion or Updates

• Accumulation of Small Files

• Presence of Delete Files

• High Partition Cardinality

• Degrading Query Performance

• Growing Table Size Over Time

Regular maintenance ensures that Iceberg tables remain compacted, scalable, and performant for analytical workloads.

Maintenance in the OLake UI

Iceberg Maintenance is available starting from v0.4.0. Upgrade OLake UI to access the Maintenance module.

• Existing users (Docker): If you are already using OLake for Ingestion, follow the upgrade guide to access the Maintenance module.
• Existing users (Helm / Kubernetes): If you are running OLake on Kubernetes, follow the chart upgrade guide to access the Maintenance module.
• New Users (Docker): Follow the quickstart guide to get started.
• New Users (Helm / Kubernetes): Follow the quickstart guide to get started.