# 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" = "doris_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