SHOW REGIONS

列出可以在其中创建账户的所有 区域。此命令返回 Snowflake 区域名称、托管账户的云提供商(AWS、Google Cloud Platform 或 Microsoft Azure)以及该区域的云提供商名称。

另请参阅:

CURRENT_REGION

语法

SHOW REGIONS [ LIKE '<pattern>' ]
Copy

参数

LIKE 'pattern'

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

例如,以下模式返回 相同的 结果:

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

. 默认:无值(不对输出应用筛选)。

输出

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

描述

region_group

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

snowflake_region

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

cloud

托管账户的云提供商的名称。

region

账户所在的区域;即该区域的云提供商名称。

display_name

人类可读的云区域名称,例如 US West (Oregon)

使用说明

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

  • 该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。

  • MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下,只有账户管理员(具有 ACCOUNTADMIN 角色的用户)和安全管理员(具有 SECURITYADMIN 角色的用户)才具有 MANAGE GRANTS 权限。

  • To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

语言: 中文