*: refine placement #8706

xhebox · 2022-03-18T08:06:24Z

Signed-off-by: xhe xw897002528@gmail.com

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)

Address remove direct placement #8230 (comment), rename PLACEMENT_RULES table.
Address remove direct placement #8230 (comment), restructure syntax tree
Remove VOTERS as the implementation
Refines on the introduction page, changes are marked out

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

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions (in Chinese).

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

This PR is translated from: *: refine placement documents docs#7885
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

ti-chi-bot · 2022-03-18T08:06:25Z

[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.

placement-rules-in-sql.md

information-schema/information-schema-placement-policies.md

placement-rules-in-sql.md

information-schema/information-schema-placement-policies.md

placement-rules-in-sql.md

TomShawn · 2022-03-21T03:19:52Z

information-schema/information-schema-placement-rules.md

-
-# PLACEMENT_RULES
-
-`PLACEMENT_RULES` 表展示所有已显式配置的 [Placement Rules in SQL](/placement-rules-in-sql.md) 信息，即所有放置策略 (placement policy) 的信息。


在 v6.0 中这张系统表被 PLACEMENT_POLICIES 替代了吗？所以打破了自身兼容性了吧？

TomShawn · 2022-03-21T03:23:06Z

/rebase

Signed-off-by: xhe <xw897002528@gmail.com>

Co-authored-by: 王超 <cclcwangchao@hotmail.com>

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

Signed-off-by: xhe <xw897002528@gmail.com>

TomShawn · 2022-03-22T07:55:46Z

system-variables.md

@@ -1290,6 +1283,14 @@ explain select * from t where age=5;
 - 默认值：`ON`
 - 这个变量用于控制是否开启 [ANALYZE 配置持久化](/statistics.md#analyze-配置持久化)特性。

+### `tidb_placement_mode` <span class="version-mark">从 v6.0.0 版本开始引入</span>


前端支持原因，暂时用不了了

Suggested change

### `tidb_placement_mode` <span class="version-mark">从 v6.0.0 版本开始引入</span>

### `tidb_placement_mode`（从 v6.0.0 版本开始引入）

@TomShawn 英文要改嘛

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

Signed-off-by: xhe <xw897002528@gmail.com>

br/backup-and-restore-tool.md

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

placement-rules-in-sql.md

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

br/backup-and-restore-tool.md

placement-rules-in-sql.md

Co-authored-by: 王超 <cclcwangchao@hotmail.com>

Signed-off-by: xhe <xw897002528@gmail.com>

TomShawn

LGTM

information-schema/information-schema.md

placement-rules-in-sql.md

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

Signed-off-by: xhe <xw897002528@gmail.com>

TomShawn · 2022-03-23T08:11:17Z

/remove-status LGT1
/status LGT2

TomShawn · 2022-03-23T08:11:23Z

/merge

ti-chi-bot · 2022-03-23T08:11:26Z

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

Commit hash: 56fe1a8

aytrack · 2022-04-01T04:04:37Z

placement-rules-in-sql.md

@@ -98,8 +130,11 @@ SELECT * FROM information_schema.partitions WHERE tidb_placement_policy_name IS

 | 选项名                | 描述                                                                                    |
 |----------------------------|------------------------------------------------------------------------------------------------|
-| `CONSTRAINTS`              |  适用于所有角色 (role) 的约束列表。例如，`CONSTRAINTS="[+disk=ssd]`。      |
-| `FOLLOWER_CONSTRAINTS`     |  仅适用于 follower 的约束列表。                                           |
+| `CONSTRAINTS`              | 适用于所有角色 (role) 的约束列表。例如，`CONSTRAINTS="[+disk=ssd]`。      |


这个 ] 后面少了 "?

aytrack · 2022-04-01T04:05:54Z

placement-rules-in-sql.md

+
+| 工具名称 | 最低兼容版本 | 说明 |
+| --- | --- | --- |
+| Backup & Restore (BR) | 6.0 | 支持放置规则的导入与导出，见 [BR 兼容性](/br/backup-and-restore-tool.md#兼容性] |


br 兼容性链接后面缺 )

ti-chi-bot requested a review from TomShawn March 18, 2022 08:06

xhebox requested review from lcwangchao and removed request for TomShawn March 18, 2022 08:06

ti-chi-bot added the missing-translation-status This PR does not have translation status info. label Mar 18, 2022

xhebox requested a review from TomShawn March 18, 2022 08:06

ti-chi-bot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Mar 18, 2022