Gateway流量控制

功能说明

Hologres V5.0版本起支持Gateway流量控制，包含以下能力：

• 流量监控：按Warehouse或用户维度，统计实际承载批量数据的协议流量（bytes/s），并通过监控指标上报。您可以据此观察各Warehouse或用户的带宽使用情况。

• 流量限制：通过SQL动态设置Warehouse级或用户级的入/出方向字节速率限额。当实际流量超过限额时，系统会自动对受控流量进行限速，避免单一业务占用过多带宽。

核心规则如下：

• 支持两个维度的限流：Warehouse级（针对整个Warehouse的所有连接）和用户级（针对单个用户的所有连接）。

• 每个维度支持独立设置入方向（Client → Gateway）和出方向（Gateway → Client）的限额，单位为bytes/s。设置为0表示该方向不限速。

• 当Warehouse规则和用户规则同时生效时，取更严格的限制。

• 规则修改后实时同步到所有Gateway，无需重启连接或实例。

使用说明

• 仅Hologres V5.0及以上版本的计算组型实例支持。

• 设置和重置限流规则需要Superuser权限；查询限流规则无限制。

• 限流仅针对特定的协议消息：入方向对COPY生效，出方向对查询结果（DataRow）和COPY生效。SELECT、INSERT等非批量数据传输的协议消息不受入方向限流影响。

• 同一维度下的多个连接共享限流额度，并非按连接单独限流。例如，为Warehouse设置入方向限额3 MiB/s，则该Warehouse下所有连接的入方向总流量将被限制在3 MiB/s左右。

• 多个Gateway之间不做分布式协调，总有效吞吐约等于单个Gateway限额乘以在线Gateway数量。

• 限流为近似限流，允许短时间内的突发抖动，但长期平均速率会收敛到配置值附近。

• 限流生效期间，受控数据的传输速率会下降，但连接保持存活，不会断开。大结果集和COPY场景下，查询仍能正常完成，只是耗时可能增加。

功能语法

CALL hologres.hg_set_warehouse_traffic_limit(warehouse_name, in_bps, out_bps);

SELECT * FROM hologres.hg_show_warehouse_traffic_limit([warehouse_name]);

CALL hologres.hg_reset_warehouse_traffic_limit(warehouse_name);

CALL hologres.hg_set_user_traffic_limit(user_name, in_bps, out_bps);

SELECT * FROM hologres.hg_show_user_traffic_limit([user_name]);

CALL hologres.hg_reset_user_traffic_limit(user_name);

使用示例

CALL hologres.hg_set_warehouse_traffic_limit('my_warehouse', 10485760, 20971520);

SELECT * FROM hologres.hg_show_warehouse_traffic_limit('my_warehouse');

SELECT * FROM hologres.hg_show_warehouse_traffic_limit(NULL);

CALL hologres.hg_set_user_traffic_limit('my_user', 3145728, 0);

SELECT * FROM hologres.hg_show_user_traffic_limit(NULL);

CALL hologres.hg_reset_warehouse_traffic_limit('my_warehouse');

CALL hologres.hg_reset_user_traffic_limit('my_user');