[Doc] add doc for bucket-aware execution (backport #62164) (#62194)

Signed-off-by: zombee0 <ewang2027@gmail.com>
Signed-off-by: 絵空事スピリット <wanglichen@starrocks.com>
Co-authored-by: zombee0 <ewang2027@gmail.com>
Co-authored-by: 絵空事スピリット <wanglichen@starrocks.com>

docs/en/sql-reference/System_variable.md

@@ -683,6 +683,22 @@ Default value: `true`.
 * **Default**: false
 * **Introduced in**: v2.5
 
+### enable_bucket_aware_execution_on_lake
+
+* **Description**: Whether to enable bucket-aware execution for queries against data lakes (such as Iceberg tables). When this feature is enabled, the system optimizes query execution by leveraging bucketing information to reduce data shuffling and improve performance. This optimization is particularly effective for join operations and aggregations on bucketed tables.
+* **Default**: true
+* **Data type**: Boolean
+* **Introduced in**: v4.0
+
+### lake_bucket_assign_mode
+
+* **Description**: The bucket assignment mode for queries against tables in data lakes. This variable controls how buckets are distributed among worker nodes when bucket-aware execution takes effect during query execution. Valid values:
+  * `balance`: Distributes buckets evenly across worker nodes to achieve balanced workload and better performance.
+  * `elastic`: Uses consistent hashing to assign buckets to worker nodes, which can provide better load distribution in elastic environments.
+* **Default**: balance
+* **Data type**: String
+* **Introduced in**: v4.0
+
 ### enable_pipeline_engine
 
 * **Description**: Specifies whether to enable the pipeline execution engine. `true` indicates enabled and `false` indicates the opposite. Default value: `true`.

docs/ja/sql-reference/System_variable.md

@@ -667,6 +667,22 @@ MySQL クライアント互換性のために使用されます。実際の用
 * **デフォルト**: false
 * **導入バージョン**: v2.5
 
+### enable_bucket_aware_execution_on_lake
+
+* **説明**: データレイク（例：Iceberg テーブル）に対するクエリにおいて、Bucket-aware 実行を有効にするかどうか。この機能を有効にすると、システムはバケット情報を活用してデータシャッフルを削減し、パフォーマンスを向上させることでクエリの実行を最適化します。この最適化は、バケット化されたテーブルにおける Join 操作や集計処理において特に効果的です。
+* **デフォルト**: true
+* **タイプ**: Boolean
+* **導入バージョン**: v4.0
+
+### lake_bucket_assign_mode
+
+* **説明**: データレイク内のテーブルに対するクエリにおけるバケット割り当てモード。この変数は、クエリ実行中に Bucket-aware 実行が有効になった際に、バケットがワーカーノードにどのように割り当てられるかを制御します。有効な値:
+  * `balance`: ワーカーノードにバケットを均等に割り当て、バランスの取れたワークロードとより良いパフォーマンスを実現します。
+  * `elastic`: 一貫性ハッシュを使用してバケットをワーカーノードに割り当て、弾力的な環境においてより良い負荷分散を実現できます。
+* **デフォルト**: balance
+* **タイプ**: String
+* **導入バージョン**: v4.0
+
 ### enable_pipeline_engine
 
 * **説明**: パイプライン実行エンジンを有効にするかどうかを指定します。`true` は有効を示し、`false` は無効を示します。デフォルト値: `true`。

docs/zh/sql-reference/System_variable.md

@@ -668,6 +668,22 @@ ALTER USER 'jack' SET PROPERTIES ('session.query_timeout' = '600');
 * 默认值：false
 * 引入版本：v2.5
 
+### enable_bucket_aware_execution_on_lake
+
+* 描述：是否针对数据湖（如 Iceberg 表）查询启用 Bucket-aware 执行。启用后，系统通过利用分桶信息来优化查询执行，减少数据 Shuffle 并提高性能。此优化对分桶表的 Join 和 Aggregation 特别有效。
+* 默认值：true
+* 数据类型：Boolean
+* 引入版本：v4.0
+
+### lake_bucket_assign_mode
+
+* 描述：数据湖表查询的分桶分配模式。此变量控制系统执行查询期间启用 Bucket-aware 执行时如何将分桶分配给工作节点。有效值：
+  * `balance`：在工作节点间均匀分配分桶以实现负载均衡，以获取更好的性能。
+  * `elastic`：使用一致性哈希将分桶分配给工作节点，可以在弹性环境中提供更好的负载分配。
+* 默认值：balance
+* 数据类型：String
+* 引入版本：v4.0
+
 ### enable_pipeline_engine
 
 * 描述：是否启用 Pipeline 执行引擎。`true`：启用（默认），`false`：不启用。