DESCRIBE COMPUTE POOL

コンピュートプール のプロパティについて説明します。

DESCRIBE は DESC に短縮できます。

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

CREATE COMPUTE POOL、 ALTER COMPUTE POOL、 DROP COMPUTE POOL、 SHOW COMPUTE POOLS

構文

DESC[RIBE] COMPUTE POOL <name>
Copy

パラメーター

name

説明するコンピュートプールの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

出力

コマンド出力では、次の列にコンピュートプールのプロパティとメタデータが提供されます。

列

説明

name

コンピュートプール名。

state

コンピュートプールの現在の状態。

min_nodes

コンピュートプールの最小ノード数。

max_nodes

コンピュートプールの最大ノード数。

instance_family

コンピュートプール内のノードのマシンタイプを指定します。

num_services

コンピュートプールで実行されているサービスとジョブの数。

num_jobs

コンピュートプールで実行されているジョブの数。

auto_suspend_secs

コンピュートプールが自動的に一時停止されるまでの非アクティブの秒数を指定します。

auto_resume

Snowflakeがサービスまたはジョブを開始しようとしたときに、コンピューティングプールを自動的に再開するかどうかを指定します。

active_nodes

コンピュートプール内でアクティブな（1つ以上のサービスまたはジョブが実行されている）ノードの数。

idle_nodes

アイドル状態（サービスやジョブが実行されていない）のコンピューティングプールのノード数。

target_nodes

Snowflakeがコンピューティングプールのターゲットとしているノード数を示します。 active_nodes が target_nodes と等しくない場合、Snowflake はクラスタをオートスケールしてノードを追加または削除します。

以下の例は、 target_nodes 列の値をどのように解釈するかを示しています。

例1: CREATE COMPUTE POOL コマンドで、 MIN_NODES=1と MAX_NODES=3を指定したとします。

Snowflakeがノードをプロビジョニングしている間、最初は active_nodes と idle_nodes 列の値は0、 target_nodes 列の値は1です。（target_nodes 列の値は、 MIN_NODES パラメーターに指定した値と同じです。）これは、Snowflakeがプロビジョニングしているコンピューティングプールのノードが1つであることを示しています。

Snowflakeが1つのノードをプロビジョニングした後、 idle_nodes 列の値は1になります（サービスが実行されていないと仮定）。 target_nodes 列の値はまだ1であり、コンピューティングプールのノードが1つであることを示しています。

例2: Snowflakeは、自動スケーリングや最小ノード数の変更（ALTER COMPUTE POOL ... SET MIN_NODES）が原因で、既存のコンピューティングプールにノードの追加を試みる場合があります。

Snowflakeがノードをプロビジョニングしている間、 state 列の値は resizing です。Snowflakeが追加しているノードの数を確認するには、 target_nodes 列の値をチェックします。

たとえば、 active_nodes 列の値が1、 idle_nodes 列の値が0であり、 MIN_NODES プロパティを1から2に更新してコンピューティングプールのサイズを変更したとします。この場合、 target_nodes 列の値は2（コンピューティングプールにあるべきノード数）です。このことから、Snowflakeは1つの追加ノードをプロビジョニングしていると推測できます。

created_on

コンピュートプールが作成された日時。

resumed_on

一時停止されたコンピュートプールが再開された日時。

updated_on

ALTER COMPUTE POOL を使用してコンピュートプールが更新された日時。

owner

コンピュートプールを所有するロール。

comment

コンピュートプールのコメントを指定します。

is_exclusive

コンピューティングプールがSnowflake Native App専用に作成される場合は true、それ以外の場合は false。

application

コンピューティングプールがブアプリ専用に作成される場合は、Snowflake Native Appの名前。それ以外の場合は、 NULL。

budget

コンピューティングプールのクレジット使用状況をモニターする 予算 の名前。

error_code

STATUS_MESSAGE に関連するエラーコード（ある場合）。それ以外の場合、このフィールドは空です。たとえば、コンピューティングプールのサイズを変更する場合、

  • Snowflakeで容量エラー（新しいノードをプロビジョニングできない）が発生すると、Snowflakeはエラーコード392507を返します。

    容量エラーは、コンピューティングプールのノードにリクエストしたインスタンス型が、現在クラウドプロバイダーで利用できないことを示します。キャパシティが利用可能になるのを待つか、別のインスタンスファミリで新しいコンピューティングプールを作成することができます。

  • 保留中のサービス（ジョブサービスを含む）があり、Snowflakeがコンピューティングプールをスケールアップできない場合、Snowflakeはエラーコード392508を返します。

status_message

コンピューティングプールの状態に関するオプションのメッセージ。例:

  • コンピューティングプールを作成した後、 DESC COMPUTE POOL コマンドを実行すると、出力には「コンピューティングプールは1分前から始まっています」というステータスメッセージが含まれる場合があります。

  • ノードのプロビジョニング時にSnowflakeがキャパシティエラーに遭遇した場合、出力にはステータスメッセージが含まれることがあります。「コンピューティングプールは3分前から始まっています。We have observed CAPACITY_ERROR.」いうステータスメッセージが含まれる場合があります。

  • 保留中のサービス（ジョブサービスを含む）があり、Snowflakeがコンピューティングプールをスケールアップできない場合、出力には「Compute pool has reached the maximum node limit.Consider increasing max_nodes using the ALTER COMPUTE POOL command.」というステータスメッセージが含まれる場合があります。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

MONITOR

コンピューティングプール

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

例

次の例は、 tutorial_compute_pool という名前のコンピュートプールについて説明しています。

DESCRIBE COMPUTE POOL tutorial_compute_pool;
Copy

サンプル出力:

+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+
| 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 | error_code | status_message |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------|
| 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:29:08.124 -0700 | TEST_ROLE | NULL    | false        | NULL        | NULL   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+
言語: 日本語