ALTER GATEWAY¶

修改现有网关的配置。使用此命令可更新网关的流量拆分配置。

另请参阅：: CREATE GATEWAY、DESCRIBE GATEWAY、DROP GATEWAY、SHOW GATEWAYS

语法¶

ALTER GATEWAY [ IF EXISTS ] <name>
  FROM SPECIFICATION <specification_text>

参数¶

name

指定要更改的网关的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅标识符要求。

FROM SPECIFICATION

指定内联更新的网关规范。该规范定义了流量拆分配置。

该规范使用以下格式：

spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>

规范参数¶

type

固定值。必须设置为 traffic_split。

split_type

固定值。必须设置为 custom。

targets

要将流量路由到的目标端点列表。每个目标必须指定：

type: 固定值。必须设置为 endpoint。
value: 完全限定端点名称，格式为 db.schema.service!endpoint。每个目标端点都必须存在。
weight: 此端点的流量权重，指定为整数。所有权重之和必须为 100。

备注

默认情况下，每个网关的最大端点数为 5。

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：


权限	对象	备注
MODIFY 或 OWNERSHIP	网关	更改网关配置时需要。
BIND SERVICE ENDPOINT	账户	将服务端点绑定到网关时需要。
USAGE	数据库	对于包含网关的数据库是必需的。
USAGE	架构	对于包含网关的架构是必需的。
USAGE	服务端点	对于目标服务端点是必需的。

要授予所需权限，请使用以下命令：

-- Grant MODIFY or OWNERSHIP privilege on the gateway
GRANT MODIFY ON GATEWAY <gateway_name> TO ROLE <role_name>;
-- OR
GRANT OWNERSHIP ON GATEWAY <gateway_name> TO ROLE <role_name>;

-- Grant BIND SERVICE ENDPOINT privilege on the account
GRANT BIND SERVICE ENDPOINT ON ACCOUNT TO ROLE <role_name>;

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

使用说明¶

关于元数据：

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

示例¶

更改网关以更新流量拆分配置：

ALTER GATEWAY split_gateway
  FROM SPECIFICATION $$
spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: db.schema.s2!ep1
    weight: 60
  - type: endpoint
    value: db.schema.s1!ep1
    weight: 40
$$;