DESCRIBE COMPUTE POOL

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

DESCRIBE は DESCに短縮できます。

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

CREATE COMPUTE POOLALTER COMPUTE POOLDROP COMPUTE POOLSHOW 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つ以上のサービスまたはジョブが実行されている)ノードの数。

created_on

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

resumed_on

中断されたコンピューティングプールが再開された日時。

updated_on

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

owner

コンピューティングプールを所有するロール。

comment

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

アクセス制御の要件

この 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 | created_on                    | resumed_on                    | updated_on                    | owner        | comment |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------|
| TUTORIAL_COMPUTE_POOL | ACTIVE |         1 |         1 | CPU_X64_XS      |            1 |        0 |                 0 | false       |            1 |          0 | 2023-05-01 11:42:20.323 -0700 | 2023-05-01 11:42:20.326 -0700 | 2023-08-27 17:35:52.761 -0700 | ACCOUNTADMIN | NULL    |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+