ALTER CONNECTION

修改现有连接的属性。

另请参阅：

CREATE CONNECTION、DROP CONNECTION、SHOW CONNECTIONS

语法

ALTER CONNECTION <name> ENABLE FAILOVER TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ]
                        [ IGNORE EDITION CHECK ]

ALTER CONNECTION <name> DISABLE FAILOVER [ TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ] ]

ALTER CONNECTION <name> PRIMARY

ALTER CONNECTION [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER CONNECTION [ IF EXISTS ] <name> UNSET COMMENT
Copy

参数

name

要更改的连接的标识符。

ENABLE FAILOVER TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ]

指定组织中以逗号分隔的账户列表，在此列表中，可以将此主连接的辅助连接提升为主连接。列表中的每个账户都要包含组织名称。

列表中的每个账户 必须 与具有主连接的账户位于不同的区域。否则，命令将失败。

DISABLE FAILOVER [ TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ] ]

禁用此主连接的故障转移，这意味着此主连接的任何辅助连接都不能提升为主连接。

要对选定账户（而不是所有账户）禁用故障转移，请对这些账户指定一个以逗号分隔的列表。

PRIMARY

将连接提升为主连接。

SET ...

指定要为连接设置的属性：

COMMENT = 'string'

为连接添加注释或覆盖现有注释。

UNSET ...

指定要为连接取消设置的属性，这会将其重置为默认值。

目前，唯一可以取消设置的属性是 COMMENT，它会移除连接的注释（如果存在）。

使用说明

  • 只有账户管理员（具有 ACCOUNTADMIN 角色的用户）可执行此 SQL 命令。

  • 如果为 Snowflake 账户启用了 Snowflake 服务的专用连接，则当连接被提升为主连接时，网络管理员必须为连接 URL 更新 DNS CNAME 记录。有关更多信息，请参阅 为 Snowflake 服务的专用连接配置 DNS 设置。

  • 关于元数据：

    注意

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

示例

允许 myorg 组织中的账户 myaccount2 和 myaccount3 各自存储 myconnection 连接的辅助连接：

ALTER CONNECTION myconnection ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;
Copy

为连接添加注释：

ALTER CONNECTION myconnection SET COMMENT = 'New comment for connection';
Copy

将辅助连接提升为主连接：

ALTER CONNECTION myconnection PRIMARY;
Copy
语言: 中文