Skip to content

Commit 431b781

Browse files
csuzhangxcIANTHEREAL
authored andcommitted
*: refine syncer check list (pingcap#119)
1 parent ce55e9d commit 431b781

File tree

1 file changed

+51
-4
lines changed

1 file changed

+51
-4
lines changed

.github/ISSUE_TEMPLATE/syncer-support.md

+51-4
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,34 @@ about: "Requesting support for syncer Tool"
66

77
## syncer Support
88

9+
Before submitting your issue, please check the requirements list below (all need to be met):
10+
11+
1. Upstream MySQL version (execute `SELECT @@version;` in a MySQL client)
12+
- MySQL: 5.6 <= version < 5.7
13+
- MariaDB: version >= 10.1.2
14+
2. Upstream MySQL `server_id` (execute `SHOW VARIABLES LIKE 'server_id';` in a MySQL client)
15+
- 0 < server_id < 4294967295
16+
- also needs to be unique
17+
3. Upstream MySQL user privileges
18+
- SELECT
19+
- REPLICATION SLAVE
20+
- REPLICATION CLIENT
21+
4. Downstream TiDB user privileges
22+
- SELECT
23+
- INSERT
24+
- UPDATE
25+
- DELETE
26+
- CREATE
27+
- DROP
28+
- ALTER
29+
- INDEX
30+
5. Upstream MySQL variables for binlog
31+
- `SHOW GLOBAL VARIABLES LIKE 'log_bin';`: `ON`
32+
- `SHOW GLOBAL VARIABLES LIKE 'binlog_format';`: `ROW`
33+
if you start to sync from an older binlog pos, you must ensure the `binlog_format` from that pos is also `ROW`.
34+
- for MySQL >= 5.6.2 or MariaDB >= 10.1.6, `SHOW GLOBAL VARIABLES LIKE 'binlog_row_image';`: `FULL`
35+
36+
937
Please describe your problem here:
1038

1139
>
@@ -22,18 +50,36 @@ Additionally, please provide the following info before submitting your issue. Th
2250
(paste syncer version here)
2351
```
2452
25-
- [ ] TiDB cluster version (execute `SELECT tidb_version();` in a MySQL client):
53+
- [ ] Upstream MySQL server version (execute `SELECT @@version;` in a MySQL client):
54+
55+
```
56+
(paste upstream MySQL server version here)
57+
```
58+
59+
- [ ] Downstream TiDB cluster version (execute `SELECT tidb_version();` in a MySQL client):
60+
61+
```
62+
(paste downstream TiDB cluster version here)
63+
```
64+
65+
- [ ] Upstream MySQL sql_mode (execute `SELECT @@sql_mode;` in a MySQL client):
66+
67+
```
68+
(paste MySQL sql_mode here)
69+
```
70+
71+
- [ ] Downstream TiDB sql_mode (execute `SELECT @@sql_mode;` in a MySQL client):
2672
2773
```
28-
(paste TiDB cluster version here)
74+
(paste TiDB sql_mode here)
2975
```
3076
3177
- [ ] How did you deploy syncer?
3278
3379
```
3480
```
3581
36-
- [ ] Other interesting information (system version, hardware config, etc):
82+
- [ ] Other interesting information (table schema, system version, hardware config, etc):
3783
3884
>
3985
>
@@ -48,4 +94,5 @@ Additionally, please provide the following info before submitting your issue. Th
4894
3. Common issues
4995
- [ ] Is the `worker-count` set to a reasonable value (suggest-32)?
5096
- [ ] Is the `batch` set to a reasonable value (suggest 100-1000)?
51-
- [ ] Is the downstream server MySQL and does not use the `utf8mb4` charset (syncer only allows the downstream server's charset to be `utf8mb4`)?
97+
- [ ] Is the downstream server MySQL and does not use the `utf8mb4` charset (syncer only allows the downstream server's charset to be `utf8mb4`)?
98+
- [ ] Do not some tables have primary/unique keys and slow synchronization? Syncer is not friendly for tables don't have priamry/unique key.

0 commit comments

Comments
 (0)