jerryshao commented on code in PR #8229: URL: https://github.com/apache/gravitino/pull/8229#discussion_r2306542243
########## docs/manage-statistics-in-gravitino.md: ########## @@ -0,0 +1,299 @@ +--- +title: "Manage statistics in Gravitino" +slug: /manage-statistics-in-gravitino +date: 2025-08-21 +keyword: statistics management, statistics, statistic, Gravitino +license: This software is licensed under the Apache License version 2. +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +## Introduction + +Starting from 1.0.0, Gravitino introduces statistics of tables and partitions. + +This document provides a brief introduction by using both Gravitino Java client and +REST APIs. If you want to know more about the statistics system in Gravitino, please refer to the +Javadoc and REST API documentation. + +Statistics only support the custom statistics, which names must start with `custom-`. +Gravitino will support build-in statistics in the future. + +Statistics are used by query engine for cost-based optimization (CBO). Meanwhile, statistics can also +be used for metadata action systems to trigger some jobs, such as compaction, data archive, etc. + +You can define statistics and add the policy related the statistics, users analyze the statistics +and policy to decide the next action. + +Now, Gravitino won't handle the computation of the statistics, you need to compute the statistics +and update it to Gravitino by yourself. Gravitino can't judge the expiration of the statistics, Review Comment: "update them to the Gravitino..." -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
