This is an automated email from the ASF dual-hosted git repository. jiafengzheng pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push: new 9101ce47ce7 fix 9101ce47ce7 is described below commit 9101ce47ce7fcaf09c2d90a67e261340d9579f05 Author: jiafeng.zhang <zhang...@gmail.com> AuthorDate: Wed Aug 3 18:50:59 2022 +0800 fix --- .../cluster-management/elastic-expansion.md | 16 ++++++++++------ docs/advanced/materialized-view.md | 2 +- docs/get-starting/get-starting.md | 3 ++- .../cluster-management/elastic-expansion.md | 18 ++++++++++++------ .../current/advanced/materialized-view.md | 2 +- .../current/get-starting/get-starting.md | 19 +++++++++---------- 6 files changed, 35 insertions(+), 25 deletions(-) diff --git a/docs/admin-manual/cluster-management/elastic-expansion.md b/docs/admin-manual/cluster-management/elastic-expansion.md index 94446ae55ae..be6cc0e07a8 100644 --- a/docs/admin-manual/cluster-management/elastic-expansion.md +++ b/docs/admin-manual/cluster-management/elastic-expansion.md @@ -51,6 +51,16 @@ FE is divided into three roles: Leader, Follower and Observer. By default, a clu The first FE to start automatically becomes Leader. On this basis, several Followers and Observers can be added. +#### Configure and start Follower or Observer. + + Follower and Observer are configured with Leader. The following commands need to be executed at the first startup: + +`bin/start_fe.sh --helper host:edit_log_port --daemon` + +The host is the node IP of Leader, and the edit\_log\_port in Lead's configuration file fe.conf. The --helper is only required when follower/observer is first startup. + +#### Add Follower or Observer to the cluster + Add Follower or Observer. Connect to the started FE using mysql-client and execute: `ALTER SYSTEM ADD FOLLOWER "follower_host:edit_log_port";` @@ -61,12 +71,6 @@ or The follower\_host and observer\_host is the node IP of Follower or Observer, and the edit\_log\_port in its configuration file fe.conf. -Configure and start Follower or Observer. Follower and Observer are configured with Leader. The following commands need to be executed at the first startup: - -`bin/start_fe.sh --helper host:edit_log_port --daemon` - -The host is the node IP of Leader, and the edit\_log\_port in Lead's configuration file fe.conf. The --helper is only required when follower/observer is first startup. - View the status of Follower or Observer. Connect to any booted FE using mysql-client and execute: ```SHOW PROC '/frontends';``` diff --git a/docs/advanced/materialized-view.md b/docs/advanced/materialized-view.md index ea3d51ead8c..96ba58735f1 100644 --- a/docs/advanced/materialized-view.md +++ b/docs/advanced/materialized-view.md @@ -484,7 +484,7 @@ This problem can be solved by creating a materialized view with k3 as the first ## Error 1. DATA_QUALITY_ERR: "The data quality does not satisfy, please check your data" -Materialized view creation failed due to data quality issues. +Materialized view creation failed due to data quality issues or Schema Change memory usage exceeding the limit. If it is a memory problem, increase the `memory_limitation_per_thread_for_schema_change_bytes` parameter. Note: The bitmap type only supports positive integers. If there are negative Numbers in the original data, the materialized view will fail to be created ## More Help diff --git a/docs/get-starting/get-starting.md b/docs/get-starting/get-starting.md index 4119718ed15..3c6ee49d281 100644 --- a/docs/get-starting/get-starting.md +++ b/docs/get-starting/get-starting.md @@ -241,7 +241,7 @@ For a complete parameter comparison table, please go to [Profile parameter analy > For more detailed syntax and best practices used by Create-DataBase, see [Create-Database](../sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-DATABASE) command manual. > - > If you don't know the full name of the command, you can use "help command a field" for fuzzy query. If you type 'HELP CREATE', you can match `CREATE DATABASE`, `CREATE TABLE`, `CREATE USER` and other commands. + > If you don't know the full name of the command, you can use "help command a field" for fuzzy query. If you type `HELP CREATE`, you can match `CREATE DATABASE`, `CREATE TABLE`, `CREATE USER` and other commands After the database is created, you can view the database information through `SHOW DATABASES;`. @@ -469,6 +469,7 @@ For a complete parameter comparison table, please go to [Profile parameter analy > 1. FE_HOST is the IP of the node where any FE is located, and 8030 is the http_port in fe.conf. > 2. You can use the IP of any BE and the webserver_port in be.conf to import. For example: `BE_HOST:8040` + > 3. example_db is the database which you imported the tables The local file `table1_data` uses `,` as the separation between data, the details are as follows: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/cluster-management/elastic-expansion.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/cluster-management/elastic-expansion.md index f02cc566b2b..258f8d8a7ed 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/cluster-management/elastic-expansion.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/cluster-management/elastic-expansion.md @@ -51,6 +51,18 @@ FE 分为 Leader,Follower 和 Observer 三种角色。 默认一个集群, 第一个启动的 FE 自动成为 Leader。在此基础上,可以添加若干 Follower 和 Observer。 +#### 配置及启动 Follower 或 Observer + +这里 Follower 和 Observer 的配置同 Leader 的配置。 + +首先第一次启动时,需执行以下命令: + +`./bin/start_fe.sh --helper leader_fe_host:edit_log_port --daemon` + +其中 leader\_fe\_host 为 Leader 所在节点 ip, edit\_log\_port 在 Leader 的配置文件 fe.conf 中。--helper 参数仅在 follower 和 observer 第一次启动时才需要。 + +#### 将 Follower 或 Observer 加入到集群 + 添加 Follower 或 Observer。使用 mysql-client 连接到已启动的 FE,并执行: `ALTER SYSTEM ADD FOLLOWER "follower_host:edit_log_port";` @@ -61,12 +73,6 @@ FE 分为 Leader,Follower 和 Observer 三种角色。 默认一个集群, 其中 follower\_host和observer\_host 为 Follower 或 Observer 所在节点 ip,edit\_log\_port 在其配置文件 fe.conf 中。 -配置及启动 Follower 或 Observer。Follower 和 Observer 的配置同 Leader 的配置。第一次启动时,需执行以下命令: - -`./bin/start_fe.sh --helper leader_fe_host:edit_log_port --daemon` - -其中 leader\_fe\_host 为 Leader 所在节点 ip, edit\_log\_port 在 Leader 的配置文件 fe.conf 中。--helper 参数仅在 follower 和 observer 第一次启动时才需要。 - 查看 Follower 或 Observer 运行状态。使用 mysql-client 连接到任一已启动的 FE,并执行:SHOW PROC '/frontends'; 可以查看当前已加入集群的 FE 及其对应角色。 > FE 扩容注意事项: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced/materialized-view.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced/materialized-view.md index 80b1871e165..372c3b9d683 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced/materialized-view.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced/materialized-view.md @@ -481,7 +481,7 @@ MySQL [test]> desc advertiser_view_record; ## 异常错误 - 1. DATA_QUALITY_ERR: "The data quality does not satisfy, please check your data" 由于数据质量问题导致物化视图创建失败。 注意:bitmap类型仅支持正整型, 如果原始数据中存在负数,会导致物化视图创建失败 + 1. DATA_QUALITY_ERR: "The data quality does not satisfy, please check your data" 由于数据质量问题或者Schema Change内存使用超出限制导致物化视图创建失败。如果是内存问题,调大`memory_limitation_per_thread_for_schema_change_bytes`参数即可。 注意:bitmap类型仅支持正整型, 如果原始数据中存在负数,会导致物化视图创建失败 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/get-starting/get-starting.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/get-starting/get-starting.md index 6e19da23197..cd619a15fb0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/get-starting/get-starting.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/get-starting/get-starting.md @@ -125,19 +125,18 @@ under the License. 校验 FE 启动是否成功 > 1. 检查是否启动成功,JPS 命令下有没有 PaloFe 进程 - > 2. FE 进程启动后,会⾸先加载元数据,根据 FE ⻆⾊的不同,在⽇志中会看到 transfer from UNKNOWN to MASTER/FOLLOWER/OBSERVER 。最终会看到 thrift server started ⽇志,并且可以通过 MySQL 客户端连接到 FE,则表示 FE 启动成功。 - > 3. 也可以通过如下连接查看是否启动成功:http://fe_host:fe_http_port/api/bootstrap 如果返回: {"status":"OK","msg":"Success"} 则表示启动成功,其余情况,则可能存在问题。 - > 4. 外⽹环境访问 http://fe_host:fe_http_port 查看是否可以访问 WebUI 界⾯,登录账号默认为 root,密码为空 - > + > 2. FE 进程启动后,会先加载元数据,根据 FE 角色的不同,在志中会看到 transfer from UNKNOWN to MASTER/FOLLOWER/OBSERVER 。最终会看到 thrift server started 日志,并且可以通过 mysql 客户端连接到 FE,则 表示 FE 启动成功。 + > 3. 也可以通过如下连接查看是否启动成功: http://fe_host:fe_http_port/api/bootstrap (fe_http_port默认8030)如果返回: {"status":"OK","msg":"Success"} 则表示启动成功,其余情况,则可能存在问题。 + > 4. 外网环境访问 http://fe_host:fe_http_port 查看是否可以访问WebUI界面,登录账号默认为root,密码为空 > **注:如果在 fe.log 中查看不到启动失败的信息,也许在 fe.out 中可以看到。** 校验 BE 启动是否成功 > 1. BE 进程启动后,如果之前有数据,则可能有数分钟不等的数据索引加载时间。 - > 2. 如果是 BE 的第⼀次启动,或者该 BE 尚未加⼊任何集群,则 BE ⽇志会定期滚动 waiting to receive first heartbeat from frontend 字样。表示 BE 还未通过 FE 的⼼跳收到 Master 的地址,正在被动等待。这种错误⽇志,在 FE 中 ADD BACKEND 并发送⼼跳后,就会消失。如果在接到⼼跳后,⼜重复出现 master client, get client from cache failed.host: , port: 0, code: 7 字样,说明 FE 成功连接了 BE,但 BE ⽆法主动连接 FE。可能需要检查 BE 到 FE 的 rpc_port 的连通性。 - > 3. 如果 BE 已经被加⼊集群,⽇志中应该每隔 5 秒滚动来⾃ FE 的⼼跳⽇志:get heartbeat, host: xx.xx.xx.xx, port: 9020, cluster id: xxxxxx,表示⼼跳正常。 - > 4. 其次,⽇志中应该每隔 10 秒滚动 finish report task success. return code: 0 的字样,表示 BE 向 FE 的通信正常。 - > 5. 同时,如果有数据查询,应该能看到不停滚动的⽇志,并且有 execute time is xxx ⽇志,表示 BE 启动成功,并且查询正常。 + > 2. 如果是 BE 的第一次启动,或者该 BE 尚未加载任何集群,则 BE 日志会定期滚动 waiting to receive first heartbeat from frontend 字样。表示 BE 还未通过 FE 的⼼跳收到 Master 的地址,正在被动等待。这种错误日志, 在 FE 中 ADD BACKEND 并发送⼼跳后,就会消失。如果在接到⼼跳后,重复出现 master client, get client from cache failed.host: , port: 0, code: 7 字样,说明 FE 成功连接了 BE,但 BE 无法主动连接 FE,可能需要检查 BE 到 FE 的 rpc_port 的连通性。 + > 3. 如果 BE 已经被加到集群,日志中应该每隔 5 秒滚动来检测 FE 的心跳日志: get heartbeat, host: xx.xx.xx.xx, port: 9020, cluster id: xxxxxx ,表示⼼跳正常。 + > 4. 其次,日志中应该每隔 10 秒滚动 finish report task success. return code: 0 的字样,表示 BE 向 FE 的通信正常。 + > 5. 同时,如果有数据查询,应该能看到不停滚动的日志,并且有 execute time is xxx 日志,表示 BE 启动成功,并且查询正常。 > 6. 也可以通过如下连接查看是否启动成功: http://be_host:be_http_port/api/health 如果返回: {"status": "OK","msg": "To Be Added"} 则表示启动成功,其余情况,则可能存在问题。 > > **注:如果在 be.INFO 中查看不到启动失败的信息,也许在 be.out 中可以看到。** @@ -240,7 +239,7 @@ FE 将查询计划拆分成为 Fragment 下发到 BE 进行任务执行。BE 在 > 关于 Create-DataBase 使用的更多详细语法及最佳实践,请参阅 [Create Database](../sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-DATABASE) 命令手册。 > - > 如果不清楚命令的全名,可以使用 "help 命令某一字段" 进行模糊查询。如键入 'HELP CREATE',可以匹配到 `CREATE DATABASE`, `CREATE TABLE`, `CREATE USER` 等命令。 + > 如果不清楚命令的全名,可以使用 "help 命令某一字段" 进行模糊查询。如键入 `HELP CREATE`,可以匹配到 `CREATE DATABASE`, `CREATE TABLE`, `CREATE USER` 等命令。 数据库创建完成之后,可以通过 `SHOW DATABASES;` 查看数据库信息。 @@ -468,7 +467,7 @@ FE 将查询计划拆分成为 Fragment 下发到 BE 进行任务执行。BE 在 > 1. FE_HOST 是任一 FE 所在节点 IP,8030 为 fe.conf 中的 http_port。 > 2. 可以使用任一 BE 的 IP,以及 be.conf 中的 webserver_port 进行导入。如:`BE_HOST:8040` - + > 3. example_db 是你导入表所在的数据库 本地文件 `table1_data` 以 `,` 作为数据之间的分隔,具体内容如下: ```text --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org For additional commands, e-mail: commits-h...@doris.apache.org