SHOW CONNECTIONS

アクセス権限を持っている 接続 をリストします。

出力は、接続名の順に並べられた接続メタデータとプロパティを返します（出力列の説明については、このトピック内の 出力 を参照）。提供されたフィルターを使用して結果をフィルターする場合は、これに注意することが重要です。

こちらもご参照ください。

CREATE CONNECTION、 ALTER CONNECTION、 DROP CONNECTION

構文

SHOW CONNECTIONS [ LIKE '<pattern>' ]
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

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

. デフォルト: 値なし（フィルタリングは出力に非適用）。

出力

コマンド出力では、次の列に接続のプロパティとメタデータが提供されます。複数の リージョングループ にまたがる組織のコマンド出力には、追加の region_group 列が含まれています。

列

説明

region_group

アカウントが配置されている リージョングループ。注: この列は、複数のリージョングループにまたがる組織に対してのみ表示されます。

snowflake_region

アカウントが配置されているSnowflake Region。Snowflake Regionは、他のSnowflake Regionから分離されたクラウドプラットフォームリージョン内の別個の場所です。Snowflake Regionは、マルチテナントまたはシングルテナント（Virtual Private Snowflakeアカウントの場合）にすることができます。

created_on

接続が作成された日時。

account_name

アカウントの名前。組織管理者はアカウント名を変更できます。

name

接続の名前。

comment

接続のコメント。

is_primary

接続がプライマリ接続であるかどうかを示します。

primary

プライマリ接続の組織名、アカウント名、および接続名。この値は、セカンダリ接続を作成するときに CREATE CONNECTION コマンドの AS REPLICA OF 句にコピーできます。

failover_allowed_to_accounts

プライマリ接続がリダイレクトできるアカウントのリスト。

connection_url

Snowflakeへの接続を確立するためにユーザーがクライアントに渡す接続 URL。

organization_name

Snowflake組織の名前。

account_locator

リージョン内のアカウントロケーター。

接続に指定できるプロパティの詳細については、 CREATE CONNECTION をご参照ください。

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    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.

例

名前が test で始まるすべての接続を表示します。

SHOW CONNECTIONS LIKE 'test%';
Copy
言語: 日本語