Add Lock View related documents #6408

MyonKeminta · 2021-06-04T10:18:29Z

First-time contributors' checklist

I've signed Contributor License Agreement that's required for repo owners to accept my contribution.

What is changed, added or deleted? (Required)

Added document about the feature Lock View
- The three new tables in infomation_schema
- The configuration
- The change to the lock conflict troubleshooting document.

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

This PR is translated from:
Other reference link(s):

Do your changes match any of the following descriptions?

Delete files
Change aliases
Need modification after applied to another branch
Might cause conflicts after applied to another branch

MyonKeminta · 2021-06-04T10:28:41Z

information-schema/information-schema.md

 | [`CLUSTER_HARDWARE`](/information-schema/information-schema-cluster-info.md)            | 提供在每个 TiDB 组件上发现的底层物理硬件的详细信息。           |
 | [`CLUSTER_INFO`](/information-schema/information-schema-cluster-info.md)                | 提供当前集群拓扑的详细信息。                                   |
 | [`CLUSTER_LOAD`](/information-schema/information-schema-cluster-load.md)                | 提供集群中 TiDB 服务器的当前负载信息。                         |
 | [`CLUSTER_LOG`](/information-schema/information-schema-cluster-log.md)                  | 提供整个 TiDB 集群的日志。                                     |
 | `CLUSTER_PROCESSLIST`                                                                   | 提供 `PROCESSLIST` 表的集群级别的视图。                        |
 | `CLUSTER_SLOW_QUERY`                                                                    | 提供 `SLOW_QUERY` 表的集群级别的视图。                         |
 | `CLUSTER_STATEMENTS_SUMMARY`                                                            | 提供 `STATEMENTS_SUMMARY` 表的集群级别的视图。                 |
-| `CLUSTER_STATEMENTS_SUMMARY_HISTORY`                                                    | 提供 `CLUSTER_STATEMENTS_SUMMARY_HISTORY` 表的集群级别的视图。 |


I think this is a mistake so I changed it 🤔

ti-chi-bot · 2021-06-05T05:20:05Z

@longfangsong: Thanks for your review. The bot only counts approvals from reviewers and higher roles in list, but you're still welcome to leave your comments.

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the ti-community-infra/tichi repository.

TomShawn · 2021-06-07T02:08:59Z

@youjiali1995 PTAL. Thanks!

youjiali1995

需不需要介绍一下这几张表能做什么、解决什么问题之类的？有些问题还需要这几张表一起用才能解决。

information-schema/information-schema-data-lock-waits.md

information-schema/information-schema-deadlocks.md

youjiali1995 · 2021-06-07T06:44:49Z

information-schema/information-schema-data-lock-waits.md

+
+`DATA_LOCK_WAITS` 表的各列的含义如下：
+
+* `KEY`：正在发生等锁的 KEY，以十六进制编码的形式显示。


tidb 现在有办法能解析这种 key 是哪个表哪一行或者索引吗？没有的话下个 sprint 要优化一下体验，可能用户知道了 sql 也没用，还要知道是哪一行才行。

这个后续迭代可以考虑再加个字段展示把 key 解出来的信息。目前可能得借助些其它的工具才能解。我等会看下 tidb-ctl 顶用不顶用，能用的话晚点我把它补充进文档里。

tidb-ctl 好像不行...

见 pingcap/docs#5798 (comment)

MyonKeminta · 2021-06-07T11:48:03Z

I'll continue adding contents tomorrow

troubleshoot-lock-conflicts.md

Co-authored-by: Lei Zhao <zlwgx1023@gmail.com>

ti-chi-bot · 2021-06-09T09:54:00Z

@youjiali1995: Thanks for your review. The bot only counts approvals from reviewers and higher roles in list, but you're still welcome to leave your comments.

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the ti-community-infra/tichi repository.

information-schema/information-schema-deadlocks.md

TomShawn · 2021-06-11T06:26:10Z

information-schema/information-schema-deadlocks.md

+3. 事务 B 执行第二条语句试图对 `id = 1` 的行上锁，被事务 A 阻塞
+4. 事务 A 试图对 `id = 2` 的行上锁，被 B 阻塞，形成死锁
+
+对于这种情况，由于事务 A 阻塞其它事务的语句也是当前正在执行的语句，因而可以解除当前语句所上的悲观锁（使得事务 B 可以继续运行），并重试当前语句。TiDB 内部使用 key 的 hash 来判断是否属于这种情况。


“这种情况”是指情况二吗？

troubleshoot-lock-conflicts.md

Co-authored-by: TomShawn <41534398+TomShawn@users.noreply.github.com>

tidb-configuration-file.md

information-schema/information-schema-deadlocks.md

TomShawn

LGTM

ti-chi-bot · 2021-06-15T02:58:00Z

[REVIEW NOTIFICATION]

This pull request has been approved by:

TomShawn

To complete the pull request process, please ask the reviewers in the list to review by filling /cc @reviewer in the comment.
After your PR has acquired the required number of LGTMs, you can assign this pull request to the committer in the list by filling /assign @committer in the comment to help you merge this pull request.

The full list of commands accepted by this bot can be found here.

Reviewer can indicate their review by submitting an approval review.
Reviewer can cancel approval by submitting a request changes review.

TomShawn · 2021-06-15T02:58:33Z

/remove-status LGT1
/status LGT2

Co-authored-by: Grace Cai <qqzczy@126.com>

TomShawn · 2021-06-15T03:15:18Z

/merge

ti-chi-bot · 2021-06-15T03:15:20Z

This pull request has been accepted and is ready to merge.

Commit hash: 5560738

TomShawn · 2021-06-18T03:47:48Z

information-schema/information-schema-data-lock-waits.md

+2 rows in set (0.01 sec)                                                                
+```
+
+以上查询结果显示，ID 为 `425405024158875649` 的事务在执行 Digest 为 `"f7530877a35ae65300c42250abd8bc731bbaf0a7cabc05dab843565230611bb22"` 的语句的过程中，试图在 `"7480000000000000355f728000000000000002"` 这个 key 上获取悲观锁，但是该 key 目前被 ID 为 `425405016242126849` 的事务持有。


见 pingcap/docs#5798 (comment)

TomShawn · 2021-06-18T03:49:47Z

information-schema/information-schema-deadlocks.md

+>
+> 目前，`DEADLOCKS` 表暂不支持收集可重试的死锁错误相关的信息。
+
+当事务 A 被另一个事务已经持有的锁阻塞，而事务 B 直接或间接地被当前事务持有的锁阻塞，将会引发一个死锁错误。这里：


见 pingcap/docs#5798 (comment)

TomShawn · 2021-06-22T08:14:41Z

见 pingcap/docs#5798 (comment)

TomShawn · 2021-06-22T08:14:53Z

见 pingcap/docs#5798 (comment)

TomShawn · 2021-07-02T03:54:04Z

All followup comments are addressed in https://github.com/pingcap/docs-cn/pull/6577/files.

MyonKeminta added 2 commits June 4, 2021 17:56

Add document about lock view tables

9f0448e

Add config file document

7716c24

ti-chi-bot requested a review from TomShawn June 4, 2021 10:18

ti-chi-bot added missing-translation-status This PR does not have translation status info. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Jun 4, 2021

MyonKeminta changed the title ~~Add Lock View related document~~ Add Lock View related documents Jun 4, 2021

MyonKeminta mentioned this pull request Jun 4, 2021

Implement Lock View (Sprint 3) pingcap/tidb#24199

Closed

20 tasks

MyonKeminta requested review from youjiali1995 and longfangsong June 4, 2021 10:27

MyonKeminta commented Jun 4, 2021

View reviewed changes

TomShawn self-assigned this Jun 4, 2021

TomShawn added translation/doing This PR’s assignee is translating this PR. v5.1 This PR/issue applies to TiDB v5.1. labels Jun 4, 2021

ti-chi-bot removed the missing-translation-status This PR does not have translation status info. label Jun 4, 2021

longfangsong approved these changes Jun 5, 2021

View reviewed changes

Fix lint

180c44f

youjiali1995 reviewed Jun 7, 2021

View reviewed changes

Address comments

d8865e0

MyonKeminta added 2 commits June 8, 2021 17:13

Add some guide for using lock view

a69a5fe

Try to fix dead link

dcf8a52

ti-chi-bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Jun 8, 2021

youjiali1995 reviewed Jun 9, 2021

View reviewed changes

troubleshoot-lock-conflicts.md Outdated Show resolved Hide resolved

troubleshoot-lock-conflicts.md Outdated Show resolved Hide resolved

troubleshoot-lock-conflicts.md Outdated Show resolved Hide resolved

MyonKeminta and others added 2 commits June 9, 2021 17:43

Apply suggestions from code review

46a1436

Co-authored-by: Lei Zhao <zlwgx1023@gmail.com>

Fix lint

8c8b402

youjiali1995 approved these changes Jun 9, 2021

View reviewed changes

Address comments

c2dc9de

TomShawn reviewed Jun 11, 2021

View reviewed changes

MyonKeminta and others added 2 commits June 11, 2021 18:11

Apply suggestions from code review

1e01ecd

Co-authored-by: TomShawn <41534398+TomShawn@users.noreply.github.com>

fix lint

4891cae

qiancai reviewed Jun 13, 2021

View reviewed changes

tidb-configuration-file.md Outdated Show resolved Hide resolved

TomShawn reviewed Jun 15, 2021

View reviewed changes

information-schema/information-schema-deadlocks.md Outdated Show resolved Hide resolved

Update information-schema/information-schema-deadlocks.md

84a945b

TomShawn approved these changes Jun 15, 2021

View reviewed changes

ti-chi-bot added the status/LGT1 Indicates that a PR has LGTM 1. label Jun 15, 2021

ti-chi-bot added status/LGT2 Indicates that a PR has LGTM 2. and removed status/LGT1 Indicates that a PR has LGTM 1. labels Jun 15, 2021

Update tidb-configuration-file.md

5560738

Co-authored-by: Grace Cai <qqzczy@126.com>

ti-chi-bot added the status/can-merge Indicates a PR has been approved by a committer. label Jun 15, 2021

ti-chi-bot merged commit 56793a8 into pingcap:master Jun 15, 2021

MyonKeminta deleted the m/lock-view branch June 15, 2021 03:59

TomShawn mentioned this pull request Jun 16, 2021

Add Lock View documents pingcap/docs#5798

Merged

11 tasks

TomShawn added translation/done This PR has been translated from English into Chinese and updated to pingcap/docs-cn in a PR. and removed translation/doing This PR’s assignee is translating this PR. labels Jun 16, 2021

TomShawn reviewed Jun 18, 2021

View reviewed changes

TomShawn added the requires-followup This PR requires a follow-up task after being merged. label Jun 18, 2021

ti-chi-bot mentioned this pull request Jun 22, 2021

Add Lock View documents (#5798) pingcap/docs#5822

Merged

11 tasks

TomShawn removed the requires-followup This PR requires a follow-up task after being merged. label Jul 2, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add Lock View related documents #6408

Add Lock View related documents #6408

MyonKeminta commented Jun 4, 2021

MyonKeminta Jun 4, 2021

ti-chi-bot commented Jun 5, 2021

TomShawn commented Jun 7, 2021

youjiali1995 left a comment

youjiali1995 Jun 7, 2021

MyonKeminta Jun 7, 2021

MyonKeminta Jun 7, 2021

TomShawn Jun 18, 2021

MyonKeminta commented Jun 7, 2021

ti-chi-bot commented Jun 9, 2021

TomShawn Jun 11, 2021

MyonKeminta Jun 11, 2021

TomShawn left a comment

ti-chi-bot commented Jun 15, 2021

TomShawn commented Jun 15, 2021

TomShawn commented Jun 15, 2021

ti-chi-bot commented Jun 15, 2021

TomShawn Jun 18, 2021

TomShawn Jun 18, 2021

TomShawn commented Jun 22, 2021

TomShawn commented Jun 22, 2021

TomShawn commented Jul 2, 2021


		`DATA_LOCK_WAITS` 表的各列的含义如下：

		* `KEY`：正在发生等锁的 KEY，以十六进制编码的形式显示。

Add Lock View related documents #6408

Add Lock View related documents #6408

Conversation

MyonKeminta commented Jun 4, 2021

First-time contributors' checklist

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

Choose a reason for hiding this comment

ti-chi-bot commented Jun 5, 2021

TomShawn commented Jun 7, 2021

youjiali1995 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

MyonKeminta commented Jun 7, 2021

ti-chi-bot commented Jun 9, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

TomShawn left a comment

Choose a reason for hiding this comment

ti-chi-bot commented Jun 15, 2021

TomShawn commented Jun 15, 2021

TomShawn commented Jun 15, 2021

ti-chi-bot commented Jun 15, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

TomShawn commented Jun 22, 2021

TomShawn commented Jun 22, 2021

TomShawn commented Jul 2, 2021