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`	활성 상태(하나 이상의 서비스 또는 작업이 실행 중임)인 컴퓨팅 풀의 노드 수입니다.
`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가 추가 노드 하나를 프로비저닝하고 있다고 추론할 수 있습니다.
`created_on`	컴퓨팅 풀이 만들어진 날짜 및 시간입니다.
`resumed_on`	일시 중단된 컴퓨팅 풀이 재개된 날짜 및 시간입니다.
`updated_on`	ALTER COMPUTE POOL을 사용하여 컴퓨팅 풀이 업데이트된 날짜 및 시간입니다.
`owner`	컴퓨팅 풀을 소유하는 역할입니다.
`comment`	컴퓨팅 풀에 대한 설명을 지정합니다.
`is_exclusive`	컴퓨팅 풀이 Snowflake Native App 전용으로 생성된 경우 `false` 이고, 그렇지 않은 경우 `true` 입니다.
`application`	컴퓨팅 풀이 해당 앱에만 독점적으로 생성된 경우 Snowflake Native App의 이름입니다. 그렇지 않으면, NULL 입니다.
`budget`	컴퓨팅 풀의 크레딧 사용량을 모니터링하는 예산 의 이름입니다.
`error_code`	STATUS_MESSAGE와 관련된 오류 코드(있는 경우)입니다. 그렇지 않으면 이 필드는 비어 있습니다. 예를 들어, 컴퓨팅 풀의 크기를 조정할 때: Snowflake에서 용량 오류(새로운 노드를 프로비저닝할 수 없음)가 발생하면 Snowflake는 오류 코드 392507을 반환합니다. 용량 오류는 사용자가 컴퓨팅 풀 노드에 대해 요청한 인스턴스 유형을 현재 클라우드 공급자가 사용할 수 없음을 나타냅니다. 용량이 제공될 때까지 기다리거나 다른 인스턴스 패밀리로 새 컴퓨팅 풀을 만들 수 있습니다. (작업 서비스를 포함하여) 보류 중인 서비스가 있고 Snowflake에서 컴퓨팅 풀을 확장할 수 없는 경우, Snowflake는 오류 코드 392508을 반환합니다.
`status_message`	컴퓨팅 풀의 상태에 대한 선택적 메시지입니다. 예: 컴퓨팅 풀을 생성한 후 DESC COMPUTE POOL 명령을 실행하면 출력에 다음 상태 메시지가 포함될 수 있습니다. “Compute pool is starting for last 1 minute.” Snowflake에서 노드를 프로비저닝할 때 용량 오류가 발생하는 경우 출력에 다음 상태 메시지가 포함될 수 있습니다. “Compute pool is starting for the last 3 minutes. 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   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+