컴퓨트 풀 변경

컴퓨트 풀 변경 (ALTER COMPUTE POOL)

%spcs%는 AWS, Microsoft Azure, and Google Cloud Platform commercial regions의 계정에서 사용할 수 있어요. 단, 일부 예외가 있어요. 자세한 내용은 를 참고하세요.

기존 compute pool의 속성을 수정해요.

함께 보기:

CREATE COMPUTE POOL , DESCRIBE COMPUTE POOL, DROP COMPUTE POOL , SHOW COMPUTE POOLS , SHOW NODES IN COMPUTE POOL

출처: 문서

본문

구문

ALTER COMPUTE POOL [ IF EXISTS ]  { SUSPEND | RESUME }

ALTER COMPUTE POOL [ IF EXISTS ]  STOP ALL  [ OF TYPE  [ , ... ] ]

ALTER COMPUTE POOL [ IF EXISTS ]  SET [ MIN_NODES =  ]
                                            [ MAX_NODES =  ]
                                            [ AUTO_RESUME = { TRUE | FALSE } ]
                                            [ AUTO_SUSPEND_SECS =  ]
                                            [ PLACEMENT_GROUP = '' ]
                                            [ INSTANCE_FAMILY =  ]
                                            [ BACKUP_INSTANCE_FAMILIES = ( '' [ , ... ] ) ]
                                            [ TAG  = '' [ ,  = '' , ... ] ]
                                            [ COMMENT = '' ]

ALTER COMPUTE POOL [ IF EXISTS ]  UNSET { AUTO_SUSPEND_SECS         |
                                                AUTO_RESUME               |
                                                PLACEMENT_GROUP           |
                                                BACKUP_INSTANCE_FAMILIES  |
                                                COMMENT
                                              }
                                              [ , ... ]

매개변수

name

변경할 컴퓨트 풀의 식별자를 지정해요.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶인 식별자는 대소문자를 구분해요.

자세한 내용은 Identifier requirements를 참조하세요.

{ SUSPEND | RESUME }

컴퓨트 풀을 일시 중단하거나 이전에 일시 중단된 컴퓨트 풀을 다시 시작해요. 컴퓨트 풀을 일시 중단하면 Snowflake가 해당 컴퓨트 풀의 모든 서비스를 일시 중단하지만, 작업은 종료 상태(DONE 또는 FAILED)에 도달할 때까지 계속 실행된 후 컴퓨트 풀 노드가 해제돼요.

STOP ALL OF TYPE workload_type [ , ... ]

컴퓨트 풀에서 실행 중인 모든 서비스를 삭제하고 작업을 취소해요. 그러면 Snowflake가 컴퓨트 풀에서 모든 컨테이너를 제거해요. 선택적 OF TYPE 절을 지정하면 Snowflake는 지정된 워크로드 유형의 서비스만 중지해요. 사용 가능한 워크로드 유형 목록은 를 참조하세요.

필터는 대소문자를 구분하지 않아요.

SET ...

컴퓨트 풀에 대해 하나 이상의 지정된 속성 또는 매개변수를 설정해요:

MIN_NODES = num

컴퓨트 풀 노드의 최소 수를 지정해요.

MAX_NODES = num

컴퓨트 풀 노드의 최대 수를 지정해요.

AUTO_RESUME = { TRUE | FALSE }

서비스나 작업이 제출될 때 컴퓨트 풀을 자동으로 다시 시작할지 여부를 지정해요. AUTO_RESUME이 FALSE인 경우, 컴퓨트 풀에서 서비스나 작업을 시작하려면 먼저 ALTER COMPUTE POOL <name> RESUME을 사용하여 컴퓨트 풀을 명시적으로 다시 시작해야 해요.

AUTO_SUSPEND_SECS = num

Snowflake가 컴퓨트 풀을 자동으로 일시 중단하려는 비활성 시간(초)이에요. 비활성이란 컴퓨트 풀의 어떤 노드에서도 서비스와 작업이 실행되지 않는 상태를 의미해요.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

tag 이름과 태그 문자열 값을 지정해요.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자예요.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 를 참조하세요.

PLACEMENT_GROUP = placement_group_name

컴퓨트 풀의 placement group of the compute pool을 식별해요. SHOW COMPUTE POOLS 및 DESCRIBE COMPUTE POOL 명령을 사용하여 컴퓨트 풀이 배치 그룹에 할당된 내용을 확인할 수 있어요.

placement_group을 DISTRIBUTED로 설정할 수도 있어요. 이 경우 Snowflake는 사용 가능한 모든 배치 그룹에 컴퓨트 풀 노드를 분산하여 여러 배치 그룹에 걸쳐 균등한 분포를 유지하려고 해요. 그래서 그룹이 더 내결함성을 가지게 돼요. 자세한 내용은 을 참조하세요.

INSTANCE_FAMILY = instance_family_name

컴퓨트 풀의 노드에 프로비저닝하려는 머신 유형을 식별해요. 머신 유형은 컴퓨트 풀의 컴퓨팅 리소스 양을 결정하며, 따라서 컴퓨트 풀이 실행되는 동안 소비되는 크레딧 수를 결정해요. 사용 가능한 인스턴스 패밀리 이름 목록은 instance families를 참조하세요.

INSTANCE_FAMILY는 컴퓨트 풀이 완전히 일시 중단된 경우에만 변경할 수 있어요. 다시 시작하면 Snowflake가 새 인스턴스 유형을 사용하여 컴퓨트 풀을 프로비저닝해요.

BACKUP_INSTANCE_FAMILIES = ( 'instance_family_name' [ , ... ] )

컴퓨트 풀에 대한 백업 인스턴스 패밀리의 순서 목록을 설정하거나 교체해요. 이 변경은 풀 일시 중단이나 서비스 재시작 없이 즉시 적용되며, 다음 확장 이벤트에서 업데이트된 목록을 사용해요. 목록에는 최소 하나의 항목이 포함되어야 하고, 기본 INSTANCE_FAMILY나 중복 항목이 포함되어서는 안 되며, 유효한 인스턴스 패밀리 식별자를 사용해야 해요.

Snowflake는 워크로드 호환성을 검증하지 않아요. 호환성 요구 사항 및 선택 지침은 BACKUP_INSTANCE_FAMILIES in CREATE COMPUTE POOL을 참조하세요.

백업 인스턴스 유형에서 실행 중인 기존 노드는 즉시 영향을 받지 않아요. 유지 관리 기간이나 일상적인 노드 폐기 중에 기본 패밀리 노드로 교체돼요.

같은 ALTER 문에서 INSTANCE_FAMILY도 변경되는 경우, Snowflake는 새 기본 패밀리가 백업 목록에 없고 모든 항목이 유효한지 다시 검증해요.

자세한 내용은 Backup instance types를 참조하세요.

COMMENT = 'string_literal'

컴퓨트 풀에 대한 주석을 지정해요.

UNSET ...

컴퓨트 풀에 대해 설정 해제할 하나 이상의 속성 및/또는 매개변수를 지정해요. 그러면 기본값으로 재설정돼요. 자세한 내용은 CREATE COMPUTE POOL을 참조하세요:

• AUTO_SUSPEND_SECS
• AUTO_RESUME
• PLACEMENT_GROUP: 배치 그룹은 컴퓨트 풀이 완전히 일시 중단된 경우에만 설정 해제할 수 있어요.
• BACKUP_INSTANCE_FAMILIES: 풀을 단일 패밀리 동작으로 되돌려요. 기본 INSTANCE_FAMILY가 제약될 때 Snowflake는 더 이상 대체 인스턴스 유형을 시도하지 않아요. 백업 인스턴스 유형에서 이미 실행 중인 노드는 일상적인 노드 폐기 또는 유지 관리 기간을 통해 교체될 때까지 계속 실행돼요.
• COMMENT

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 role은 최소한 다음 privileges을 보유해야 해요:

---

권한	개체	참고
OPERATE	Compute pool	compute pool을 일시 중단하거나 다시 시작하려면 역할에 이 권한이 필요합니다.
MODIFY	Compute pool	compute pool을 변경하고 속성을 설정하려면 역할에 이 권한이 필요합니다.

지정된 권한 집합을 가진 사용자 지정 역할을 만드는 방법은 을(를) 참조하세요.

보안 개체(securable objects)에 대해 SQL 작업을 수행할 때 필요한 역할 및 권한 부여에 대한 일반적인 정보는 Overview of Access Control을(를) 참조하세요.

사용 참고 사항

• 메타데이터 관련:

  고객은 Snowflake 서비스를 사용할 때 메타데이터에 개인 데이터(User 개체의 경우 제외), 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터를 입력하지 않도록 해야 합니다. 자세한 내용은 Metadata fields in Snowflake을(를) 참조하세요.

예제

다음 예제는 compute pool에 MAX_NODES 및 AUTO_RESUME 속성을 설정합니다.

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE

다음 예제는 compute pool의 INSTANCE_FAMILY로 "CPU_X64_S"를 설정합니다. 인스턴스 패밀리를 변경하려면 compute pool을 중지해야 하므로, compute pool을 먼저 일시 중단합니다.

ALTER COMPUTE POOL tutorial_compute_pool SUSPEND;
ALTER COMPUTE POOL tutorial_compute_pool SET
  INSTANCE_FAMILY = CPU_X64_S;
ALTER COMPUTE POOL tutorial_compute_pool RESUME;

다음 예제는 기존 compute pool에 백업 인스턴스 패밀리를 구성합니다.

ALTER COMPUTE POOL my_compute_pool
  SET BACKUP_INSTANCE_FAMILIES = ('GEN_X64_G2_8');

다음 예제는 모든 백업 패밀리를 제거하여 compute pool을 단일 패밀리 동작으로 되돌립니다.

ALTER COMPUTE POOL my_compute_pool
  UNSET BACKUP_INSTANCE_FAMILIES;

---

더 알아보기 (Learn more)

• CREATE COMPUTE POOL
• DESCRIBE COMPUTE POOL
• DROP COMPUTE POOL
• SHOW COMPUTE POOLS
• SHOW NODES IN COMPUTE POOL