*: refine data migration document#2244
Conversation
|
LGTM |
| - [监控 TiDB 集群](/dev/how-to/monitor/monitor-a-cluster.md) | ||
| + 迁移 | ||
| - [概述](/dev/how-to/migrate/overview.md) | ||
| - [工具使用指南](/dev/reference/tools/use-guide.md) |
There was a problem hiding this comment.
1、这个链接应该指向迁移方案那一部分,而不是所有工具的指南
2、原来的[概述]被删掉了,里面有一些好的地方。比如,新加的这个指南里,“什么场景使用什么样的迁移方式”感觉可以再清晰一些(简写了建议的思路):
a、MySQL 1T 以上:mydumper+lightning 全量,dm 做增量(这个文档貌似没有)
b、MySQL 1T 以下:dm 全量+增量(已经有了)
c、非 MySQL,如 CSV
There was a problem hiding this comment.
这个指南里面也涉及 “什么场景使用什么样的迁移方式”,而且更加合理和全面。其实 1T 这个算是拍脑袋的数据。 此外合并两个文档的原因是,不想维护两份,另外这个指南其实都是迁移相关,可能名字不够直接
| category: how-to | ||
| --- | ||
|
|
||
| # 从 Amazon Aurora MySQL 迁移数据 |
There was a problem hiding this comment.
| # 从 Amazon Aurora MySQL 迁移数据 | |
| # 从 MySQL/Amazon Aurora MySQL 迁移数据 |
|
还需在各版本
|
| @@ -1,6 +1,7 @@ | |||
| --- | |||
There was a problem hiding this comment.
- 这个文件取代了原迁移概述,内容性质一样,也很重要,属于直接使用类,而非辅助参考类,不建议放在 reference 下,建议采用原来的目录即可:
dev/how-to/migrate/overview.md。因为这篇文档是总括性质的,个人认为可以用overview.md。 数据迁移解决方案提到工具演进路线前面?演进路线更像一个参考类内容,个人认为解决方案内容的优先级高于演讲路线。
@kissmydb 怎么看?
There was a problem hiding this comment.
- 原来的概述不是“直接使用类”的,是介绍可以用什么工具来进行全量备份和恢复,是 “指引类” 的,
use-guide.md也是指引类的。 - 这个 link 直接跳转到
tidb-集群数据的全量备份及恢复
另外用户反馈 use-guide.md 这个 page 可以让他们获得他们想要的所有信息,所以我们集中只维护一个 “指引类” 的页面
There was a problem hiding this comment.
@GregoryIan
- 这里概述的功能是指引用户如何根据自己的场景选择工具,是直接使用前必要的一步;而参考类文档通常带有辅助性质。所以,放在前面的目录里更能凸显重要性。
- 在 how-to 的迁移章节只放一个链接的话,PDF 用户无法在前面得到想要的信息。建议将该文档放在 how-to 里,下面的 reference 工具下放链接。
There was a problem hiding this comment.
我们不是都是靠 TOC 来索引的吗? 所以具体内容放在哪里其实没有关系。为什么放在 reference/tools 下面是因为,有人反馈过,他们习惯性去 reference/tools 下面找 tools 的所有文档,反而不会去 how-to
What is changed, added or deleted?
refine document releated data migration
syncer/loader,migrate/from-mysql.mdandincrementally-from-mysql.md迁移概述by工具使用指南工具使用指南 3.0What is the related PR or file link(s)?
Which TiDB version(s) does your changes apply to?
Note: If your changes apply to multiple TiDB versions, make sure you update the documents in the corresponding version folders such as "dev", "v3.0", "v2.1" and "v3.1" in this PR.