You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by mo...@apache.org on 2022/06/10 01:16:27 UTC
[incubator-doris] branch master updated: [doc] Optimize cluster upgrade and binlog load document modification, restore adds common errors (#10027)
This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-doris.git
The following commit(s) were added to refs/heads/master by this push:
new 1a31af0d85 [doc] Optimize cluster upgrade and binlog load document modification, restore adds common errors (#10027)
1a31af0d85 is described below
commit 1a31af0d85f418db75d3d975d9389c007db94dfe
Author: caoliang-web <71...@users.noreply.github.com>
AuthorDate: Fri Jun 10 09:16:22 2022 +0800
[doc] Optimize cluster upgrade and binlog load document modification, restore adds common errors (#10027)
1.restore adds common errors
2.Optimize cluster upgrade documentation
3.Modify binlog documentation
---
docs/en/docs/admin-manual/cluster-management/upgrade.md | 2 +-
docs/en/docs/admin-manual/data-admin/restore.md | 10 ++++++++++
.../docs/data-operate/import/import-way/binlog-load-manual.md | 2 +-
docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md | 2 +-
docs/zh-CN/docs/admin-manual/data-admin/restore.md | 10 ++++++++++
.../docs/data-operate/import/import-way/binlog-load-manual.md | 2 +-
6 files changed, 24 insertions(+), 4 deletions(-)
diff --git a/docs/en/docs/admin-manual/cluster-management/upgrade.md b/docs/en/docs/admin-manual/cluster-management/upgrade.md
index d0900f9633..b479a2a150 100644
--- a/docs/en/docs/admin-manual/cluster-management/upgrade.md
+++ b/docs/en/docs/admin-manual/cluster-management/upgrade.md
@@ -63,7 +63,7 @@ Doris can upgrade smoothly by rolling upgrades. The following steps are recommen
## Testing FE Metadata Compatibility
0. **Important! Exceptional metadata compatibility is likely to cause data cannot be restored!!**
-1. Deploy a test FE process (such as your own local developer) using the new version alone.
+1. Deploy a test FE process (It is recommended to use your own local development machine, or BE node. If it is on the Follower or Observer node, you need to stop the started process, but it is not recommended to test on the Follower or Observer node) using the new version alone.
2. Modify the FE configuration file fe.conf for testing and set all ports to **different from online**.
3. Add configuration in fe.conf: cluster_id=123456
4. Add the configuration in fe.conf: metadatafailure_recovery=true
diff --git a/docs/en/docs/admin-manual/data-admin/restore.md b/docs/en/docs/admin-manual/data-admin/restore.md
index 363f62f009..0a65d1a827 100644
--- a/docs/en/docs/admin-manual/data-admin/restore.md
+++ b/docs/en/docs/admin-manual/data-admin/restore.md
@@ -178,6 +178,16 @@ The commands related to the backup and restore function are as follows. For the
Delete the created remote repository. Deleting a warehouse only deletes the mapping of the warehouse in Doris, and does not delete the actual warehouse data.
+## Common mistakes
+
+1. Restore Report An Error：[20181: invalid md5 of downloaded file: /data/doris.HDD/snapshot/20220607095111.862.86400/19962/668322732/19962.hdr, expected: f05b63cca5533ea0466f62a9897289b5, get: d41d8cd98f00b204e9800998ecf8427e]
+
+ If the number of copies of the table backed up and restored is inconsistent, you need to specify the number of copies when executing the restore command. For specific commands, please refer to [RESTORE](../../sql-manual/sql-reference/Data-Definition-Statements/Backup-and-Restore/RESTORE.md) command manual
+
+2. Restore Report An Error：[COMMON_ERROR, msg: Could not set meta version to 97 since it is lower than minimum required version 100]
+
+ Backup and restore are not caused by the same version, use the specified meta_version to read the metadata of the previous backup. Note that this parameter is used as a temporary solution and is only used to restore the data backed up by the old version of Doris. The latest version of the backup data already contains the meta version, so there is no need to specify it. For the specific solution to the above error, specify meta_version = 100. For specific commands, please refer to [RES [...]
+
## More Help
For more detailed syntax and best practices used by RESTORE, please refer to the [RESTORE](../../sql-manual/sql-reference/Data-Definition-Statements/Backup-and-Restore/RESTORE.md) command manual, You can also type `HELP RESTORE` on the MySql client command line for more help.
diff --git a/docs/en/docs/data-operate/import/import-way/binlog-load-manual.md b/docs/en/docs/data-operate/import/import-way/binlog-load-manual.md
index 2de46fda97..5b65ef4c18 100644
--- a/docs/en/docs/data-operate/import/import-way/binlog-load-manual.md
+++ b/docs/en/docs/data-operate/import/import-way/binlog-load-manual.md
@@ -364,7 +364,7 @@ COMMENT "OLAP"
DISTRIBUTED BY HASH(`id`) BUCKETS 8;
-- enable batch delete
-ALTER TABLE canal_test.test1 ENABLE FEATURE "BATCH_DELETE";
+ALTER TABLE target_test ENABLE FEATURE "BATCH_DELETE";
```
**! ! Doris table structure and Mysql table structure field order must be consistent ! !**
diff --git a/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md b/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
index 156d695105..ae10f1062e 100644
--- a/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
+++ b/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
@@ -63,7 +63,7 @@ Doris 可以通过滚动升级的方式，平滑进行升级。建议按照以
## 测试 FE 元数据兼容性
0. **重要！!元数据兼容性异常很可能导致数据无法恢复！！**
-1. 单独使用新版本部署一个测试用的 FE 进程（比如自己本地的开发机）。
+1. 单独使用新版本部署一个测试用的 FE 进程（建议在自己本地的开发机，或者BE节点。如果在Follower或者Observer节点上，需要停止启动的进程,但是不建议在Follower或者Observer节点上测试）。
2. 修改测试用的 FE 的配置文件 fe.conf，将所有端口设置为**与线上不同**。
3. 在 fe.conf 添加配置：cluster_id=123456
4. 在 fe.conf 添加配置：metadata\_failure_recovery=true
diff --git a/docs/zh-CN/docs/admin-manual/data-admin/restore.md b/docs/zh-CN/docs/admin-manual/data-admin/restore.md
index 188efe878d..ad9f192e8f 100644
--- a/docs/zh-CN/docs/admin-manual/data-admin/restore.md
+++ b/docs/zh-CN/docs/admin-manual/data-admin/restore.md
@@ -178,6 +178,16 @@ RESTORE的更多用法可参考 [这里](../../sql-manual/sql-reference/Data-Def
删除已创建的远端仓库。删除仓库，仅仅是删除该仓库在 Doris 中的映射，不会删除实际的仓库数据。
+## 常见错误
+
+1. RESTORE报错：[20181: invalid md5 of downloaded file:/data/doris.HDD/snapshot/20220607095111.862.86400/19962/668322732/19962.hdr, expected: f05b63cca5533ea0466f62a9897289b5, get: d41d8cd98f00b204e9800998ecf8427e]
+
+ 备份和恢复的表的副本数不一致导致的，执行恢复命令时需指定副本个数，具体命令请参阅[RESTORE](../../sql-manual/sql-reference/Data-Definition-Statements/Backup-and-Restore/RESTORE.md) 命令手册
+
+2. RESTORE报错：[COMMON_ERROR, msg: Could not set meta version to 97 since it is lower than minimum required version 100]
+
+ 备份和恢复不是同一个版本导致的，使用指定的 meta_version 来读取之前备份的元数据。注意，该参数作为临时方案，仅用于恢复老版本 Doris 备份的数据。最新版本的备份数据中已经包含 meta version，无需再指定，针对上述错误具体解决方案指定meta_version = 100，具体命令请参阅[RESTORE](../../sql-manual/sql-reference/Data-Definition-Statements/Backup-and-Restore/RESTORE.md) 命令手册
+
## 更多帮助
关于 RESTORE 使用的更多详细语法及最佳实践，请参阅 [RESTORE](../../sql-manual/sql-reference/Data-Definition-Statements/Backup-and-Restore/RESTORE.md) 命令手册，你也可以在 MySql 客户端命令行下输入 `HELP RESTORE` 获取更多帮助信息。
diff --git a/docs/zh-CN/docs/data-operate/import/import-way/binlog-load-manual.md b/docs/zh-CN/docs/data-operate/import/import-way/binlog-load-manual.md
index 75c38498b8..bd9ec5cc4e 100644
--- a/docs/zh-CN/docs/data-operate/import/import-way/binlog-load-manual.md
+++ b/docs/zh-CN/docs/data-operate/import/import-way/binlog-load-manual.md
@@ -359,7 +359,7 @@ COMMENT "OLAP"
DISTRIBUTED BY HASH(`id`) BUCKETS 8;
-- enable batch delete
-ALTER TABLE canal_test.test1 ENABLE FEATURE "BATCH_DELETE";
+ALTER TABLE target_test ENABLE FEATURE "BATCH_DELETE";
```
**！！Doris表结构和Mysql表结构字段顺序必须保持一致！！**
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org