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`	활성 상태(하나 이상의 서비스 또는 작업이 실행 중임)인 컴퓨팅 풀의 노드 수입니다.
`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    |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+