[GitHub] [incubator-doris] carlvinhust2012 commented on a diff in pull request #9814: [doc]Add common error messages to doris backup

[GitBox <gi...@apache.org>]

carlvinhust2012 commented on code in PR #9814:
URL: https://github.com/apache/incubator-doris/pull/9814#discussion_r883669025


##########
docs/zh-CN/admin-manual/data-admin/backup.md:
##########
@@ -141,10 +141,21 @@ BACKUP的更多用法可参考 [这里](../../sql-manual/sql-reference/Data-Defi
 ## 重点说明
 
 1. 备份恢复相关的操作目前只允许拥有 ADMIN 权限的用户执行。
+
 2. 一个 Database 内，只允许有一个正在执行的备份或恢复作业。
+
 3. 备份和恢复都支持最小分区（Partition）级别的操作，当表的数据量很大时，建议按分区分别执行，以降低失败重试的代价。
+
 4. 因为备份恢复操作，操作的都是实际的数据文件。所以当一个表的分片过多，或者一个分片有过多的小版本时，可能即使总数据量很小，依然需要备份或恢复很长时间。用户可以通过 `SHOW PARTITIONS FROM table_name;` 和 `SHOW TABLET FROM table_name;` 来查看各个分区的分片数量，以及各个分片的文件版本数量，来预估作业执行时间。文件数量对作业执行的时间影响非常大，所以建议在建表时，合理规划分区分桶，以避免过多的分片。
+
 5. 当通过 `SHOW BACKUP` 或者 `SHOW RESTORE` 命令查看作业状态时。有可能会在 `TaskErrMsg` 一列中看到错误信息。但只要 `State` 列不为 `CANCELLED`，则说明作业依然在继续。这些 Task 有可能会重试成功。当然，有些 Task 错误，也会直接导致作业失败。
+
+   常见的`TaskErrMsg` 错误如下：
+
+​         Q1：备份到HDFS，状态显示UPLOADING，TaskErrMsg 错误信息：[13333: Close broker writer failed, broker:TNetworkAddress(hostname=10.10.0.0,        port=8000) msg:errors while close file output stream, cause by: DataStreamer Exception: ]
+
+​         这个一般是网络通信问题，查看broker日志，看某个ip 或者端口不通，如果是云服务，则需要查看是否访问了内网，如果是可以在borker 配置文件下添加hdfs-site.xml，还需在hdfs-site.xml配置文件下添加dfs.client.use.datanode.hostname=true，并在broker节点上配置HADOOP 集群的主机名映射

Review Comment:
   if you can modify "如果是可以在borker 配置文件" to "如果是，则可以在borker 配置文件"， maybe more better.
   by the way, use a period at the end of the sentence will be more better.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org