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 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

    出力列を参照する場合は、列名に 二重引用符で囲まれた識別子 を使用します。たとえば、出力列 type を選択するには、 SELECT "type" を指定します。

    SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

例

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

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