DESCRIBE COMPUTE POOL
DESCRIBE COMPUTE POOL
DESCRIBE COMPUTE POOL 명령은 컴퓨트 풀(compute pool)의 속성을 설명하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
본문
컴퓨트 풀의 속성을 설명하는 명령입니다. Feature — Generally Available — Snowpark Container Services는 일부 예외를 제외하고 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요. 자세한 내용은 Available regions and considerations 문서를 참고하세요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
관련 명령: CREATE COMPUTE POOL, ALTER COMPUTE POOL, DROP COMPUTE POOL, SHOW COMPUTE POOLS
Syntax
DESC[RIBE] COMPUTE POOL <name>
Parameters
name— 설명할 컴퓨트 풀의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements 문서를 참고하세요.
Output (출력)
명령 출력은 다음 컬럼으로 컴퓨트 풀 속성과 메타데이터를 제공해요.
target_nodes— Snowflake가 컴퓨트 풀에 대해 목표로 하는 노드 수를 나타내요.active_nodes가target_nodes와 같지 않으면 Snowflake는 노드를 추가하거나 제거하도록 클러스터를 자동 조정(autoscale)해요. 자세한 내용은 About the target_nodes compute pool property 문서를 참고하세요.placement_group— 컴퓨트 풀 노드가 배치되는 장애 도메인(fault domain)을 지정해요. 장애 도메인은 클라우드 공급자의 가용 영역(availability zone)과 유사해요. 자세한 내용은 Compute pool placement 문서를 참고하세요.error_code—STATUS_MESSAGE와 관련된 오류 코드(있는 경우)예요. 그 외에는 이 필드가 비어 있어요. 예를 들어 컴퓨트 풀 크기를 조정할 때: 용량 오류는 요청한 컴퓨트 풀 노드의 인스턴스 유형이 현재 클라우드 공급자에서 사용할 수 없음을 나타내요. 용량이 생길 때까지 기다리거나 다른 인스턴스 패밀리로 새 컴퓨트 풀을 만들 수 있습니다.status_message— 컴퓨트 풀 상태에 대한 선택적 메시지예요.
Access control requirements (접근 제어 요구 사항)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.
지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.
Examples (예제)
tutorial_compute_pool이라는 컴퓨트 풀을 설명하는 예시예요.
DESCRIBE COMPUTE POOL tutorial_compute_pool;
샘플 출력:
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+-----------------+
| 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 | placement_group |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+-----------------|
| 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 | | | A |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+-----------------+