Skip to content

Commit

Permalink
Apply suggestions from code review
Browse files Browse the repository at this point in the history
Co-Authored-By: Lilian Lee <lilin@pingcap.com>
  • Loading branch information
dcalvin and lilin90 authored May 22, 2019
1 parent c9c59c1 commit 30c6586
Show file tree
Hide file tree
Showing 8 changed files with 15 additions and 15 deletions.
8 changes: 4 additions & 4 deletions TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,8 +157,8 @@
- [使用限制](dev/reference/tools/data-migration/features/shard-merge.md#使用限制)
- [手动处理 Sharding DDL Lock](dev/reference/tools/data-migration/features/manually-handling-sharding-ddl-locks.md)
+ 使用场景
- [简单的从库同步场景](dev/reference/tools/data-migration/usage-scenarios/simple-synchronization-scenario.md)
- [分库分表合并场景](dev/reference/tools/data-migration/usage-scenarios/shard-merge-scenario.md)
- [简单的从库同步场景](dev/reference/tools/data-migration/usage-scenarios/simple-synchronization.md)
- [分库分表合并场景](dev/reference/tools/data-migration/usage-scenarios/shard-merge.md)
+ [部署使用](dev/reference/tools/data-migration/practice.md)
+ 配置
- [概述](dev/reference/tools/data-migration/configure/overview.md)
Expand All @@ -172,7 +172,7 @@
- [概述](dev/reference/tools/tidb-lightning/overview.md)
- [部署执行](dev/reference/tools/tidb-lightning/deployment.md)
- [断点续传](dev/reference/tools/tidb-lightning/checkpoints.md)
- [表库过滤](dev/reference/tools/tidb-lightning/table-filter.md)
- [表库过滤](dev/reference/tools/tidb-lightning/filter.md)
- [CSV 支持](dev/reference/tools/tidb-lightning/csv.md)
- [监控告警](dev/reference/tools/tidb-lightning/monitor.md)
+ TiDB-Binlog
Expand All @@ -184,7 +184,7 @@
- [PD Control](dev/reference/tools/pd-control.md)
- [PD Recover](dev/reference/tools/pd-recover.md)
- [TiKV Control](https://github.com/tikv/tikv/blob/master/docs/tools/tikv-control.md)
- [TiDB Controller](dev/reference//tidb-control.md)
- [TiDB Controller](dev/reference/tools/tidb-control.md)
- [工具下载](dev/reference/tools/download.md)
+ 常见问题 (FAQ)
- [TiDB FAQ](FAQ.md)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: DM 任务配置文件介绍
category: reference
aliases: ['/docs-cn/tools/dm/task_configuration-file-intro']
aliases: ['/docs-cn/tools/dm/task-configuration-file-intro/']
---

# DM 任务配置文件介绍
Expand Down
6 changes: 3 additions & 3 deletions dev/reference/tools/data-migration/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,11 +50,11 @@ dmctl 是用来控制 DM 集群的命令行工具。

### Table routing

[Table routing](/dev/reference/tools/data-migration/features/overview#table-routing) 是指将上游 MySQL 或 MariaDB 实例的某些表同步到下游指定表的路由功能,可以用于分库分表的合并同步。
[Table routing](/dev/reference/tools/data-migration/features/overview.md#table-routing) 是指将上游 MySQL 或 MariaDB 实例的某些表同步到下游指定表的路由功能,可以用于分库分表的合并同步。

### Black & white table lists

[Black & white table lists](/dev/reference/tools/data-migration/features/overview.md#black--white-table-lists) 是指上游数据库实例表的黑白名单过滤规则。其过滤规则类似于 MySQL `replication-rules-db`/`replication-rules-table`,可以用来过滤或只同步某些数据库或某些表的所有操作。
[Black & white table lists](/dev/reference/tools/data-migration/features/overview.md#black-white-table-lists) 是指上游数据库实例表的黑白名单过滤规则。其过滤规则类似于 MySQL `replication-rules-db`/`replication-rules-table`,可以用来过滤或只同步某些数据库或某些表的所有操作。

### Binlog event filter

Expand Down Expand Up @@ -99,4 +99,4 @@ DM 支持对原分库分表进行合库合表操作,但需要满足一些[使
+ 操作限制

- DM-worker 重启后不能自动恢复数据同步任务,需要使用 dmctl 手动执行 `start-task`。详见[管理数据同步任务](/dev/reference/tools/data-migration/manage-task.md)
- 在一些情况下,DM-worker 重启后不能自动恢复 DDL lock 同步,需要手动处理。详见[手动处理 Sharding DDL Lock](/dev/reference/tools/data-migration/features/manually-handling-sharding-ddl-locks.md)
- 在一些情况下,DM-worker 重启后不能自动恢复 DDL lock 同步,需要手动处理。详见[手动处理 Sharding DDL Lock](/dev/reference/tools/data-migration/features/manually-handling-sharding-ddl-locks.md)
2 changes: 1 addition & 1 deletion dev/reference/tools/data-migration/practice.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ aliases: ['/docs-cn/tools/dm/practice/']

> **注意:**
>
> - 在 DM 所有的配置文件中,数据库的密码要使用 dmctl 加密后的密文。如果数据库密码为空,则不需要加密。关于如何使用 dmctl 加密明文密码,参考[使用 dmctl 加密上游 MySQL 用户密码](/dev/how-to/deploy/data-migration-with-ansible/#使用-dmctl-加密上游-mysql-用户密码)
> - 在 DM 所有的配置文件中,数据库的密码要使用 dmctl 加密后的密文。如果数据库密码为空,则不需要加密。关于如何使用 dmctl 加密明文密码,参考[使用 dmctl 加密上游 MySQL 用户密码](/dev/how-to/deploy/data-migration-with-ansible.md#使用-dmctl-加密上游-mysql-用户密码)
> - 上下游数据库用户必须拥有相应的读写权限。
## 第 2 步:检查集群信息
Expand Down
4 changes: 2 additions & 2 deletions dev/reference/tools/data-migration/skip-replace-sqls.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ aliases: ['/docs-cn/tools/dm/skip-replace-sqls/']

本文介绍了如何使用 DM 来处理异常的 SQL 语句。

目前,TiDB 并不完全兼容所有的 MySQL 语法(详见 [TiDB 已支持的 DDL 语句](/dev/reference/sql/ddl.md))。当使用 DM 从 MySQL 同步数据到 TiDB 时,如果 TiDB 不支持对应的 SQL 语句,可能会造成错误并中断同步任务。在这种情况下,DM 提供以下两种方式来恢复同步:
目前,TiDB 并不完全兼容所有的 MySQL 语法(详见 [TiDB 已支持的 DDL 语句](/dev/reference/sql/statements/ddl.md))。当使用 DM 从 MySQL 同步数据到 TiDB 时,如果 TiDB 不支持对应的 SQL 语句,可能会造成错误并中断同步任务。在这种情况下,DM 提供以下两种方式来恢复同步:

- 使用 dmctl 来手动跳过该 SQL 语句对应的 binlog event。

Expand All @@ -20,7 +20,7 @@ aliases: ['/docs-cn/tools/dm/skip-replace-sqls/']

- 跳过/替代执行操作只适合用于一次性跳过/替代执行**下游 TiDB 不支持执行的 SQL 语句**,其它同步错误请不要使用此方式进行处理。

- 其它同步错误可尝试使用 [black & white table lists](/dev/reference/tools/data-migration/features/overview.md#black--white-table-lists)[binlog event filter](/dev/reference/tools/data-migration/features/overview.md#binlog-event-filter)
- 其它同步错误可尝试使用 [black & white table lists](/dev/reference/tools/data-migration/features/overview.md#black-white-table-lists)[binlog event filter](/dev/reference/tools/data-migration/features/overview.md#binlog-event-filter)

- 如果业务不能接受下游 TiDB 跳过异常的 DDL 语句,也不接受使用其他 DDL 语句作为替代,则不适合使用此方式进行处理。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,7 @@ aliases: ['/docs-cn/tools/dm/shard-merge-scenario/']
action: Ignore
```

- 要满足同步需求 #7,配置 [Black & white table lists](/dev/reference/tools/data-migration/features/overview.md#black--white-table-lists) 如下:
- 要满足同步需求 #7,配置 [Black & white table lists](/dev/reference/tools/data-migration/features/overview.md#black-white-table-lists) 如下:

```yaml
black-white-list:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ aliases: ['/docs-cn/tools/dm/simple-synchronization-scenario/']
>
> `store-filter-rule` 不同于 `log-filter-rule` 和 `user-filter-rule`。`store-filter-rule` 是针对整个 `store` 库的规则,而 `log-filter-rule` 和 `user-filter-rule` 是针对 `user` 库中 `log` 表的规则。

- 为了满足[同步要求](#同步要求)中的第三点要求,需要配置以下 [black & white table lists 规则](/dev/reference/tools/data-migration/features/overview.md#black--white-table-lists):
- 为了满足[同步要求](#同步要求)中的第三点要求,需要配置以下 [black & white table lists 规则](/dev/reference/tools/data-migration/features/overview.md#black-white-table-lists):

```yaml
black-white-list:
Expand All @@ -143,7 +143,7 @@ aliases: ['/docs-cn/tools/dm/simple-synchronization-scenario/']

## 同步任务配置

以下是完整的同步任务配置,详见[配置介绍](/dev/reference/tools/data-migration/task-configuration-file-intro.md)。
以下是完整的同步任务配置,详见[配置介绍](/dev/reference/tools/data-migration/configure/task-configuration-file.md)。

```yaml
name: "one-tidb-slave"
Expand Down
2 changes: 1 addition & 1 deletion dev/reference/tools/tidb-binlog/deploy.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: TiDB-Binlog 集群部署
category: reference
aliases: ['/docs-cn/tools/binlog/deploy']
aliases: ['/docs-cn/tools/binlog/deploy/']
---

# TiDB-Binlog 集群部署
Expand Down

0 comments on commit 30c6586

Please sign in to comment.