From 32c4d589eb480e4312392986d73647f1ef05d448 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 30 Jun 2025 14:12:00 +0800 Subject: [PATCH 1/7] Add temp.md --- temp.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 temp.md diff --git a/temp.md b/temp.md new file mode 100644 index 0000000000000..af27ff4986a7b --- /dev/null +++ b/temp.md @@ -0,0 +1 @@ +This is a test file. \ No newline at end of file From fd02c5c7aec66a4cdc20efecf86c2357671391ab Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 30 Jun 2025 14:12:04 +0800 Subject: [PATCH 2/7] Delete temp.md --- temp.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 temp.md diff --git a/temp.md b/temp.md deleted file mode 100644 index af27ff4986a7b..0000000000000 --- a/temp.md +++ /dev/null @@ -1 +0,0 @@ -This is a test file. \ No newline at end of file From fe93098d99ad26036de404d8f4b36f957e84705d Mon Sep 17 00:00:00 2001 From: Test User Date: Mon, 30 Jun 2025 14:47:18 +0800 Subject: [PATCH 3/7] add translation --- pd-control.md | 30 ++++++++++++++++++++++++++---- tiflash/tiflash-configuration.md | 14 ++++++++++++++ 2 files changed, 40 insertions(+), 4 deletions(-) diff --git a/pd-control.md b/pd-control.md index 30b55e17544e2..d06f5f98adba7 100644 --- a/pd-control.md +++ b/pd-control.md @@ -1336,15 +1336,37 @@ store --jq='.stores[].store | select(.state_name!="Up") | {id, address, state_na ### Query all TiFlash nodes -{{< copyable "" >}} - ```bash store --jq='.stores[].store | select(.labels | length>0 and contains([{"key":"engine","value":"tiflash"}])) | {id, address, state_name}' ``` +```json +{"id":1,"address":"127.0.0.1:20161","state_name":"Up"} +{"id":5,"address":"127.0.0.1:20162","state_name":"Up"} +... +``` + +### Query TiFlash nodes in the disaggregated storage and compute architecture + +Query TiFlash Write Nodes in the [disaggregated storage and compute architecture](/tiflash/tiflash-disaggregated-and-s3.md): + +```bash +store --jq='.stores[].store | select(.labels | length>0 and contains([{"key":"engine","value":"tiflash"}, {"key":"engine_role","value":"write"}])) | {id, address, labels, state_name}' +``` + +```json +{"id":130,"address":"172.31.8.1:10161","labels":[{"key":"engine_role","value":"write"},{"key":"engine","value":"tiflash"}],"state_name":"Up"} +... +``` + +Query TiFlash Compute Nodes in the [disaggregated storage and compute architecture](/tiflash/tiflash-disaggregated-and-s3.md): + +```bash +store --jq='.stores[].store | select(.labels | length>0 and contains([{"key":"engine","value":"tiflash_compute"}])) | {id, address, labels, state_name}' ``` -{"id":1,"address":"127.0.0.1:20161""state_name":"Up"} -{"id":5,"address":"127.0.0.1:20162""state_name":"Up"} + +```json +{"id":131,"address":"172.31.9.1:10161","labels":[{"key":"engine","value":"tiflash_compute"}],"state_name":"Up"} ... ``` diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 0ba3b83c37c67..00db5ee3f3f34 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -121,6 +121,14 @@ Configure storage path related settings. - Unit: Byte. Note that human-readable numbers such as `"10GB"` are not supported yet. - The size of the `capacity` list should be the same with the [`storage.main.dir`](#dir) size. +#### `storage.api_version` New in v9.0.0 + +- The API version that TiFlash uses to communicate with PD and TiKV. +- Optional values: + - `1`: TiFlash uses API V1 to communicate with PD and TiKV. + - `2`: TiFlash uses API V2 to communicate with PD and TiKV to support the multi-tenancy feature. +- Default value: `1` + #### storage.latest ##### `dir` @@ -438,6 +446,12 @@ Note that the following parameters only take effect in TiFlash logs and TiFlash - Specifies the minimum ratio of valid data in a PageStorage data file. When the ratio of valid data in a PageStorage data file is less than the value of this configuration, GC is triggered to compact data in the file. - Default value: `0.5` +##### `disagg_blocklist_wn_store_id` New in v9.0.0 + +- In the disaggregated storage and compute architecture, specifies the TiFlash Write Nodes that TiFlash Compute Nodes do not send requests to. +- The value is a string consisting of `store_id`s separated by `,`. For example, setting it to `"140,141"` means that TiFlash Compute Nodes will not send requests to TiFlash Write Nodes with `store_id` `140` or `141`. You can use [pd-ctl](/pd-control.md#query-tiflash-nodes-in-the-disaggregated-storage-and-compute-architecture) to query the `store_id` of TiFlash Write Nodes in the cluster. +- Default value: `""`. It means that TiFlash Compute Nodes send requests to all TiFlash Write Nodes. + ##### `max_bytes_before_external_group_by` New in v7.0.0 - Specifies the maximum memory available for the Hash Aggregation operator with the `GROUP BY` key before a disk spill is triggered. When the memory usage exceeds the threshold, Hash Aggregation reduces memory usage by [spilling to disk](/tiflash/tiflash-spill-disk.md). From 729f816f5915dc5e546057855fb58916444cc344 Mon Sep 17 00:00:00 2001 From: Test User Date: Mon, 30 Jun 2025 14:48:13 +0800 Subject: [PATCH 4/7] Update pd-control.md --- pd-control.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pd-control.md b/pd-control.md index d06f5f98adba7..709e3637c0259 100644 --- a/pd-control.md +++ b/pd-control.md @@ -1340,7 +1340,7 @@ store --jq='.stores[].store | select(.state_name!="Up") | {id, address, state_na store --jq='.stores[].store | select(.labels | length>0 and contains([{"key":"engine","value":"tiflash"}])) | {id, address, state_name}' ``` -```json +``` {"id":1,"address":"127.0.0.1:20161","state_name":"Up"} {"id":5,"address":"127.0.0.1:20162","state_name":"Up"} ... @@ -1354,7 +1354,7 @@ Query TiFlash Write Nodes in the [disaggregated storage and compute architecture store --jq='.stores[].store | select(.labels | length>0 and contains([{"key":"engine","value":"tiflash"}, {"key":"engine_role","value":"write"}])) | {id, address, labels, state_name}' ``` -```json +``` {"id":130,"address":"172.31.8.1:10161","labels":[{"key":"engine_role","value":"write"},{"key":"engine","value":"tiflash"}],"state_name":"Up"} ... ``` From aff5753f98bc03494061ea6ed8811a03f36ee33b Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 30 Jun 2025 16:05:50 +0800 Subject: [PATCH 5/7] Update tiflash/tiflash-configuration.md Co-authored-by: JaySon --- tiflash/tiflash-configuration.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 00db5ee3f3f34..2cab1b17b876d 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -450,7 +450,8 @@ Note that the following parameters only take effect in TiFlash logs and TiFlash - In the disaggregated storage and compute architecture, specifies the TiFlash Write Nodes that TiFlash Compute Nodes do not send requests to. - The value is a string consisting of `store_id`s separated by `,`. For example, setting it to `"140,141"` means that TiFlash Compute Nodes will not send requests to TiFlash Write Nodes with `store_id` `140` or `141`. You can use [pd-ctl](/pd-control.md#query-tiflash-nodes-in-the-disaggregated-storage-and-compute-architecture) to query the `store_id` of TiFlash Write Nodes in the cluster. -- Default value: `""`. It means that TiFlash Compute Nodes send requests to all TiFlash Write Nodes. +- If the value is an empty string `""`, it means that TiFlash Compute Nodes send requests to all TiFlash Write Nodes. +- Default value: `""` ##### `max_bytes_before_external_group_by` New in v7.0.0 From 74eb969e720a685e690944817843944b5058671f Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 30 Jun 2025 16:39:57 +0800 Subject: [PATCH 6/7] Update tiflash/tiflash-configuration.md --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 2cab1b17b876d..c690a63b625b8 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -124,7 +124,7 @@ Configure storage path related settings. #### `storage.api_version` New in v9.0.0 - The API version that TiFlash uses to communicate with PD and TiKV. -- Optional values: +- Value options: - `1`: TiFlash uses API V1 to communicate with PD and TiKV. - `2`: TiFlash uses API V2 to communicate with PD and TiKV to support the multi-tenancy feature. - Default value: `1` From fc91e41f359093a739bc9ad4fc20d11fa8e80adf Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 24 Jul 2025 17:21:36 +0800 Subject: [PATCH 7/7] Update tiflash/tiflash-configuration.md Co-authored-by: Aolin --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index c690a63b625b8..dc85b85f9aefd 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -449,7 +449,7 @@ Note that the following parameters only take effect in TiFlash logs and TiFlash ##### `disagg_blocklist_wn_store_id` New in v9.0.0 - In the disaggregated storage and compute architecture, specifies the TiFlash Write Nodes that TiFlash Compute Nodes do not send requests to. -- The value is a string consisting of `store_id`s separated by `,`. For example, setting it to `"140,141"` means that TiFlash Compute Nodes will not send requests to TiFlash Write Nodes with `store_id` `140` or `141`. You can use [pd-ctl](/pd-control.md#query-tiflash-nodes-in-the-disaggregated-storage-and-compute-architecture) to query the `store_id` of TiFlash Write Nodes in the cluster. +- The value is a comma-separated string of `store_id` values. For example, setting it to `"140,141"` means that TiFlash Compute Nodes will not send requests to TiFlash Write Nodes with `store_id` `140` or `141`. You can use [pd-ctl](/pd-control.md#query-tiflash-nodes-in-the-disaggregated-storage-and-compute-architecture) to query the `store_id` of TiFlash Write Nodes in the cluster. - If the value is an empty string `""`, it means that TiFlash Compute Nodes send requests to all TiFlash Write Nodes. - Default value: `""`