Categories:

Account & Session DDL

SHOW REGIONS

Lists all the regions in which the accounts in your organization are located. 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.

Syntax

SHOW REGIONS [ LIKE '<pattern>' ]

Parameters

LIKE 'pattern'

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%' ...

Usage Notes

  • The command does not require a running warehouse to execute.

  • The command returns a maximum of 10K records for the specified object type, as dictated by the access privileges for the role used to execute the command; any records above the 10K limit are not returned, even with a filter applied.

    To view results for which more than 10K records exist, query the corresponding view (if one exists) in the Information Schema.

  • 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.

Output

The command output provides region properties and metadata in the following columns:

| region_group | snowflake_region | cloud | region |

Column

Description

region_group

Virtual Private Snowflake customers only: Region group where the account is located.

snowflake_region

Snowflake Region where the account is located.

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.