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.」というステータスメッセージが含まれる場合があります。

アクセス制御の要件¶

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

権限	オブジェクト	注意
MONITOR	コンピューティングプール

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

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

使用上の注意¶

このコマンドの出力を後処理するには、パイプ演算子（->>）または 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.

例¶

次の例は、 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   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+