ALTER SYSTEM

description

  1. 该语句用于操作一个系统内的节点。（仅管理员使用！）
  2. 语法：
  3.     1) 增加节点(不使用多租户功能则按照此方法添加)
  4.         ALTER SYSTEM ADD BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  5.     2) 增加空闲节点(即添加不属于任何cluster的BACKEND)
  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"[, ...]);
  24. 说明：
  25.     1) host 可以是主机名或者ip地址
  26.     2) heartbeat_port 为该节点的心跳端口
  27.     3) 增加和删除节点为同步操作。这两种操作不考虑节点上已有的数据，节点直接从元数据中删除，请谨慎使用。
  28.     4) 节点下线操作用于安全下线节点。该操作为异步操作。如果成功，节点最终会从元数据中删除。如果失败，则不会完成下线。
  29.     5) 可以手动取消节点下线操作。详见 CANCEL DECOMMISSION
  30.     6) Load error hub:
  31.         当前支持两种类型的 Hub：Mysql 和 Broker。需在 PROPERTIES 中指定 "type" = "mysql" 或 "type" = "broker"。
  32.         如果需要删除当前的 load error hub，可以将 type 设为 null。
  33.         1) 当使用 Mysql 类型时，导入时产生的错误信息将会插入到指定的 mysql 库表中，之后可以通过 show load warnings 语句直接查看错误信息。
  35.             Mysql 类型的 Hub 需指定以下参数：
  36.                 host：mysql host
  37.                 port：mysql port
  38.                 user：mysql user
  39.                 password：mysql password
  40.                 database：mysql database
  41.                 table：mysql table
  43.         2) 当使用 Broker 类型时，导入时产生的错误信息会形成一个文件，通过 broker，写入到指定的远端存储系统中。须确保已经部署对应的 broker
  44.             Broker 类型的 Hub 需指定以下参数：
  45.                 broker: broker 的名称
  46.                 path: 远端存储路径
  47.                 other properties: 其他访问远端存储所必须的信息，比如认证信息等。
  49.     7) 修改 BE 节点属性目前支持以下属性：
  51.         1. tag.location：资源标签
  52.         2. disable_query: 查询禁用属性
  53.         3. disable_load: 导入禁用属性

example

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

keyword

  1. ALTER,SYSTEM,BACKEND,BROKER,FREE