SHOW COMPUTE POOLS¶
アクセス権限があるアカウントの コンピュートプール をリストします。
Tip
SQL 以外にも、 Snowflake REST APIs、 Snowflake Python APIs、 Snowflake CLI などのインターフェイスを使うことができます。代替インターフェイス をご参照ください。
構文¶
SHOW COMPUTE POOLS [ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <ROWS> [ FROM '<name-string>' ] ]
パラメーター¶
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし（フィルタリングは出力に非適用）。
STARTS WITH 'name_string'オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
たとえば、次の文字列は 異なる 結果を返します。
... STARTS WITH 'B' ...... STARTS WITH 'b' .... デフォルト: 値なし（フィルターは出力に適用されない）
LIMIT rows [ FROM 'name_string' ]オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。
オプションの
FROM 'name_string'サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。
デフォルト：値なし（出力に制限は適用されない）
注釈
FROM 'name_string'句とSTARTS WITH 'name_string'句の両方をサポートする SHOW コマンドの場合、同じステートメントでこれらの両方の句を組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。さらに、オブジェクトは名前の辞書式順序で返されるため、
FROM 'name_string'は、STARTS WITH 'name_string'によって返される行よりも辞書式の値が大きい行のみを返します。例:
... STARTS WITH 'A' LIMIT ... FROM 'B'は結果を返しません。... STARTS WITH 'B' LIMIT ... FROM 'A'は結果を返しません。... STARTS WITH 'A' LIMIT ... FROM 'AB'は結果を返します（入力文字列に一致する行がある場合）。
アクセス制御の要件¶
この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
注意 |
|---|---|---|
これらの権限のいずれか1つ: OWNERSHIP、 USAGE、 MONITOR、 または OPERATE |
コンピューティングプール |
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
出力¶
コマンド出力では、次の列にコンピュートプールのプロパティとメタデータが提供されます。
列 |
説明 |
|---|---|
|
コンピュートプール名。 |
|
コンピュートプールの状態。詳細については、 コンピューティングプールのライフサイクル をご参照ください。 |
|
コンピュートプールの最小ノード数。 |
|
コンピュートプールの最大ノード数。 |
|
コンピュートプール内のノードのマシンタイプ。 |
|
コンピュートプールで実行されているサービスの数。 |
|
コンピュートプールで実行されているジョブの数。 |
|
Snowflakeがコンピュートプールを自動的に一時停止させるまでの非アクティブの秒数。 |
|
Snowflakeがサービスまたはジョブを開始したときに、コンピュートプールを自動的に再開するかどうか。 |
|
コンピュートプール内でアクティブな（1つ以上のサービスまたはジョブが実行されている）ノードの数。 |
|
アイドル状態（サービスやジョブが実行されていない）のコンピュートプールのノード数。 |
|
Snowflakeがコンピューティングプールのターゲットとしているノード数を示します。 以下の例は、 例1： CREATE COMPUTE POOL コマンドで、MIN_NODES=1、MAX_NODES=3を指定したとします。 Snowflakeがノードをプロビジョニングしている間、最初は Snowflakeが1つのノードをプロビジョニングした後、 例2: Snowflakeは、自動スケーリングや最小ノード数の変更（ALTER COMPUTE POOL ... SET MIN_NODES）が原因で、既存のコンピューティングプールにノードの追加を試みる場合があります。 Snowflakeがノードをプロビジョニングしている間、 たとえば、 |
|
コンピュートプールが作成された日時。 |
|
一時停止されたコンピュートプールが再開された日時。 |
|
ALTER COMPUTE POOL を使用してコンピュートプールが更新された日時。 |
|
コンピュートプールを所有するロール。 |
|
コンピュートプールのコメントを指定します。 |
|
コンピューティングプールがSnowflake Native App専用に作成される場合は |
|
コンピューティングプールがブアプリ専用に作成される場合は、Snowflake Native Appの名前。それ以外の場合は、 NULL。 |
|
コンピューティングプールのクレジット使用状況をモニターする 予算 の名前。 |
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。
このコマンドの出力を後処理するには、 パイプ演算子 （
->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。このコマンドの出力列名は小文字で生成されます。パイプ演算子または でこのコマンドの結果セットを消費する場合 RESULT_SCAN 関数の場合は、を使用します 二重引用符で囲まれた識別子 クエリの列名に を使用し、スキャンされた出力の列名と一致するようにします。たとえば、出力列の名前が次の場合
type``次に を指定します ``"type"識別子用。
コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。
1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。
例¶
次のコマンドは、現在のアカウントでアクセス権限を持っているコンピュートプールをリストします。
SHOW COMPUTE POOLS;
次のコマンドは、1つのコンピュートプールをリストします。
SHOW COMPUTE POOLS LIMIT 1;
次のコマンドは、名前に「tu」が含まれるコンピュートプールをリストします。
SHOW COMPUTE POOLS LIKE '%tu%';
次のコマンドは、名前に「my_pool」が含まれる2つのコンピュートプールをリストします。
SHOW COMPUTE POOLS LIKE '%my_pool%' LIMIT 2;
サンプル出力:
+-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------+
| name | state | min_nodes | max_nodes | instance_family | num_services | num_jobs | auto_suspend_secs | auto_resume | active_nodes | idle_nodes | target_nodes | created_on | resumed_on | updated_on | owner | comment | is_exclusive | application | budget |
|-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------|
| TUTORIAL_COMPUTE_POOL | ACTIVE | 1 | 1 | CPU_X64_XS | 3 | 0 | 3600 | true | 1 | 0 | 1 | 2024-02-24 20:41:31.978 -0800 | 2024-08-08 11:27:01.775 -0700 | 2024-08-18 13:47:08.150 -0700 | TEST_ROLE | NULL | false | NULL | NULL |
| TUTORIAL_COMPUTE_POOL_2 | SUSPENDED | 1 | 1 | CPU_X64_XS | 0 | 0 | 3600 | true | 0 | 0 | 0 | 2024-01-15 21:23:09.744 -0800 | 2024-04-06 15:24:50.541 -0700 | 2024-08-18 13:46:08.110 -0700 | ACCOUNTADMIN | NULL | false | NULL | NULL |
+-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------+
代替インターフェイス¶
Snowflake REST APIs
コンピューティングプールをリストする エンドポイント
Snowflake Python APIs
Snowflake CLI
snow object list コマンド