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つ以上のサービスまたはジョブが実行されている）ノードの数。
`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    |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+