ALTER SYSTEM

description

  1. 该语句用于操作一个系统内的节点。(仅管理员使用!)
  2. 语法:
  3. 1) 增加节点(不使用多租户功能则按照此方法添加)
  4. ALTER SYSTEM ADD BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  5. 2) 增加空闲节点(即添加不属于任何clusterBACKEND)
  6. ALTER SYSTEM ADD FREE BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  7. 3) 增加节点到某个cluster
  8. ALTER SYSTEM ADD BACKEND TO cluster_name "host:heartbeat_port"[,"host:heartbeat_port"...];
  9. 4) 删除节点
  10. ALTER SYSTEM DROP BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  11. 5) 节点下线
  12. ALTER SYSTEM DECOMMISSION BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  13. 6) 增加Broker
  14. ALTER SYSTEM ADD BROKER broker_name "host:port"[,"host:port"...];
  15. 7) 减少Broker
  16. ALTER SYSTEM DROP BROKER broker_name "host:port"[,"host:port"...];
  17. 8) 删除所有Broker
  18. ALTER SYSTEM DROP ALL BROKER broker_name
  19. 9) 设置一个 Load error hub,用于集中展示导入时的错误信息
  20. ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES ("key" = "value"[, ...]);
  21. 10) 修改一个 BE 节点的属性
  22. ALTER SYSTEM MODIFY BACKEND "host:heartbeat_port" SET ("key" = "value"[, ...]);
  23. 说明:
  24. 1) host 可以是主机名或者ip地址
  25. 2) heartbeat_port 为该节点的心跳端口
  26. 3) 增加和删除节点为同步操作。这两种操作不考虑节点上已有的数据,节点直接从元数据中删除,请谨慎使用。
  27. 4) 节点下线操作用于安全下线节点。该操作为异步操作。如果成功,节点最终会从元数据中删除。如果失败,则不会完成下线。
  28. 5) 可以手动取消节点下线操作。详见 CANCEL DECOMMISSION
  29. 6) Load error hub:
  30. 当前支持两种类型的 HubMysql Broker。需在 PROPERTIES 中指定 "type" = "mysql" "type" = "broker"
  31. 如果需要删除当前的 load error hub,可以将 type 设为 null
  32. 1) 当使用 Mysql 类型时,导入时产生的错误信息将会插入到指定的 mysql 库表中,之后可以通过 show load warnings 语句直接查看错误信息。
  33. Mysql 类型的 Hub 需指定以下参数:
  34. hostmysql host
  35. portmysql port
  36. usermysql user
  37. passwordmysql password
  38. databasemysql database
  39. tablemysql table
  40. 2) 当使用 Broker 类型时,导入时产生的错误信息会形成一个文件,通过 broker,写入到指定的远端存储系统中。须确保已经部署对应的 broker
  41. Broker 类型的 Hub 需指定以下参数:
  42. broker: broker 的名称
  43. path: 远端存储路径
  44. other properties: 其他访问远端存储所必须的信息,比如认证信息等。
  45. 7) 修改 BE 节点属性目前支持以下属性:
  46. 1. tag.location:资源标签
  47. 2. disable_query: 查询禁用属性
  48. 3. disable_load: 导入禁用属性

example

  1. 1. 增加一个节点
  2. ALTER SYSTEM ADD BACKEND "host:port";
  3. 2. 增加一个空闲节点
  4. ALTER SYSTEM ADD FREE BACKEND "host:port";
  5. 3. 删除两个节点
  6. ALTER SYSTEM DROP BACKEND "host1:port", "host2:port";
  7. 4. 下线两个节点
  8. ALTER SYSTEM DECOMMISSION BACKEND "host1:port", "host2:port";
  9. 5. 增加两个Hdfs Broker
  10. ALTER SYSTEM ADD BROKER hdfs "host1:port", "host2:port";
  11. 6. 添加一个 Mysql 类型的 load error hub
  12. ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES
  13. ("type"= "mysql",
  14. "host" = "192.168.1.17"
  15. "port" = "3306",
  16. "user" = "my_name",
  17. "password" = "my_passwd",
  18. "database" = "doris_load",
  19. "table" = "load_errors"
  20. );
  21. 7. 添加一个 Broker 类型的 load error hub
  22. ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES
  23. ("type"= "broker",
  24. "name" = "bos",
  25. "path" = "bos://backup-cmy/logs",
  26. "bos_endpoint" = "http://gz.bcebos.com",
  27. "bos_accesskey" = "069fc278xxxxxx24ddb522",
  28. "bos_secret_accesskey"="700adb0c6xxxxxx74d59eaa980a"
  29. );
  30. 8. 删除当前的 load error hub
  31. ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES
  32. ("type"= "null");
  33. 9. 修改 BE 的资源标签
  34. ALTER SYSTEM MODIFY BACKEND "host1:9050" SET ("tag.location" = "group_a");
  35. 10. 修改 BE 的查询禁用属性
  36. ALTER SYSTEM MODIFY BACKEND "host1:9050" SET ("disable_query" = "true");
  37. 11. 修改 BE 的导入禁用属性
  38. ALTER SYSTEM MODIFY BACKEND "host1:9050" SET ("disable_load" = "true");

keyword

  1. ALTER,SYSTEM,BACKEND,BROKER,FREE