ALTER WAREHOUSE

ALTER WAREHOUSE

기존 가상 웨어하우스(virtual warehouse)의 속성을 수정하는 명령이에요.

출처: 문서

본문

관련 명령: CREATE WAREHOUSE, SHOW WAREHOUSES, DESCRIBE WAREHOUSE, DROP WAREHOUSE

구문 (Syntax)

ALTER WAREHOUSE [ IF EXISTS ] <name> { SUSPEND | RESUME [ IF SUSPENDED ] }

ALTER WAREHOUSE [ IF EXISTS ] <name> ABORT ALL QUERIES

ALTER WAREHOUSE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER WAREHOUSE [ IF EXISTS ] <name> SET
  [ { WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' | ADAPTIVE }
    | RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 } } ]
  [ WAREHOUSE_SIZE = <string_constant> ]
  [ MAX_CLUSTER_COUNT = <num> ]
  [ MIN_CLUSTER_COUNT = <num> ]
  [ SCALING_POLICY = { STANDARD | ECONOMY } ]
  [ AUTO_SUSPEND = <num> | NULL ]
  [ AUTO_RESUME = TRUE | FALSE ]
  [ RESOURCE_MONITOR = <monitor_name> ]
  [ COMMENT = '<string_literal>' ]
  [ MAX_CONCURRENCY_LEVEL = <num> ]
  [ STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num> ]
  [ STATEMENT_TIMEOUT_IN_SECONDS = <num> ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ ENABLE_QUERY_ACCELERATION = { TRUE | FALSE } ]
  [ QUERY_ACCELERATION_MAX_SCALE_FACTOR = <num> ]

ALTER WAREHOUSE [ IF EXISTS ] <name> UNSET {
                                       WAREHOUSE_TYPE            |
                                       RESOURCE_CONSTRAINT       |
                                       WAREHOUSE_SIZE            |
                                       MAX_CLUSTER_COUNT         |
                                       MIN_CLUSTER_COUNT         |
                                       SCALING_POLICY            |
                                       AUTO_SUSPEND              |
                                       AUTO_RESUME               |
                                       RESOURCE_MONITOR          |
                                       MAX_CONCURRENCY_LEVEL     |
                                       STATEMENT_QUEUED_TIMEOUT_IN_SECONDS  |
                                       STATEMENT_TIMEOUT_IN_SECONDS
                                       }
                                       [ ... ]
                                       , TAG <tag_name> [ , <tag_name> ... ]

ALTER WAREHOUSE [ IF EXISTS ] <name> { ENABLE | DISABLE } [ WAIT_FOR_COMPLETION = { TRUE | FALSE } ]

ALTER WAREHOUSE [ IF EXISTS ] <name> ADD TABLES ( <table_name>[ , ... ] )

ALTER WAREHOUSE [ IF EXISTS ] <name> DROP TABLES ( <table_name>[ , ... ] )

속성/파라미터 (Properties/parameters)

*name*

수정할 웨어하우스의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 해요. 큰따옴표로 감싼 식별자는 대소문자를 구분해요.

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

참고

웨어하우스 식별자는 다음에 따라 필요하거나 선택적이에요:

• 웨어하우스를 다시 시작/중단하거나 웨어하우스의 쿼리를 중단할 때, 현재 세션에서 웨어하우스가 사용 중이면 식별자를 생략할 수 있어요.

• 웨어하우스 이름을 바꾸거나 웨어하우스에서 다른 작업을 수행할 때는 식별자를 지정해야 해요.

{ SUSPEND | RESUME [ IF SUSPENDED ] }

웨어하우스에 수행할 작업을 지정해요:

• SUSPEND는 웨어하우스에서 모든 컴퓨트 노드를 제거하고 웨어하우스를 'Suspended' 상태로 전환해요.

• RESUME [ IF SUSPENDED ]는 컴퓨트 리소스를 프로비저닝해 중단된 웨어하우스를 사용 가능한 'Running' 상태로 전환해요.

선택 IF SUSPENDED 절은 이미 실행 중인 웨어하우스를 다시 시작할 때 ALTER WAREHOUSE 명령이 성공적으로 완료되는지 여부를 지정해요:

• 생략하면 웨어하우스가 이미 실행 중이면 명령이 실패하고 오류를 반환해요.

• 지정하면 웨어하우스가 실행 중인지 여부와 무관하게 명령이 성공적으로 완료돼요.

{ ENABLE | DISABLE }

적응형 웨어하우스(Adaptive Warehouse)를 활성화하거나 비활성화해요. WAREHOUSE_TYPE이 ADAPTIVE일 때만 적용돼요.

• ENABLE는 웨어하우스가 실행을 위해 새 작업을 받아들일 수 있게 해요.

• DISABLE는 웨어하우스에 제출된 새 작업을 거부해요. 웨어하우스에서 이미 실행 중인 쿼리는 완료까지 계속 실행될 수 있어요.

자세한 내용은 Enable or disable an Adaptive Warehouse를 참고하세요.

ABORT ALL QUERIES

웨어하우스에서 현재 실행 중이거나 대기 중인 모든 쿼리를 중단해요.

RENAME TO *new_name*

웨어하우스의 새 식별자를 지정해요. 계정 내에서 고유해야 해요.

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

SET ...

웨어하우스에 대해 설정할 속성/파라미터 하나 이상을 지정해요(공백, 쉼표 또는 새 줄로 구분).

참고

인터랙티브 웨어하우스(interactive warehouse)에는 일부 속성만 적용돼요. 사용할 수 있는 속성 목록은 CREATE INTERACTIVE WAREHOUSE를 참고하세요.

WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' | ADAPTIVE }

웨어하우스 유형을 지정해요.

유효한 값:

• STANDARD, 'STANDARD'

• 'SNOWPARK-OPTIMIZED'

• ADAPTIVE, 'ADAPTIVE'

기본값:

STANDARD

참고

• 하이픈이 포함된 값('SNOWPARK-OPTIMIZED')을 사용하려면 표시된 대로 값을 작은따옴표로 감싸야 해요.

• 적응형 웨어하우스에는 ADAPTIVE를 사용해요. 지원되는 속성은 SQL reference를 참고하세요.

WAREHOUSE_SIZE = *string_constant*

가상 웨어하우스의 크기를 지정해요. 크기는 각 클러스터의 컴퓨트 리소스 양, 따라서 웨어하우스가 실행되는 동안 소비되는 크레딧 수를 결정해요.

자세한 내용은 Resizing a warehouse를 참고하세요.

유효한 값:

• XSMALL, 'X-SMALL'

• SMALL

• MEDIUM

• LARGE

• XLARGE, 'X-LARGE'

• XXLARGE, X2LARGE, '2X-LARGE'

• XXXLARGE, X3LARGE, '3X-LARGE'

• X4LARGE, '4X-LARGE'

• X5LARGE, '5X-LARGE'

• X6LARGE, '6X-LARGE'

기본값:

XSMALL

참고

• Snowpark 최적화 웨어하우스의 기본 크기는 MEDIUM이에요.

• Snowpark 최적화 웨어하우스의 X5LARGE와 X6LARGE 크기는 MEMORY_16X 리소스 제약에서만 지원돼요.

• X5LARGE와 X6LARGE 크기는 STANDARD_GEN_2 리소스 제약을 사용하는 표준 웨어하우스에서는 지원되지 않아요.

• 하이픈이 포함된 값(예: '2X-LARGE')을 사용하려면 표시된 대로 값을 작은따옴표로 감싸야 해요.

• 크기 조정이 완료될 때까지 ALTER WAREHOUSE 명령의 즉시 반환을 차단하려면 WAIT_FOR_COMPLETION 파라미터를 추가해요.

• MAX_CLUSTER_COUNT 속성의 상한은 웨어하우스 크기에 따라 달라져요. WAREHOUSE_SIZE를 MEDIUM보다 높은 값으로 변경할 때는 동시에 MAX_CLUSTER_COUNT를 줄여야 할 수 있어요. 각 웨어하우스 크기의 MAX_CLUSTER_COUNT 상한은 Upper limit on number of clusters for a multi-cluster warehouse를 참고하세요.

• 더 큰 웨어하우스 크기인 5X-Large와 6X-Large는 모든 Amazon Web Services(AWS) 및 Microsoft Azure 리전에서 일반 제공돼요.

더 큰 웨어하우스 크기는 미국 정부 리전에서 프리뷰 상태예요(ARM에서 FIPS 지원 필요).

GENERATION = { '1' | '2' }

표준 웨어하우스의 웨어하우스 세대를 지정해요. 이 파라미터는 RESOURCE_CONSTRAINT = STANDARD_GEN_1 또는 STANDARD_GEN_2를 사용하는 대신 웨어하우스 세대를 설정하는 간단한 방법을 제공해요.

유효한 값:

• '1': 세대 1 컴퓨트 리소스를 사용해요. RESOURCE_CONSTRAINT = STANDARD_GEN_1과 동일해요.

• '2': 세대 2 컴퓨트 리소스를 사용해요. RESOURCE_CONSTRAINT = STANDARD_GEN_2와 동일해요.

기본값:

'2'(세대 2 컴퓨트 리소스)

참고

• 값은 작은따옴표로 감싸야 해요(예: '1'이지 1이 아님).

• 표준 웨어하우스의 경우 기본값은 클라우드 서비스 제공자 리전의 Gen2 지원 여부와 조직이 해당 리전에서 Gen2 지원이 가능해진 시점 이후에 만들어졌는지 여부에 따라 달라져요. 자세한 내용은 Default value for the GENERATION for standard warehouses를 참고하세요.

• GENERATION은 표준 웨어하우스(WAREHOUSE_TYPE = STANDARD)에만 적용돼요.

• GENERATION과 RESOURCE_CONSTRAINT가 모두 지정되면 불일치는 오류를 일으켜요.

• Snowpark 최적화 웨어하우스나 메모리 기반 리소스 제약에서는 GENERATION을 사용할 수 없어요.

RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 }

프리뷰 기능 — 공개

1 TB 리소스 제약(MEMORY_64X 및 MEMORY_64X_x86)은 프리뷰 기능으로 사용할 수 있어요. 1 TB 제약은 Amazon Web Services(AWS) 클라우드 플랫폼에서만 사용할 수 있어요.

다른 모든 MEMORY_* 리소스 제약 크기는 일반 제공이며 모든 클라우드 플랫폼에서 사용할 수 있어요.

Snowpark 최적화 웨어하우스의 메모리와 CPU 아키텍처, 또는 표준 웨어하우스의 세대 1 또는 세대 2 기능을 지정해요.

다음 표는 속성의 유효한 값, 사용 가능한 메모리, CPU 아키텍처, resource_constraint 설정에 필요한 최소 웨어하우스 크기를 포함해요. 세대 2 표준 웨어하우스를 사용할 수 있는 리전과 클라우드 서비스 제공자에 대한 자세한 내용은 Snowflake generation 2 standard warehouses를 참고하세요.

유효한 값:

Value	Memory (up to)	CPU architecture	Min warehouse size required	Max warehouse size
STANDARD_GEN_1	16 GB	Standard	XSMALL	X6LARGE
STANDARD_GEN_2	16 GB	Standard (generation 2)	XSMALL	X4LARGE
MEMORY_1X	16 GB	Standard	XSMALL	X4LARGE
MEMORY_1X_x86	16 GB	x86	XSMALL	X4LARGE
MEMORY_16X	256 GB	Standard	MEDIUM	X6LARGE
MEMORY_16X_x86	256 GB	x86	MEDIUM	X4LARGE
MEMORY_64X	1 TB	Standard	LARGE	X4LARGE
MEMORY_64X_x86	1 TB	x86	LARGE	X4LARGE

기본값:

Snowpark 최적화 웨어하우스의 경우 MEMORY_16X. 표준 웨어하우스의 경우 기본값은 클라우드 서비스 제공자 리전의 Gen2 지원 여부와 조직이 해당 리전에서 Gen2 지원이 가능해진 시점 이후에 만들어졌는지 여부에 따라 달라져요. 자세한 내용은 Default value for the GENERATION for standard warehouses를 참고하세요.

팁

표준 웨어하우스의 경우 STANDARD_GEN_1과 STANDARD_GEN_2 값 대신 GENERATION 파라미터 사용을 고려해요. GENERATION 파라미터는 웨어하우스 세대를 지정하는 더 간단한 방법을 제공해요. GENERATION = '2' 또는 GENERATION = '1'을 지정해요. 세대 번호 주위에 따옴표가 필요해요.

WAIT_FOR_COMPLETION = { TRUE | FALSE }

웨어하우스 크기를 조정할 때 이 파라미터를 사용해 크기 조정이 모든 컴퓨트 리소스를 프로비저닝할 때까지 ALTER WAREHOUSE 명령의 반환을 차단할 수 있어요. 더 큰 웨어하우스로 크기를 조정할 때 명령 반환을 차단하면 컴퓨트 리소스가 완전히 프로비저닝되었고 웨어하우스가 이제 모든 새 리소스로 쿼리를 실행할 준비가 되었음을 알려줘요.

유효한 값:

• TRUE: ALTER WAREHOUSE 명령이 웨어하우스 크기 조정이 완료될 때까지 차단돼요.

• FALSE: ALTER WAREHOUSE 명령이 웨어하우스 크기 조정이 완료되기 전에 즉시 반환돼요.

기본값:

FALSE

참고

• 이 파라미터의 값은 영속되지 않으며, 이 명령이 반환되기 전에 웨어하우스 크기 조정이 완료되기를 원하면 매 실행마다 TRUE로 설정해야 해요.

• TRUE로 설정하고 ALTER WAREHOUSE 명령을 중단하면 대기만 중단되고 웨어하우스 크기 조정은 진행돼요. 웨어하우스를 원래 크기로 되돌리려면 또 다른 ALTER WAREHOUSE 명령을 실행해야 해요.

• 이 파라미터는 WAREHOUSE_SIZE 파라미터와 함께 사용해야 해요. 그렇지 않으면 예외가 발생해요.

MAX_CLUSTER_COUNT = *num*

멀티 클러스터 웨어하우스의 최대 클러스터 수를 지정해요. 단일 클러스터 웨어하우스의 경우 이 값은 항상 1이에요.

유효한 값:

웨어하우스 크기에 따라 달라지는 상한까지 1.

값이 1보다 크면 멀티 클러스터 웨어하우스임을 나타내지만, 값은 Snowflake Enterprise Edition(이상)에서만 더 높은 값으로 설정할 수 있다는 점에 유의하세요.

• MAX_CLUSTER_COUNT 속성의 상한은 웨어하우스 크기에 따라 달라져요. WAREHOUSE_SIZE를 MEDIUM보다 높은 값으로 변경할 때는 동시에 MAX_CLUSTER_COUNT를 줄여야 할 수 있어요. 각 웨어하우스 크기의 MAX_CLUSTER_COUNT 상한은 Upper limit on number of clusters for a multi-cluster warehouse를 참고하세요.

멀티 클러스터 웨어하우스에 대한 자세한 내용은 Multi-cluster warehouses를 참고하세요.

기본값:

1(단일 클러스터 웨어하우스)

팁

Snowflake Enterprise Edition(이상)의 경우 (멀티 클러스터) 웨어하우스의 고가용성과 최적 성능을 유지하기 위해 항상 1보다 큰 값으로 설정하는 것을 권장해요. 이는 클러스터가 실패할 드문 경우에도 연속성을 보장하는 데도 도움이 돼요.

MIN_CLUSTER_COUNT = *num*

멀티 클러스터 웨어하우스의 최소 클러스터 수를 지정해요.

유효한 값:

MAX_CLUSTER_COUNT의 값까지 1. MAX_CLUSTER_COUNT의 상한은 웨어하우스 크기에 따라 달라져요.

MIN_CLUSTER_COUNT는 MAX_CLUSTER_COUNT보다 같거나 작아야 해요:

• 두 파라미터가 같으면 웨어하우스는 Maximized 모드로 실행돼요.

• MIN_CLUSTER_COUNT가 MAX_CLUSTER_COUNT보다 작으면 웨어하우스는 Auto-scale 모드로 실행돼요.

각 웨어하우스 크기의 상한을 포함한 자세한 내용은 Multi-cluster warehouses를 참고하세요.

기본값:

1

SCALING_POLICY = { STANDARD | ECONOMY }

Auto-scale 모드로 실행되는 멀티 클러스터 웨어하우스에서 클러스터를 자동으로 시작하고 종료하는 정책을 지정하는 객체 파라미터예요.

이 파라미터에 대한 자세한 설명은 Setting the scaling policy for a multi-cluster warehouse를 참고하세요.

AUTO_SUSPEND = { *num* | NULL }

비활성 상태 후 웨어하우스가 자동으로 중단되는 시간(초)을 지정해요.

유효한 값:

0 이상의 모든 정수, 또는 NULL:

• 웨어하우스를 중단하는 백그라운드 프로세스는 약 30초마다 실행되므로 이 속성의 설정은 웨어하우스 중단을 정밀하게 제어하기 위한 것이 아니에요.

• 30보다 작은 값이나 30의 배수가 아닌 값을 설정하는 것은 허용되지만, 웨어하우스 중단을 위한 30초 폴링 간격 때문에 예상된 동작이 나오지 않을 수 있어요.

• 0 또는 NULL 값을 설정하면 웨어하우스가 절대 중단되지 않아요.

기본값:

600(웨어하우스는 10분 비활성 후 자동으로 중단됨)

중요

AUTO_SUSPEND를 0이나 NULL로 설정하는 것은, 쿼리 워크로드가 지속 실행되는 웨어하우스를 요구하지 않는 한 권장하지 않아요. 특히 더 큰 웨어하우스에서 상당한 크레딧 소비(및 해당 요금)를 초래할 수 있다는 점에 유의하세요.

자세한 내용은 Warehouse considerations를 참고하세요.

AUTO_RESUME = { TRUE | FALSE }

SQL 문(예: 쿼리)이 제출될 때 웨어하우스를 자동으로 다시 시작할지 여부를 지정해요. FALSE이면 웨어하우스는 ALTER WAREHOUSE 또는 Snowflake 웹 인터페이스를 통해 명시적으로 다시 시작될 때만 시작돼요.

유효한 값:

• TRUE: 새 쿼리가 제출되면 웨어하우스가 다시 시작돼요.

• FALSE: 웨어하우스는 ALTER WAREHOUSE 또는 Snowflake 웹 인터페이스를 통해 명시적으로 다시 시작될 때만 다시 시작돼요.

기본값:

TRUE(SQL 문이 제출되면 웨어하우스가 자동으로 다시 시작됨)

INITIALLY_SUSPENDED = { TRUE | FALSE } 웨어하우스를 수정할 때는 적용되지 않아요.

RESOURCE_MONITOR = *monitor_name*

웨어하우스에 명시적으로 할당된 리소스 모니터(resource monitor)의 식별자를 지정해요. 리소스 모니터가 웨어하우스에 명시적으로 할당되면 모니터는 웨어하우스(및 모니터가 할당된 다른 모든 웨어하우스)가 사용하는 월별 크레딧을 제어해요.

유효한 값:

기존 리소스 모니터.

자세한 내용은 Working with resource monitors를 참고하세요.

기본값:

값 없음(웨어하우스에 할당된 리소스 모니터 없음)

팁

모든 리소스 모니터와 그 식별자를 보려면 SHOW RESOURCE MONITORS 명령을 사용해요.

COMMENT = '*string_literal*'

웨어하우스에 주석을 추가하거나 기존 주석을 덮어써요.

MAX_CONCURRENCY_LEVEL = *num*

웨어하우스 클러스터가 실행하는 SQL 문(즉 쿼리와 DML)의 동시성 수준을 지정하는 객체 파라미터예요. 수준에 도달하면:

• 단일 클러스터 웨어하우스 또는 (Maximized 모드의) 멀티 클러스터 웨어하우스의 경우 추가 문은 리소스가 사용 가능해질 때까지 대기열에 들어가요.

• (Auto-scale 모드의) 멀티 클러스터 웨어하우스의 경우 추가 클러스터가 시작돼요.

이 파라미터는 STATEMENT_QUEUED_TIMEOUT_IN_SECONDS와 함께 사용해 웨어하우스가 결코 백로그되지 않도록 보장할 수 있어요.

이 파라미터에 대한 자세한 설명은 MAX_CONCURRENCY_LEVEL을 참고하세요.

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = *num*

SQL 문(쿼리, DDL, DML 등)이 시스템에 의해 취소되기 전에 웨어하우스에서 대기열에 있을 수 있는 시간(초)을 지정하는 객체 파라미터예요.

이 파라미터는 MAX_CONCURRENCY_LEVEL과 함께 사용해 웨어하우스가 결코 백로그되지 않도록 보장할 수 있어요.

이 파라미터에 대한 자세한 설명은 STATEMENT_QUEUED_TIMEOUT_IN_SECONDS를 참고하세요.

STATEMENT_TIMEOUT_IN_SECONDS = *num*

실행 중인 SQL 문(쿼리, DDL, DML 등)이 시스템에 의해 취소되는 시간(초)을 지정하는 객체 파라미터예요.

이 파라미터에 대한 자세한 설명은 STATEMENT_TIMEOUT_IN_SECONDS를 참고하세요.

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

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

태그 값은 항상 문자열이고 태그 값의 최대 문자 수는 256이에요.

문에서 태그를 지정하는 방법에 대한 정보는 Tag quotas를 참고하세요.

ENABLE_QUERY_ACCELERATION = { TRUE | FALSE }

컴퓨트 리소스에 대해 이 웨어하우스에 의존하는 쿼리에 쿼리 가속 서비스(query acceleration service)를 활성화할지 여부를 지정해요.

Enterprise Edition 기능

쿼리 가속 서비스는 Enterprise Edition(이상)이 필요해요. 업그레이드를 문의하려면 Snowflake Support에 연락하세요.

유효한 값:

• TRUE는 쿼리 가속을 활성화해요.

• FALSE는 쿼리 가속을 비활성화해요.

기본값:

변경 없음. ALTER WAREHOUSE 문에서 이 파라미터를 생략하면 웨어하우스는 현재 설정을 유지해요.

웨어하우스를 만들 때의 기본값은 CREATE WAREHOUSE의 쿼리 가속 속성을 참고하세요.

QUERY_ACCELERATION_MAX_SCALE_FACTOR = *num*

쿼리 가속을 위해 컴퓨트 리소스를 임대하기 위한 최대 배율 인자(scale factor)를 지정해요. 배율 인자는 웨어하우스 크기를 기준으로 하는 승수로 사용돼요.

QUERY_ACCELERATION_MAX_SCALE_FACTOR를 0으로 설정하면 제한이 제거되어 쿼리가 쿼리 서비스를 처리하는 데 필요하고 사용 가능한 만큼 많은 리소스를 임대할 수 있게 돼요.

QUERY_ACCELERATION_MAX_SCALE_FACTOR 값과 무관하게 쿼리 가속에 사용할 수 있는 컴퓨트 리소스 양은 서비스에서 사용 가능한 리소스와 다른 동시 요청 수에 의해 제약을 받아요. 자세한 내용은 Adjusting the scale factor를 참고하세요.

유효한 값:

0~100

기본값:

8, 또는 Snowflake가 생성 시에 Gen2 또는 멀티 클러스터 웨어하우스에 대해 쿼리 가속을 자동으로 활성화할 때 2

UNSET ...

데이터베이스에 대해 설정 해제할 속성 및/또는 파라미터 하나(이상)를 지정하며, 기본값으로 재설정돼요:

• *property_name*

• *param_name*

• TAG *tag_name* [ , *tag_name* ... ]

단일 ALTER 문으로 여러 속성/파라미터를 재설정할 수 있어요. 다만 각 속성/파라미터는 쉼표로 구분해야 해요. 또한 속성/파라미터를 재설정할 때는 이름만 지정해요. 값은 필요하지 않아요.

참고

UNSET은 WAREHOUSE_SIZE를 제외한 웨어하우스의 모든 속성과 파라미터를 해제하는 데 사용할 수 있어요. WAREHOUSE_SIZE는 SET으로만 변경할 수 있어요.

UNSET DCM PROJECT

웨어하우스를 현재 관리하는 DCM 프로젝트에서 분리해요. 이 명령은 웨어하우스를 삭제하지 않고 웨어하우스와 DCM 프로젝트 사이의 연관을 제거해요. 자세한 내용은 Detach objects from a DCM project를 참고하세요.

프리뷰 기능 — 공개

모든 계정에서 사용할 수 있어요. 현재 이 기능은 Amazon Web Services(AWS)에서만 사용할 수 있어요.

ADD TABLES ( *table_name*[, ...] )

하나 이상의 인터랙티브 테이블을 인터랙티브 웨어하우스와 연결해요. 이 작업은 지정된 테이블에 대한 캐시 워밍(cache-warming) 프로세스를 시작해요.

참고

• 이 절은 INTERACTIVE 키워드로 만들어진 인터랙티브 웨어하우스에만 적용돼요.

• 인터랙티브 테이블이 이미 웨어하우스와 연결되어 있으면 명령은 성공하지만 효과가 없어요.

• 인터랙티브 테이블은 여러 인터랙티브 웨어하우스와 연결될 수 있어요.

• 캐시 워밍은 데이터 크기에 따라 상당한 시간이 걸릴 수 있어요.

*table_name*

웨어하우스와 연결할 인터랙티브 테이블의 식별자를 지정해요. 여러 테이블 이름을 쉼표로 구분해 지정할 수 있어요.

프리뷰 기능 — 공개

모든 계정에서 사용할 수 있어요. 현재 이 기능은 Amazon Web Services(AWS)에서만 사용할 수 있어요.

DROP TABLES ( *table_name*[, ...] )

하나 이상의 인터랙티브 테이블과 인터랙티브 웨어하우스의 연결을 제거해요. 이 작업은 지정된 테이블에 대한 캐시 사용을 중지하지만 테이블 자체는 삭제하지 않아요.

참고

• 이 절은 INTERACTIVE 키워드로 만들어진 인터랙티브 웨어하우스에만 적용돼요.

• 인터랙티브 테이블은 이 작업 후에도 계속 존재해요. 이 절은 DROP TABLE 작업을 수행하지 않아요.

*table_name*

웨어하우스에서 분리할 인터랙티브 테이블의 식별자를 지정해요. 여러 테이블 이름을 쉼표로 구분해 지정할 수 있어요.

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

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

Privilege	Object	Notes
APPLY	Tag	웨어하우스에 태그를 설정할 수 있게 해요.
MANAGE ATTACHED TABLES	Warehouse	인터랙티브 웨어하우스에서 ADD TABLES 및 DROP TABLES 절을 사용해 웨어하우스가 캐시하는 테이블을 관리할 수 있게 해요. 다른 웨어하우스 수정 작업은 부여하지 않아요. MODIFY 권한도 이 작업을 허가해요. 인터랙티브 웨어하우스에만 적용돼요.
MODIFY	Warehouse	크기 변경을 포함해 웨어하우스의 모든 속성을 수정할 수 있게 해요. 웨어하우스를 리소스 모니터에 할당하려면 필요해요. ACCOUNTADMIN 역할만 웨어하우스를 리소스 모니터에 할당할 수 있어요.
MONITOR	Warehouse	웨어하우스에서 실행된 현재·과거 쿼리와 해당 웨어하우스의 사용 통계를 볼 수 있게 해요.
OPERATE	Warehouse	웨어하우스 상태 변경(중지, 시작, 중단, 재개), 웨어하우스에서 실행된 현재·과거 쿼리 보기, 실행 중인 쿼리 중단을 가능하게 해요.
USAGE	Warehouse	가상 웨어하우스를 사용하고 그 결과로 웨어하우스에서 쿼리를 실행할 수 있게 해요. 웨어하우스가 SQL 문(예: 쿼리)이 제출될 때 자동 재개하도록 구성되어 있으면 웨어하우스가 자동으로 재개되고 문을 실행해요.

팁

전역 MANAGE WAREHOUSES 권한을 부여하는 것은 계정의 모든 웨어하우스에 MODIFY, MONITOR, OPERATE 권한을 부여하는 것과 동일해요. 이 권한을 웨어하우스 관리 목적을 포함하는 역할에 부여해 Snowflake 접근 제어 관리를 단순화할 수 있어요.

자세한 내용은 Delegating warehouse management를 참고하세요.

사용 참고사항 (Usage notes)

• 웨어하우스의 속성을 설정하거나 변경하기 위해 웨어하우스를 중단할 필요는 없어요. 웨어하우스가 실행 중에도 웨어하우스 유형과 리소스 제약 속성을 변경할 수 있어요.

• 웨어하우스 크기가 변경되면 그 변경은 현재 실행 중인 쿼리를 포함한 어떤 문에도 영향을 주지 않아요. 문이 완료되고 컴퓨트 리소스가 완전히 프로비저닝되면 새 크기가 이후의 모든 문에 사용돼요.

• 웨어하우스를 중단해도 중단 시점에 웨어하우스가 처리 중인 쿼리는 중단되지 않아요. 대신 웨어하우스는 쿼리를 완료한 다음 쿼리 처리에 사용된 컴퓨트 리소스를 종료해요. 이 기간 동안 웨어하우스는 quiescing 모드에 있어요. 모든 컴퓨트 리소스가 종료되면 웨어하우스 상태가 Suspended로 변경돼요.

• 메타데이터에 관해: 고객은 Snowflake 서비스를 사용할 때 메타데이터로 개인 데이터(User 객체 외), 민감 데이터, 수출 통제 데이터 또는 기타 규제 데이터를 입력하지 않도록 해야 해요. 자세한 내용은 Metadata fields in Snowflake를 참고하세요.

• Snowpark 최적화 가상 웨어하우스를 다시 시작하는 것은 표준 웨어하우스보다 오래 걸릴 수 있어요.

• Snowpark 최적화 웨어하우스는 쿼리 가속(Query Acceleration)을 지원하지 않아요.

• IF EXISTS 절을 지정하려면 사용 중인 역할 또는 활성 역할 계층의 역할이 웨어하우스에 적절한 웨어하우스 권한을 가지고 있어야 해요.

• ADD TABLES와 DROP TABLES 절은 INTERACTIVE 키워드로 만들어진 인터랙티브 웨어하우스에만 적용돼요. 이 절들은 표준 또는 Snowpark 최적화 웨어하우스에서는 사용할 수 없어요. 이 절들을 실행하려면 역할이 웨어하우스에 MANAGE ATTACHED TABLES 또는 MODIFY 권한이 있거나, 계정에 MANAGE WAREHOUSES 권한이 있어야 해요.

결제 및 가격 (Billing and pricing)

Snowpark 최적화 웨어하우스 크레딧 소비에 대한 정보는 Snowflake Service Consumption Table의 Table 1을 참고하세요.

인터랙티브 웨어하우스의 결제 및 가격 고려 사항에 대한 정보는 Cost and billing considerations를 참고하세요.

팁

RESOURCE_CONSTRAINT 속성 변경의 비용 영향에 대한 정보는 considerations for changing RESOURCE_CONSTRAINT while a warehouse is running or suspended를 참고하세요.

예제 (Examples)

웨어하우스 wh1을 wh2로 이름을 바꾸는 예제예요:

ALTER WAREHOUSE IF EXISTS wh1 RENAME TO wh2;

my_wh라는 웨어하우스를 다시 시작하고 실행 중에 웨어하우스 크기를 변경하는 예제예요:

ALTER WAREHOUSE my_wh RESUME;

ALTER WAREHOUSE my_wh SET warehouse_size=MEDIUM;

Snowpark 최적화 웨어하우스 so_warehouse의 메모리 리소스를 256GB로 수정하고 CPU 아키텍처를 x86으로 설정하는 예제예요:

ALTER WAREHOUSE so_warehouse SET
  RESOURCE_CONSTRAINT = 'MEMORY_16X_x86';

웨어하우스를 세대 2 컴퓨트 리소스를 사용하도록 변경하는 예제예요:

ALTER WAREHOUSE my_wh SET GENERATION = '2';

인터랙티브 테이블을 인터랙티브 웨어하우스와 연결하는 예제예요:

ALTER WAREHOUSE interactive_demo ADD TABLES (orders, customers);

인터랙티브 웨어하우스에서 인터랙티브 테이블을 제거하는 예제예요:

ALTER WAREHOUSE interactive_demo DROP TABLES (orders, customers);

더 알아보기 (Learn more)

CREATE WAREHOUSE, SHOW WAREHOUSES, DESCRIBE WAREHOUSE, DROP WAREHOUSE