ALTER SYSTEM

description

该语句用于操作一个系统内的节点。(仅管理员使用!) 语法:

  1. 增加节点(不使用多租户功能则按照此方法添加)

    ALTER SYSTEM ADD BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  2. 增加空闲节点(即添加不属于任何cluster的BACKEND)

    ALTER SYSTEM ADD FREE BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  3. 增加节点到某个cluster

    ALTER SYSTEM ADD BACKEND TO cluster_name "host:heartbeat_port"[,"host:heartbeat_port"...];
  4. 删除节点

    ALTER SYSTEM DROP BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  5. 节点下线

    ALTER SYSTEM DECOMMISSION BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
  6. 增加Broker

    ALTER SYSTEM ADD BROKER broker_name "host:port"[,"host:port"...];
  7. 减少Broker

    ALTER SYSTEM DROP BROKER broker_name "host:port"[,"host:port"...];
  8. 删除所有Broker

    ALTER SYSTEM DROP ALL BROKER broker_name
  9. 设置一个 Load error hub,用于集中展示导入时的错误信息

    ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES ("key" = "value"[, ...]);

说明:

  1. host 可以是主机名或者ip地址

  2. heartbeat_port 为该节点的心跳端口

  3. 增加和删除节点为同步操作。这两种操作不考虑节点上已有的数据,节点直接从元数据中删除,请谨慎使用。

  4. 节点下线操作用于安全下线节点。该操作为异步操作。如果成功,节点最终会从元数据中删除。如果失败,则不会完成下线。

  5. 可以手动取消节点下线操作。详见 CANCEL DECOMMISSION

  6. Load error hub:

    当前支持两种类型的 Hub:Mysql 和 Broker。需在 PROPERTIES 中指定 "type" = "mysql" 或 "type" = "broker"。 如果需要删除当前的 load error hub,可以将 type 设为 null。

    1. 当使用 Mysql 类型时,导入时产生的错误信息将会插入到指定的 mysql 库表中,之后可以通过 show load warnings 语句直接查看错误信息。

      Mysql 类型的 Hub 需指定以下参数:

      host:mysql host
      port:mysql port
      user:mysql user
      password:mysql password
      database:mysql database
      table:mysql table
    2. 当使用 Broker 类型时,导入时产生的错误信息会形成一个文件,通过 broker,写入到指定的远端存储系统中。须确保已经部署对应的 broker。

      Broker 类型的 Hub 需指定以下参数:

      broker: broker 的名称
      path: 远端存储路径
      other properties: 其他访问远端存储所必须的信息,比如认证信息等。

example

  1. 增加一个节点

    ALTER SYSTEM ADD BACKEND "host:port";
  2. 增加一个空闲节点

    ALTER SYSTEM ADD FREE BACKEND "host:port";
  3. 删除两个节点

    ALTER SYSTEM DROP BACKEND "host1:port", "host2:port";
  4. 下线两个节点

    ALTER SYSTEM DECOMMISSION BACKEND "host1:port", "host2:port";
  5. 增加两个Hdfs Broker

    ALTER SYSTEM ADD BROKER hdfs "host1:port", "host2:port";
  6. 添加一个 Mysql 类型的 load error hub

    ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES
    ("type"= "mysql",
    "host" = "192.168.1.17"
    "port" = "3306",
    "user" = "my_name",
    "password" = "my_passwd",
    "database" = "starrocks_load",
    "table" = "load_errors"
    );
  7. 添加一个 Broker 类型的 load error hub

    ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES
    ("type"= "broker",
    "name" = "bos",
    "path" = "bos://backup-cmy/logs",
    "bos_endpoint" = "http://gz.bcebos.com",
    "bos_accesskey" = "069fc278xxxxxx24ddb522",
    "bos_secret_accesskey"="700adb0c6xxxxxx74d59eaa980a"
    );
  8. 删除当前的 load error hub

    ALTER SYSTEM SET LOAD ERRORS HUB PROPERTIES
    ("type"= "null");

keyword

ALTER,SYSTEM,BACKEND,BROKER,FREE