Lists the connections for which you have access privileges.
The output returns connection metadata and properties, ordered by connection name (see Output in this topic for descriptions of the output columns). This is important to note if you intend to filter the results using the provided filters.
SHOW CONNECTIONS [ 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).
The command output provides connection 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).
created_on
Date and time when the connection was created.
account_name
Name of the account. An organization administrator can change the account name.
name
Name of the connection.
comment
Comment for the connection.
is_primary
Indicates whether the connection is a primary connection.
primary
Organization name, account name, and connection name of the primary connection. This value can be copied into the AS REPLICA OF clause of the CREATE CONNECTION command when creating secondary connections.
failover_allowed_to_accounts
A list of any accounts that the primary connection can redirect to.
connection_url
Connection URL that users pass to a client to establish a connection to Snowflake.
organization_name
Name of your Snowflake organization.
account_locator
Account locator in a region.
For more information about the properties that can be specified for a connection, see CREATE CONNECTION.
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 pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.
The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.
Show all the connections whose name starts with test:
SHOW CONNECTIONS LIKE 'test%';Copy
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4