diff --git a/system-variables.md b/system-variables.md index ad2f66af70a0e..fa2e196ad572f 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1141,6 +1141,19 @@ MPP is a distributed computing framework provided by the TiFlash engine, which a +### `tidb_ddl_distribute_reorg` New in v6.6.0 + +> **Warning:** +> +> - This feature is still in the experimental stage. It is not recommended to enable this feature in production environments. +> - When this feature is enabled, TiDB only performs simple retries when an exception occurs during the DDL reorg phase. There is currently no retry method that is compatible with DDL operations. That is, you cannot control the number of retries using [`tidb_ddl_error_count_limit`](#tidb_ddl_error_count_limit). + +- Scope: GLOBAL +- Persists to cluster: Yes +- Default value: `OFF` +- This variable is used to control whether to enable distributed execution of the DDL reorg phase to improve the speed of this phase. Currently, this variable is only valid for the `ADD INDEX` statement. Enabling this variable improves the performance of large tables. Distributed DDL execution can control the CPU usage of DDL through dynamic DDL resource management to prevent DDL from affecting the online application. +- To verify whether a completed `ADD INDEX` operation is accelerated by this feature, you can check whether a corresponding task is in the `mysql.tidb_background_subtask_history` table. + ### tidb_ddl_error_count_limit - Scope: GLOBAL