replace chinese punctuation (#8940) (#8960)

agg-distinct-optimization.md

@@ -9,7 +9,7 @@ This document introduces the `distinct` optimization in the TiDB query optimizer
 
 ## `DISTINCT` modifier in `SELECT` statements
 
-The `DISTINCT` modifier specifies removal of duplicate rows from the result set. `SELECT DISTINCT` is transformed to `GROUP BY`, for example：
+The `DISTINCT` modifier specifies removal of duplicate rows from the result set. `SELECT DISTINCT` is transformed to `GROUP BY`, for example:
 
 ```sql
 mysql> explain SELECT DISTINCT a from t;

alert-rules.md

@@ -434,7 +434,7 @@ This section gives the alert rules for the TiKV component.
 
     1. Perform `SELECT VARIABLE_VALUE FROM mysql.tidb WHERE VARIABLE_NAME = "tikv_gc_leader_desc"` to locate the `tidb-server` corresponding to the GC leader;
     2. View the log of the `tidb-server`, and grep gc_worker tidb.log;
-    3. If you find that the GC worker has been resolving locks (the last log is "start resolve locks") or deleting ranges (the last log is “start delete {number} ranges”) during this time, it means the GC process is running normally. Otherwise, contact [[email protected]](mailto:[email protected]) to resolve this issue.
+    3. If you find that the GC worker has been resolving locks (the last log is "start resolve locks") or deleting ranges (the last log is "start delete {number} ranges") during this time, it means the GC process is running normally. Otherwise, contact [[email protected]](mailto:[email protected]) to resolve this issue.
 
 ### Critical-level alerts
 
@@ -632,7 +632,7 @@ This section gives the alert rules for the TiKV component.
 
 * Alert rule:
 
-    `histogram_quantile(0.999, sum(rate(tikv_raftstore_raft_process_duration_secs_bucket{type=’tick’}[1m])) by (le, instance, type)) > 2`
+    `histogram_quantile(0.999, sum(rate(tikv_raftstore_raft_process_duration_secs_bucket{type='tick'}[1m])) by (le, instance, type)) > 2`
 
 * Description:
 
@@ -750,7 +750,7 @@ This section gives the alert rules for the TiKV component.
 
 * Solution:
 
-    The speed of splitting Regions is slower than the write speed. To alleviate this issue, you’d better update TiDB to a version that supports batch-split (>= 2.1.0-rc1). If it is not possible to update temporarily, you can use `pd-ctl operator add split-region <region_id> --policy=approximate` to manually split Regions.
+    The speed of splitting Regions is slower than the write speed. To alleviate this issue, you'd better update TiDB to a version that supports batch-split (>= 2.1.0-rc1). If it is not possible to update temporarily, you can use `pd-ctl operator add split-region <region_id> --policy=approximate` to manually split Regions.
 
 ## TiFlash alert rules
 

benchmark/benchmark-tidb-using-sysbench.md

@@ -26,7 +26,7 @@ There are multiple Column Families on TiKV cluster which are mainly used to stor
 
 Default CF : Write CF = 4 : 1
 
-Configuring the block cache of RocksDB on TiKV should be based on the machine’s memory size, in order to make full use of the memory. To deploy a TiKV cluster on a 40GB virtual machine, it is recommended to configure the block cache as follows:
+Configuring the block cache of RocksDB on TiKV should be based on the machine's memory size, in order to make full use of the memory. To deploy a TiKV cluster on a 40GB virtual machine, it is recommended to configure the block cache as follows:
 
 ```yaml
 server_configs:

benchmark/online-workloads-and-add-index-operations.md

@@ -29,7 +29,7 @@ This test runs in a Kubernetes cluster deployed with 3 TiDB instances, 3 TiKV in
 | TiKV  | `4151dc8878985df191b47851d67ca21365396133` |
 |  PD   | `811ce0b9a1335d1b2a049fd97ef9e186f1c9efc1` |
 
-Sysbench version：1.0.17
+Sysbench version: 1.0.17
 
 ### TiDB parameter configuration
 

benchmark/v4.0-performance-benchmarking-with-tpcc.md

@@ -104,7 +104,7 @@ set global tidb_disable_txn_auto_retry=0;
 
 2. Use BenchmarkSQL to import the TPC-C 5000 Warehouse data.
 
-    1. Compile BenchmarkSQL：
+    1. Compile BenchmarkSQL:
 
         {{< copyable "bash" >}}
 

benchmark/v5.0-performance-benchmarking-with-tpcc.md

@@ -122,7 +122,7 @@ set global tidb_enable_clustered_index = 1;
 
 2. Use BenchmarkSQL to import the TPC-C 5000 Warehouse data.
 
-    1. Compile BenchmarkSQL：
+    1. Compile BenchmarkSQL:
 
         {{< copyable "bash" >}}
 

best-practices/java-app-best-practices.md

@@ -83,7 +83,7 @@ This section introduces parameters related to `Prepare`.
 
 ##### `useServerPrepStmts`
 
-`useServerPrepStmts` is set to `false` by default, that is, even if you use the Prepare API, the “prepare” operation will be done only on the client. To avoid the parsing overhead of the server, if the same SQL statement uses the Prepare API multiple times, it is recommended to set this configuration to `true`.
+`useServerPrepStmts` is set to `false` by default, that is, even if you use the Prepare API, the "prepare" operation will be done only on the client. To avoid the parsing overhead of the server, if the same SQL statement uses the Prepare API multiple times, it is recommended to set this configuration to `true`.
 
 To verify that this setting already takes effect, you can do:
 
@@ -128,7 +128,7 @@ To verify that this setting already takes effect, you can do:
 While processing batch writes, it is recommended to configure `rewriteBatchedStatements=true`. After using `addBatch()` or `executeBatch()`, JDBC still sends SQL one by one by default, for example:
 
 ```java
-pstmt = prepare(“insert into t (a) values(?)”);
+pstmt = prepare("insert into t (a) values(?)");
 pstmt.setInt(1, 10);
 pstmt.addBatch();
 pstmt.setInt(1, 11);
@@ -197,7 +197,7 @@ In addition, because of a [client bug](https://bugs.mysql.com/bug.php?id=96623),
 
 Through monitoring, you might notice that although the application only performs `INSERT` operations to the TiDB cluster, there are a lot of redundant `SELECT` statements. Usually this happens because JDBC sends some SQL statements to query the settings, for example, `select @@session.transaction_read_only`. These SQL statements are useless for TiDB, so it is recommended that you configure `useConfigs=maxPerformance` to avoid extra overhead.
 
-`useConfigs=maxPerformance` configuration includes a group of configurations：
+`useConfigs=maxPerformance` configuration includes a group of configurations:
 
 ```ini
 cacheServerConfiguration=true

best-practices/pd-scheduling-best-practices.md

@@ -138,8 +138,8 @@ You can use store commands of pd-ctl to query balance status of each store.
 
 The **Grafana PD/Statistics - hotspot** page shows the metrics about hot regions, among which:
 
-- Hot write region’s leader/peer distribution: the leader/peer distribution in hot write regions
-- Hot read region’s leader distribution: the leader distribution in hot read regions
+- Hot write region's leader/peer distribution: the leader/peer distribution in hot write regions
+- Hot read region's leader distribution: the leader distribution in hot read regions
 
 You can also query the status of hot regions using pd-ctl with the following commands:
 

best-practices/three-nodes-hybrid-deployment.md

@@ -41,7 +41,7 @@ tikv:
     gc.max-write-bytes-per-sec: 300K
     rocksdb.max-background-jobs: 3
     rocksdb.max-sub-compactions: 1
-    rocksdb.rate-bytes-per-sec: “200M”
+    rocksdb.rate-bytes-per-sec: "200M"
 
   tidb:
     performance.max-procs: 8

br/br-batch-create-table.md

@@ -59,7 +59,7 @@ This section describes the test information about the Batch Create Table feature
 The test result is as follows:
 
 ```
-‘[2022/03/12 22:37:49.060 +08:00] [INFO] [collector.go:67] ["Full restore success summary"] [total-ranges=751760] [ranges-succeed=751760] [ranges-failed=0] [split-region=1h33m18.078448449s] [restore-ranges=542693] [total-take=1h41m35.471476438s] [restore-data-size(after-compressed)=8.337TB] [Size=8336694965072] [BackupTS=431773933856882690] [total-kv=148015861383] [total-kv-size=16.16TB] [average-speed=2.661GB/s]’
+'[2022/03/12 22:37:49.060 +08:00] [INFO] [collector.go:67] ["Full restore success summary"] [total-ranges=751760] [ranges-succeed=751760] [ranges-failed=0] [split-region=1h33m18.078448449s] [restore-ranges=542693] [total-take=1h41m35.471476438s] [restore-data-size(after-compressed)=8.337TB] [Size=8336694965072] [BackupTS=431773933856882690] [total-kv=148015861383] [total-kv-size=16.16TB] [average-speed=2.661GB/s]'
 ```
 
 From the test result, you can see that the average speed of restoring one TiKV instance is as high as 181.65 MB/s (which equals to `average-speed`/`tikv_count`）.

br/use-br-command-line-tool.md

@@ -482,7 +482,7 @@ br restore full -f 'mysql.usertable' -s $external_storage_url --ratelimit 128
 > Although you can back up system tables (such as `mysql.tidb`) using the BR tool, BR ignores the following system tables even if you use the `--filter` setting to perform the restoration:
 >
 > - Statistical information tables (`mysql.stat_*`)
-> - System variable tables (`mysql.tidb`，`mysql.global_variables`)
+> - System variable tables (`mysql.tidb`, `mysql.global_variables`)
 > - User information tables (such as `mysql.user` and `mysql.columns_priv`)
 > - [Other system tables](https://github.com/pingcap/tidb/blob/v5.4.0/br/pkg/restore/systable_restore.go#L31)
 

choose-index.md

@@ -74,7 +74,7 @@ mysql> SHOW WARNINGS;
 
 Skyline-pruning is a heuristic filtering rule for indexes, which can reduce the probability of wrong index selection caused by wrong estimation. To judge an index, the following three dimensions are needed:
 
-- How many access conditions are covered by the indexed columns. An “access condition” is a where condition that can be converted to a column range. And the more access conditions an indexed column set covers, the better it is in this dimension.
+- How many access conditions are covered by the indexed columns. An "access condition" is a where condition that can be converted to a column range. And the more access conditions an indexed column set covers, the better it is in this dimension.
 
 - Whether it needs to retrieve rows from a table when you select the index to access the table (that is, the plan generated by the index is IndexReader operator or IndexLookupReader operator). Indexes that do not retrieve rows from a table are better on this dimension than indexes that do. If both indexes need TiDB to retrieve rows from the table, compare how many filtering conditions are covered by the indexed columns. Filtering conditions mean the `where` condition that can be judged based on the index. If the column set of an index covers more access conditions, the smaller the number of retrieved rows from a table, and the better the index is in this dimension.
 

clinic/clinic-data-instruction-for-tiup.md

@@ -65,7 +65,7 @@ This section lists the types of diagnostic data that can be collected by Diag fr
 | :------ | :------ |:-------- |
 | Log | `tiflash.log` | `--include=log` |
 | Error log | `tiflash_stderr.log` | `--include=log` |
-| Configuration file |  `tiflash-learner.toml`，`tiflash-preprocessed.toml`，`tiflash.toml` | `--include=config` |
+| Configuration file |  `tiflash-learner.toml`, `tiflash-preprocessed.toml`, `tiflash.toml` | `--include=config` |
 | Real-time configuration | `config.json` | `--include=config` |
 | Performance data | `cpu_profile.proto` | `--include=perf` |
 

develop/dev-guide-connection-parameters.md

@@ -149,7 +149,7 @@ This section introduces parameters related to `Prepare`.
 
 - **useServerPrepStmts**
 
-    **useServerPrepStmts** is set to `false` by default, that is, even if you use the Prepare API, the “prepare” operation will be done only on the client. To avoid the parsing overhead of the server, if the same SQL statement uses the Prepare API multiple times, it is recommended to set this configuration to `true`.
+    **useServerPrepStmts** is set to `false` by default, that is, even if you use the Prepare API, the "prepare" operation will be done only on the client. To avoid the parsing overhead of the server, if the same SQL statement uses the Prepare API multiple times, it is recommended to set this configuration to `true`.
 
     To verify that this setting already takes effect, you can do:
 
@@ -265,7 +265,7 @@ In addition, because of a [client bug](https://bugs.mysql.com/bug.php?id=96623),
 
 Through monitoring, you might notice that although the application only performs `INSERT` operations to the TiDB cluster, there are a lot of redundant `SELECT` statements. Usually this happens because JDBC sends some SQL statements to query the settings, for example, `select @@session.transaction_read_only`. These SQL statements are useless for TiDB, so it is recommended that you configure `useConfigs=maxPerformance` to avoid extra overhead.
 
-`useConfigs=maxPerformance` configuration includes a group of configurations：
+`useConfigs=maxPerformance` configuration includes a group of configurations:
 
 ```ini
 cacheServerConfiguration=true

develop/dev-guide-insert-data.md

@@ -20,15 +20,15 @@ Before reading this document, you need to prepare the following:
 
 There are two ways to insert multiple rows of data. For example, if you need to insert **3** players' data.
 
-- A **multi-line insertion statement**：
+- A **multi-line insertion statement**:
 
     {{< copyable "sql" >}}
 
     ```sql
     INSERT INTO `player` (`id`, `coins`, `goods`) VALUES (1, 1000, 1), (2, 230, 2), (3, 300, 5);
     ```
 
-- Multiple **single-line insertion statements**：
+- Multiple **single-line insertion statements**:
 
     {{< copyable "sql" >}}
 
@@ -160,7 +160,7 @@ In this case, you **cannot** use SQL like the following to insert:
 INSERT INTO `bookshop`.`users` (`id`, `balance`, `nickname`) VALUES (1, 0.00, 'nicky');
 ```
 
-An error will occur：
+An error will occur:
 
 ```
 ERROR 8216 (HY000): Invalid auto random: Explicit insertion on auto_random column is disabled. Try to set @@allow_auto_random_explicit_insert = true.

develop/dev-guide-join-tables.md

@@ -5,7 +5,7 @@ summary: This document describes how to use multi-table join queries.
 
 # Multi-table Join Queries
 
-In many scenarios，you need to use one query to get data from multiple tables. You can use the `JOIN` statement to combine the data from two or more tables.
+In many scenarios, you need to use one query to get data from multiple tables. You can use the `JOIN` statement to combine the data from two or more tables.
 
 ## Join types
 

develop/dev-guide-sql-development-specification.md

@@ -29,17 +29,17 @@ This document introduces some general development specifications for using SQL.
     ```sql
     SELECT gmt_create
     FROM ...
-    WHERE DATE_FORMAT(gmt_create，'%Y%m%d %H:%i:%s') = '20090101 00:00:0'
+    WHERE DATE_FORMAT(gmt_create, '%Y%m%d %H:%i:%s') = '20090101 00:00:0'
     ```
 
     Recommended:
 
     {{< copyable "sql" >}}
 
     ```sql
-    SELECT DATE_FORMAT(gmt_create，'%Y%m%d %H:%i:%s')
+    SELECT DATE_FORMAT(gmt_create, '%Y%m%d %H:%i:%s')
     FROM .. .
-    WHERE gmt_create = str_to_date('20090101 00:00:00'，'%Y%m%d %H:%i:s')
+    WHERE gmt_create = str_to_date('20090101 00:00:00', '%Y%m%d %H:%i:s')
     ```
 
 ## Other specifications

develop/dev-guide-transaction-restraints.md

@@ -17,7 +17,7 @@ The isolation levels supported by TiDB are **RC (Read Committed)** and **SI (Sna
 
 The `SI` isolation level of TiDB can avoid **Phantom Reads**, but the `RR` in ANSI/ISO SQL standard cannot.
 
-The following two examples show what **phantom reads** is. 
+The following two examples show what **phantom reads** is.
 
 - Example 1: **Transaction A** first gets `n` rows according to the query, and then **Transaction B** changes `m` rows other than these `n` rows or adds `m` rows that match the query of **Transaction A**. When **Transaction A** runs the query again, it finds that there are `n+m` rows that match the condition. It is like a phantom, so it is called a **phantom read**.
 
@@ -154,7 +154,7 @@ public class EffectWriteSkew {
 }
 ```
 
-SQL log：
+SQL log:
 
 {{< copyable "sql" >}}
 

develop/dev-guide-transaction-troubleshoot.md

@@ -38,7 +38,7 @@ In TiDB pessimistic transaction mode, if two clients execute the following state
 
 After client-B encounters a deadlock error, TiDB automatically rolls back the transaction in client-B. Updating `id=2` in client-A will be executed successfully. You can then run `COMMIT` to finish the transaction.
 
-### Solution 1：avoid deadlocks
+### Solution 1: avoid deadlocks
 
 To get better performance, you can avoid deadlocks at the application level by adjusting the business logic or schema design. In the example above, if client-B also uses the same update order as client-A, that is, they update books with `id=1` first, and then update books with `id=2`. The deadlock can then be avoided:
 

develop/dev-guide-update-data.md

@@ -277,7 +277,7 @@ In each iteration, `SELECT` queries in order of the primary key. It selects prim
 
 In Java (JDBC), a bulk-update application might be similar to the following:
 
-**Code：**
+**Code:**
 
 {{< copyable "" >}}
 

develop/dev-guide-use-common-table-expression.md

@@ -5,7 +5,7 @@ summary: Learn the CTE feature of TiDB, which help you write SQL statements more
 
 # Common Table Expression
 
-In some transaction scenarios, due to application complexity, you might need to write a single SQL statement of up to 2,000 lines. The statement probably contains a lot of aggregations and multi-level subquery nesting. Maintaining such a long SQL statement can be a developer’s nightmare.
+In some transaction scenarios, due to application complexity, you might need to write a single SQL statement of up to 2,000 lines. The statement probably contains a lot of aggregations and multi-level subquery nesting. Maintaining such a long SQL statement can be a developer's nightmare.
 
 To avoid such a long SQL statement, you can simplify queries by using [Views](/develop/dev-guide-use-views.md) or cache intermediate query results by using [Temporary tables](/develop/dev-guide-use-temporary-tables.md).
 
@@ -183,7 +183,7 @@ WITH RECURSIVE <query_name> AS (
 SELECT ... FROM <query_name>;
 ```
 
-A classic example is to generate a set of [Fibonacci numbers](https://en.wikipedia.org/wiki/Fibonacci_number) with recursive CTE：
+A classic example is to generate a set of [Fibonacci numbers](https://en.wikipedia.org/wiki/Fibonacci_number) with recursive CTE:
 
 {{< copyable "sql" >}}
 

dm/dm-export-import-config.md

@@ -40,7 +40,7 @@ config export [--dir directory]
 
 ### Parameter explanation
 
-- `dir`：
+- `dir`:
     - optional
     - specifies the file path for exporting
     - the default value is `./configs`
@@ -73,7 +73,7 @@ config import [--dir directory]
 
 ### Parameter explanation
 
-- `dir`：
+- `dir`:
     - optional
     - specifies the file path for importing
     - the default value is `./configs`

dm/dm-faq.md

@@ -129,11 +129,11 @@ Since DM v2.0, if you directly run the `start-task` command with the task config
 
 This error can be handled by [manually importing DM migration tasks of a DM 1.0 cluster to a DM 2.0 cluster](/dm/manually-upgrade-dm-1.0-to-2.0.md).
 
-## Why does TiUP fail to deploy some versions of DM (for example, v2.0.0-hotfix)？
+## Why does TiUP fail to deploy some versions of DM (for example, v2.0.0-hotfix)?
 
 You can use the `tiup list dm-master` command to view the DM versions that TiUP supports to deploy. TiUP does not manage DM versions which are not shown by this command.
 
-## How to handle the error `parse mydumper metadata error: EOF` that occurs when DM is replicating data？
+## How to handle the error `parse mydumper metadata error: EOF` that occurs when DM is replicating data?
 
 You need to check the error message and log files to further analyze this error. The cause might be that the dump unit does not produce the correct metadata file due to a lack of permissions.
 

dm/dm-open-api.md

@@ -15,7 +15,7 @@ To enable OpenAPI, perform one of the following operations:
     openapi = true
     ```
 
-+ If your DM cluster has been deployed using TiUP, add the following configuration to the topology file：
++ If your DM cluster has been deployed using TiUP, add the following configuration to the topology file:
 
     ```yaml
     server_configs:

dm/dm-tune-configuration.md

@@ -25,7 +25,7 @@ During full backup, DM splits the data of each table into multiple chunks accord
 >
 > - You cannot update the value of `mydumpers` after the migration task is created. Be sure about the value of each option before creating the task. If you need to update the value, stop the task using dmctl, update the configuration file, and re-create the task.
 > - `mydumpers`.`threads` can be replaced with the `mydumper-thread` configuration item for simplicity.
-> - If `rows` is set，DM ignores the value of `chunk-filesize`.
+> - If `rows` is set, DM ignores the value of `chunk-filesize`.
 
 ## Full data import