SHOW COMPUTE POOLS

SHOW COMPUTE POOLS

SHOW COMPUTE POOLS 명령은 접근 권한(privilege)이 있는 계정의 컴퓨트 풀(compute pool) 목록을 보여주는 명령이에요. Snowpark Container Services 환경에서 실행 중인 컴퓨트 풀을 확인할 때 사용해요.

출처: 문서

본문

이 명령은 접근 권한이 있는 계정의 모든 컴퓨트 풀을 나열해요.

기능 상태: 일반 공급(Generally Available). Snowpark Container Services는 일부 예외를 제외하고 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요.

관련 명령: CREATE COMPUTE POOL, ALTER COMPUTE POOL, DESCRIBE COMPUTE POOL, DROP COMPUTE POOL, SHOW NODES IN COMPUTE POOL.

구문 (Syntax)

SHOW COMPUTE POOLS [ LIKE '<pattern>' ]
                   [ STARTS WITH '<name_string>' ]
                   [ LIMIT <ROWS> [ FROM '<name-string>' ] ]

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 필터는 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 예를 들어 ... LIKE '%testing%' ...와 ... LIKE '%TESTING%' ...는 같은 결과를 반환해요. 기본값: 없음 (필터링 없음).

  • STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 명령 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요. 예를 들어 ... STARTS WITH 'B' ...와 ... STARTS WITH 'b' ...는 서로 다른 결과를 반환해요. 기본값: 없음.

  • LIMIT <rows> [ FROM <name_string> ] — 반환되는 최대 행 수를 제한하면서 결과의 "페이지네이션(pagination)"을 가능하게 해요. 실제 반환되는 행 수는 지정한 제한보다 적을 수 있어요 (예: 기존 객체 수가 제한보다 적은 경우). 선택적 FROM '<name_string>' 하위 절은 결과의 "커서(cursor)" 역할을 해요. 객체 이름이 지정 문자열과 일치하는 첫 행 다음부터 지정한 개수의 행을 가져와요.

    • 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요.
    • 문자열이 반드시 전체 객체 이름을 포함할 필요는 없어요. 부분 이름도 지원돼요.
    • 기본값: 없음 (제한 없음).

    참고: STARTS WITH와 FROM 절을 모두 지원하는 SHOW 명령에서는 두 절을 같은 문장에서 결합할 수 있어요. 다만 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요. 또한 객체는 이름 기준 사전 순(lexicographic)으로 반환되므로 STARTS WITH 'A' LIMIT ... FROM 'B'는 결과가 없고, STARTS WITH 'B' LIMIT ... FROM 'A'는 결과를 반환해요 (일치하는 행이 있다면).

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 역할은 최소한 다음 권한 중 하나를 가져야 해요:

권한 (Privilege) 객체 (Object) 비고
OWNERSHIP, USAGE, MONITOR, OPERATE 중 하나 컴퓨트 풀

지정한 권한 집합으로 커스텀 역할을 만드는 방법은 커스텀 역할 만들기를 참고해요. 보안 객체에 SQL 작업을 수행하기 위한 역할·권한 부여에 대한 일반 정보는 Access Control 개요를 참고해요.

출력 (Output)

명령 출력은 컴퓨트 풀 속성과 메타데이터를 다음 컬럼으로 제공해요:

  • name — 컴퓨트 풀 이름.
  • state — 컴퓨트 풀 상태. 자세한 내용은 컴퓨트 풀 수명 주기 참고.
  • min_nodes — 컴퓨트 풀의 최소 노드 수.
  • max_nodes — 컴퓨트 풀의 최대 노드 수.
  • instance_family — 컴퓨트 풀 노드의 머신 유형.
  • num_services — 컴퓨트 풀에서 실행 중인 서비스 수.
  • num_jobs — 컴퓨트 풀에서 실행 중인 작업 수.
  • auto_suspend_secs — 비활성 후 Snowflake가 컴퓨트 풀을 자동으로 일시 중단하는 시간(초).
  • auto_resume — Snowflake가 서비스나 작업을 시작할 때 컴퓨트 풀을 자동으로 재개할지 여부.
  • active_nodes — 활성(하나 이상의 서비스·작업이 실행 중인) 노드 수.
  • idle_nodes — 유휴(서비스·작업 없음) 노드 수.
  • target_nodes — Snowflake가 컴퓨트 풀을 위해 목표로 하는 노드 수. target_nodes가 active_nodes와 같지 않으면 Snowflake가 클러스터를 자동 확장하여 노드를 추가·제거해요.
  • created_on — 컴퓨트 풀이 생성된 날짜·시간.
  • resumed_on — 일시 중단된 컴퓨트 풀이 재개된 날짜·시간.
  • updated_on — ALTER COMPUTE POOL로 컴퓨트 풀이 갱신된 날짜·시간.
  • owner — 컴퓨트 풀을 소유한 역할.
  • comment — 컴퓨트 풀에 대한 주석.
  • is_exclusive — 컴퓨트 풀이 Snowflake Native App 전용으로 생성되었으면 true, 아니면 false.
  • application — 컴퓨트 풀이 앱 전용으로 생성된 경우 해당 Snowflake Native App 이름. 아니면 NULL.
  • placement_group — 컴퓨트 풀 노드가 배치되는 장애 도메인(fault domain)을 지정해요. 장애 도메인은 클라우드 제공자의 가용 영역(availability zone)과 유사해요.
  • backup_instance_families — 컴퓨트 풀에 구성된 백업 인스턴스 패밀리의 정렬된 목록. 순서가 장애 시 우선순위를 결정해요. 백업 패밀리를 구성하지 않으면 NULL.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스(warehouse)를 요구하지 않아요.
  • 현재 사용자의 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN 역할과 SECURITYADMIN 역할 사용자만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요 (SHOW 출력 컬럼은 소문자이므로).
  • 명령은 역할의 접근 권한에 따라 지정 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개가 넘는 결과는 필터를 적용해도 반환되지 않아요.

예제 (Examples)

접근 권한이 있는 컴퓨트 풀을 나열하는 명령이에요:

SHOW COMPUTE POOLS;

컴퓨트 풀 하나를 나열하는 명령이에요:

SHOW COMPUTE POOLS LIMIT 1;

이름에 "tu"가 포함된 컴퓨트 풀을 나열하는 명령이에요:

SHOW COMPUTE POOLS LIKE '%tu%';

이름에 "my_pool"이 포함된 컴퓨트 풀을 2개 나열하는 명령이에요:

SHOW COMPUTE POOLS LIKE '%my_pool%' LIMIT 2;

더 알아보기 (Learn more)