Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .vaunt/add-tidb-docs-dash-badge.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 如何在你的 GitHub 个人资料页上添加 TiDB 文档挑战赛徽章
# 如何在你的 GitHub 个人资料页上添加测试数据库文档挑战赛徽章

[GitHub 个人资料页](https://docs.github.com/zh/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-profile)不仅仅是你的 GitHub 仓库的集合,更是你在编程领域中的专业身份标志。

Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# TiDB 中文文档贡献指南
# 测试数据库中文文档贡献指南

无论你是热爱技术的程序员,还是擅长书面表达的语言爱好者,亦或是纯粹想帮 TiDB 改进文档的热心小伙伴,都欢迎来为 TiDB 文档做贡献,一起打造更加易用友好的 TiDB 文档!

## 我能为 TiDB 文档做什么贡献
## 我能为测试数据库文档做什么贡献

你可以在提升 TiDB 文档质量、易用性、维护效率、翻译效率等方面做贡献,比如:

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# TiDB 文档
# 测试数据库文档

欢迎来到 [TiDB](https://github.com/pingcap/tidb) 文档仓库!

Expand All @@ -8,7 +8,7 @@

如果你想在本地定制输出符合特定场景需求的 PDF 格式的 TiDB 文档,例如对 TiDB 文档目录进行自由排序和删减,请参考[自助生成 TiDB 文档 PDF 教程](/resources/tidb-pdf-generation-tutorial.md)。

## TiDB 文档维护方式及版本说明
## 测试数据库文档维护方式及版本说明

目前,TiDB 的文档维护在以下 branch,对应着官网文档的不同版本:

Expand Down
4 changes: 2 additions & 2 deletions accelerated-table-creation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@ title: 提升 TiDB 建表性能
summary: 介绍 TiDB 加速建表中的概念、原理、实现和影响。
---

# 提升 TiDB 建表性能
# 提升测试数据库建表性能

TiDB v7.6.0 引入了系统变量 [`tidb_ddl_version`](https://docs.pingcap.com/zh/tidb/v7.6/system-variables#tidb_ddl_version-从-v760-版本开始引入) 实现支持加速建表,可提升大批量建表的速度。从 v8.0.0 开始,该系统变量更名为 [`tidb_enable_fast_create_table`](/system-variables.md#tidb_enable_fast_create_table-从-v800-版本开始引入)。

通过 [`tidb_enable_fast_create_table`](/system-variables.md#tidb_enable_fast_create_table-从-v800-版本开始引入) 系统变量开启加速建表后,同时提交到同一个 TiDB 节点的相同 schema 的建表语句会被合并为批量建表语句,以提高建表性能。因此为了提高建表性能,需要尽量连接相同的 TiDB 节点并发创建同一个 schema 下的表,并适当提高并发度。

合并后的批量建表语句在同一个事务内执行,如果其中一个语句失败,所有语句都会失败。

## 与 TiDB 工具的兼容性
## 与测试数据库工具的兼容性

- 在 TiDB v8.3.0 之前的版本中,[TiCDC](/ticdc/ticdc-overview.md) 不支持同步通过 TiDB 加速创建的表。从 v8.3.0 开始,TiCDC 可以正常同步这类表。

Expand Down
4 changes: 2 additions & 2 deletions alert-rules.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: TiDB 集群报警规则
summary: TiDB 集群中各组件的报警规则详解。
---

# TiDB 集群报警规则
# 测试数据库集群报警规则

本文介绍了 TiDB 集群中各组件的报警规则,包括 TiDB、TiKV、PD、TiFlash、TiCDC、Node_exporter 和 Blackbox_exporter 的各报警项的规则描述及处理方法。

Expand All @@ -15,7 +15,7 @@ summary: TiDB 集群中各组件的报警规则详解。
| 严重级别 | 服务可用性下降,需要用户密切关注异常指标 |
| 警告级别 | 对某一问题或错误的提醒 |

## TiDB 报警规则
## 测试数据库报警规则

本节介绍了 TiDB 组件的报警项。

Expand Down
2 changes: 1 addition & 1 deletion analyze-slow-queries.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ mysql> explain analyze select count(*) from t where a=(select max(t1.a) from t t

可以看到有 1 个子查询被提前执行,花费了 `7.76s`。

### TiDB 执行慢
### 测试数据库执行慢

这里我们假设 TiDB 的执行计划正确(不正确的情况在[分析优化器问题](#分析优化器问题)这一节中说明),但是执行上很慢;

Expand Down
2 changes: 1 addition & 1 deletion auto-increment.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ summary: 介绍 TiDB 的 `AUTO_INCREMENT` 列属性。

> **注意:**
>
> 使用 `AUTO_INCREMENT` 可能会给生产环境带热点问题,因此推荐使用 [`AUTO_RANDOM`](/auto-random.md) 代替。详情请参考 [TiDB 热点问题处理](/troubleshoot-hot-spot-issues.md#tidb-热点问题处理)。
> 使用 `AUTO_INCREMENT` 可能会给生产环境带热点问题,因此推荐使用 [`AUTO_RANDOM`](/auto-random.md) 代替。详情请参考 [测试数据库热点问题处理](/troubleshoot-hot-spot-issues.md#测试数据库热点问题处理)。

在 [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md) 语句中也可以使用 `AUTO_INCREMENT` 参数来指定自增字段的初始值。

Expand Down
2 changes: 1 addition & 1 deletion auto-random.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ CREATE TABLE t (a BIGINT AUTO_RANDOM(5, 54), b VARCHAR(255), PRIMARY KEY (a));
CREATE TABLE t (a BIGINT AUTO_RANDOM(5, 54), b VARCHAR(255), PRIMARY KEY (a, b));
```

`AUTO_RANDOM` 关键字可以被包裹在 TiDB 可执行注释中,注释语法请参考 [TiDB 可执行注释](/comment-syntax.md#tidb-可执行的注释语法)。
`AUTO_RANDOM` 关键字可以被包裹在 TiDB 可执行注释中,注释语法请参考 [测试数据库可执行注释](/comment-syntax.md#测试数据库可执行的注释语法)。

```sql
CREATE TABLE t (a bigint /*T![auto_rand] AUTO_RANDOM */, b VARCHAR(255), PRIMARY KEY (a));
Expand Down
2 changes: 1 addition & 1 deletion basic-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: TiDB 功能概览
summary: 了解 TiDB 的功能概览。
---

# TiDB 功能概览
# 测试数据库功能概览

本文列出了 TiDB 功能在不同版本中的支持变化情况,包括[长期支持版本 (LTS)](/releases/versioning.md#长期支持版本) 和最新的 LTS 版本之后的[开发里程碑版本 (DMR)](/releases/versioning.md#开发里程碑版本)。

Expand Down
2 changes: 1 addition & 1 deletion benchmark/benchmark-sysbench-v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ IDC 机器

## 测试方案

### TiDB 版本信息
### 测试数据库版本信息

### v1.0.8

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v3.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Sysbench 版本:1.1.0

使用 Sysbench 向集群导入 **16 张表,每张数据 1000 万**。通过 HAProxy 代理,分别以递增并发数向集群发送请求,单次并发测试时间 5 分钟。

### TiDB 版本信息
### 测试数据库版本信息

### v2.1.0-rc.2

Expand All @@ -52,7 +52,7 @@ Sysbench 版本:1.1.0
| TiKV | 57c83dc4ebc93d38d77dc8f7d66db224760766cc |
| PD | b64716707b7279a4ae822be767085ff17b5f3fea |

### TiDB 参数配置
### 测试数据库参数配置

两版本 TiDB 均使用**默认配置**。

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v5.1.0-vs-v5.0.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v5.1.0 在 OLTP 场景下的 Sysbench 性能表现对比 v5.0.2。

两个版本使用相同的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand Down Expand Up @@ -63,7 +63,7 @@ pessimistic-txn.pipelined: true
server.enable-request-batch: false
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v5.2.0-vs-v5.1.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v5.2.0 在 OLTP 场景下的 Sysbench 性能对比测试显示,P

两个版本使用相同的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand Down Expand Up @@ -63,7 +63,7 @@ pessimistic-txn.pipelined: true
server.enable-request-batch: false
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v5.3.0-vs-v5.2.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v5.3.0 和 v5.2.2 在 OLTP 场景下的 Sysbench 性能对比测

两个版本使用相同的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand Down Expand Up @@ -62,7 +62,7 @@ readpool.storage.normal-concurrency: 10
pessimistic-txn.pipelined: true
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v5.4.0-vs-v5.3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v5.4.0 在 OLTP 场景下的 Sysbench 性能比 v5.3.0 有所提

两个版本使用相同的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand Down Expand Up @@ -62,7 +62,7 @@ readpool.storage.normal-concurrency: 10
pessimistic-txn.pipelined: true
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v6.0.0-vs-v5.4.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v6.0.0 在 OLTP 场景下的 Sysbench 性能表现对比 v5.4.0。

两个版本使用相同的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand All @@ -59,7 +59,7 @@ readpool.storage.normal-concurrency: 10
pessimistic-txn.pipelined: true
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v6.1.0-vs-v6.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v6.1.0 在 OLTP 场景下的 Sysbench 性能表现优于 v6.0.0。

两个版本使用相同的配置。

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand All @@ -56,7 +56,7 @@ server.grpc-concurrency: 6
readpool.storage.normal-concurrency: 10
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-sysbench-v6.2.0-vs-v6.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v6.2.0 和 v6.1.0 在 OLTP 场景下的 Sysbench 性能对比测

两个版本使用相同的配置。

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand All @@ -56,7 +56,7 @@ server.grpc-concurrency: 6
readpool.unified.max-thread-count: 10
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
2 changes: 1 addition & 1 deletion benchmark/benchmark-tidb-using-ch.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: 如何对 TiDB 进行 CH-benCHmark 测试
summary: 本文介绍如何对 TiDB 进行 CH-benCHmark 测试。
---

# 如何对 TiDB 进行 CH-benCHmark 测试
# 如何对测试数据库进行 CH-benCHmark 测试

本文介绍如何对 TiDB 进行 CH-benCHmark 测试。

Expand Down
4 changes: 2 additions & 2 deletions benchmark/benchmark-tidb-using-sysbench.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ summary: 使用 Sysbench 1.0 或更新版本测试 TiDB 性能。调整 TiDB 和

## 测试方案

### TiDB 配置
### 测试数据库配置

升高日志级别,可以减少打印日志数量,对 TiDB 的性能有积极影响。具体在 TiUP 配置文件中加入:

Expand Down Expand Up @@ -182,7 +182,7 @@ TiKV 的其他模块,如 storage readpool、coprocessor 和 gRPC 的最大并

通过 Grafana 的 TiKV Thread CPU 监控面板可以观察到其实际使用率。如出现多线程模块瓶颈,可以通过增加该模块并发度进行调整。

### 在高并发压力下,TiKV 也未达到 CPU 使用瓶颈,为什么 TiDB 的 CPU 利用率依然很低?
### 在高并发压力下,TiKV 也未达到 CPU 使用瓶颈,为什么测试数据库的 CPU 利用率依然很低?

在某些高端设备上,使用的是 NUMA 架构的 CPU,跨 CPU 访问远端内存将极大降低性能。TiDB 默认将使用服务器所有 CPU,goroutine 的调度不可避免地会出现跨 CPU 内存访问。

Expand Down
2 changes: 1 addition & 1 deletion benchmark/benchmark-tidb-using-tpcc.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: 如何对 TiDB 进行 TPC-C 测试
summary: 本文介绍了如何对 TiDB 进行 TPC-C 测试。TPC-C 是一个对 OLTP 系统进行测试的规范,使用商品销售模型对系统进行测试,包含五类事务:NewOrder、Payment、OrderStatus、Delivery、StockLevel。测试使用 tpmC 值衡量系统最大有效吞吐量,以 NewOrder Transaction 为准。使用 go-tpc 进行测试实现,通过 TiUP 命令下载测试程序。测试包括数据导入、运行测试和清理测试数据。
---

# 如何对 TiDB 进行 TPC-C 测试
# 如何对测试数据库进行 TPC-C 测试

本文介绍如何对 TiDB 进行 [TPC-C](http://www.tpc.org/tpcc/) 测试。

Expand Down
2 changes: 1 addition & 1 deletion benchmark/benchmark-tpch.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ summary: TiDB TPC-H 50G 性能测试报告显示,TiDB 2.0 在大部分查询
| 172.16.31.10 | PD \* 1 |
| 172.16.31.4 | TiDB \* 1 |

### TiDB 版本信息
### 测试数据库版本信息

TiDB 1.0:

Expand Down
2 changes: 1 addition & 1 deletion benchmark/online-workloads-and-add-index-operations.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ TiDB 版本:v3.0.1

Sysbench 版本:1.0.17

### TiDB 参数配置
### 测试数据库参数配置

TiDB、TiKV 和 PD 均使用 [TiDB Operator](https://github.com/pingcap/tidb-operator) 默认配置。

Expand Down
4 changes: 2 additions & 2 deletions benchmark/v3.0-performance-benchmarking-with-sysbench.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ sysbench $testname \
run --tables=16 --table-size=10000000
```

### TiDB 版本信息
### 测试数据库版本信息

### v3.0.0

Expand All @@ -88,7 +88,7 @@ sysbench $testname \
| TiKV | `b3cf3c8d642534ea6fa93d475a46da285cc6acbf` |
| PD | `886362ebfb26ef0834935afc57bcee8a39c88e54` |

### TiDB 参数配置
### 测试数据库参数配置

2.1 和 3.0 中开启 prepared plan cache(出于优化考虑,2.1 的 point select 与 read write 并未开启):

Expand Down
4 changes: 2 additions & 2 deletions benchmark/v3.0-performance-benchmarking-with-tpcc.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ git clone -b 5.0-mysql-support-opt https://github.com/pingcap/benchmarksql.git

使用 BenchmarkSQL 向集群导入 **1000 warehouse** 的数据。通过 HAProxy 代理,分别以递增并发数向集群发送请求,单次并发测试时间 10 分钟。

### TiDB 版本信息
### 测试数据库版本信息

### v3.0.0

Expand All @@ -58,7 +58,7 @@ git clone -b 5.0-mysql-support-opt https://github.com/pingcap/benchmarksql.git
| TiKV | b3cf3c8d642534ea6fa93d475a46da285cc6acbf |
| PD | 886362ebfb26ef0834935afc57bcee8a39c88e54 |

### TiDB 参数配置
### 测试数据库参数配置

```toml
[log]
Expand Down
4 changes: 2 additions & 2 deletions benchmark/v5.1-performance-benchmarking-with-tpcc.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v5.1.0 在 TPC-C 性能上提升了 2.8%,测试环境为 AWS EC2

两个版本使用同样的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand Down Expand Up @@ -65,7 +65,7 @@ storage.scheduler-worker-pool-size: 20
server.enable-request-batch: false
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
4 changes: 2 additions & 2 deletions benchmark/v5.2-performance-benchmarking-with-tpcc.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ summary: TiDB v5.2.0 在 TPC-C 性能上下降了 4.22%,测试环境为 AWS EC

两个版本使用同样的配置

#### TiDB 参数配置
#### 测试数据库参数配置

{{< copyable "" >}}

Expand Down Expand Up @@ -65,7 +65,7 @@ storage.scheduler-worker-pool-size: 20
server.enable-request-batch: false
```

#### TiDB 全局变量配置
#### 测试数据库全局变量配置

{{< copyable "sql" >}}

Expand Down
Loading
Loading