CREATE CONNECTION

在账户中创建新连接。有关更多详细信息，请参阅 重定向客户端连接。

另请参阅：

ALTER CONNECTION、DROP CONNECTION、SHOW CONNECTIONS

语法

主连接

CREATE CONNECTION [ IF NOT EXISTS ] <name>
  [ COMMENT = '<string_literal>' ]
Copy

辅助连接

CREATE CONNECTION [ IF NOT EXISTS ] <name>
  AS REPLICA OF <organization_name>.<account_name>.<name>
  [ COMMENT = '<string_literal>' ]
Copy

必填参数

name

用于指定连接的标识符（即名称）的字符串。它必须符合以下条件：

  • 必须以字母字符开头，并且只能包含字母、十进制数字 (0-9) 和下划线 (_)。

  • 对于主连接，其名称在组织中的连接名称和账户名称中必须唯一。

  • 对于辅助连接，其名称必须与其主连接的名称匹配。

辅助连接参数

AS REPLICA OF organization_name.account_name.name

指定创建副本（即辅助连接）所用的主连接的标识符。

organization_name

指定组织的标识符。

account_name

指定账户的标识符。

name

指定主连接的标识符。

可选参数

COMMENT = 'string_literal'

指定连接的注释。

默认：无值

访问控制要求

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

使用说明

  • 如果为 Snowflake 账户启用了 Snowflake 服务的专用连接，网络管理器必须创建和管理 DNS CNAME 记录。有关更多详细信息，请参阅 为 Snowflake 服务的专用连接配置 DNS 设置。

  • 关于元数据：

    注意

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

示例

在组织 myaccount1 中为账户 myorg 创建连接：

CREATE CONNECTION IF NOT EXISTS myconnection;
Copy

创建辅助连接作为其主连接的副本。SHOW CONNECTIONS 的输出中的列 primary 显示主连接：

CREATE CONNECTION myconnection AS REPLICA OF myorg.myaccount1.myconnection;
Copy
语言: 中文