SHOW CONNECTIONS

列出您具有访问权限的连接。

输出返回按连接名称排序的连接元数据和属性（有关输出列的说明，请参阅本主题中 输出）。如果您希望使用提供的筛选器筛选结果，请务必注意这一点。

另请参阅：

CREATE CONNECTION、ALTER CONNECTION、DROP CONNECTION

语法

SHOW CONNECTIONS [ LIKE '<pattern>' ]
Copy

参数

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回 相同的 结果：

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

使用说明

  • 该命令不需要正在运行的仓库即可执行。

  • 若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

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

输出

命令输出在以下列中提供函数属性和元数据。覆盖多个 区域组 的组织的命令输出包括一个附加的 region_group 列。

列

描述

region_group

账户所在的 :ref:` 区域组 <label-region_groups>`。注意：仅对于覆盖多个区域组的组织，才会显示此列。

snowflake_region

账户所在的 Snowflake 区域。Snowflake 区域是云平台区域内与其他 Snowflake 区域隔离的独特位置。Snowflake 区域可以是多租户或单租户（对于 Virtual Private Snowflake 账户）。

created_on

创建连接的日期和时间。

account_name

账户的名称。组织管理员（即具有 ORGADMIN 角色的用户）可以更改账户名。

name

连接的名称。

comment

连接的注释。

is_primary

指示该连接是否是主连接。

primary

主连接的组织名称、账户名称和连接名称。创建辅助连接时，此值可以复制到 CREATE CONNECTION 命令的 AS REPLICA OF 子句。

failover_allowed_to_accounts

主连接可以重定向到的所有账户的列表。

connection_url

连接 URL，用户将其传递给客户端以建立与 Snowflake 的连接。

organization_name

Snowflake 组织的名称。

account_locator

区域中的账户定位器。

有关可为连接指定的属性的详细信息，请参阅 CREATE CONNECTION。

示例

显示名称以 test 开头的所有连接：

SHOW CONNECTIONS LIKE 'test%';
Copy
语言: 中文