SHOW REGIONS¶

Lists all the regions in which accounts can be created. This command returns the Snowflake Region name, the cloud provider (AWS, Google Cloud Platform, or Microsoft Azure) that hosts the account, and the cloud provider’s name for the region.

See also:

CURRENT_REGION

Syntax¶

SHOW REGIONS [ LIKE '<pattern>' ]
Copy

Parameters¶

LIKE 'pattern'

Optionally filters the command output by object name. The filter uses case-insensitive pattern matching, with support for SQL wildcard characters (% and _).

For example, the following patterns return the same results:

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

. Default: No value (no filtering is applied to the output).

Output¶

The command output provides region properties and metadata in the following columns. The command output for organizations that span multiple region groups includes an additional region_group column.

Column

Description

region_group

Region group where the account is located. Note: This column is only displayed for organizations that span multiple region groups.

snowflake_region

Snowflake Region where the account is located. A Snowflake Region is a distinct location within a cloud platform region that is isolated from other Snowflake Regions. A Snowflake Region can be either multi-tenant or single-tenant (for a Virtual Private Snowflake account).

cloud

Name of the cloud provider that hosts the account.

region

Region where the account is located; i.e. the cloud provider’s name for the region.

display_name

Human-readable cloud region name, e.g. US West (Oregon)

Usage notes¶

  • The command doesn’t require a running warehouse to execute.

  • The command only returns objects for which the current user’s current role has been granted at least one access privilege.

  • The MANAGE GRANTS access privilege implicitly allows its holder to see every object in the account. By default, only the account administrator (users with the ACCOUNTADMIN role) and security administrator (users with the SECURITYADMIN role) have the MANAGE GRANTS privilege.

  • To post-process the output of this command, you can use the RESULT_SCAN function, which treats the output as a table that can be queried.

Language: English