스키마:: ACCOUNT_USAGE

WAREHOUSE_EVENTS_HISTORY 뷰¶

참고

이 뷰는 2024_04 동작 변경 번들 과 함께 일반 공급(GA)으로 제공됩니다. GA 기능을 사용하려면 2024_04 동작 변경 번들을 계정에서 비활성화하면 안 됩니다. 뷰 변경 사항에 대한 자세한 내용은 WAREHOUSE_EVENTS_HISTORY 뷰(ACCOUNT_USAGE): 새 열 및 이벤트 변경 사항 섹션을 참조하십시오.

이 Account Usage 뷰는 지난 365일(1년) 동안 계정의 단일 클러스터 및 다중 클러스터 웨어하우스에 대해 트리거된 이벤트를 반환하는 데 사용할 수 있습니다.

지원되는 이벤트는 다음과 같습니다.

웨어하우스 크기 조정을 포함하여 웨어하우스 생성, 삭제 또는 변경.
웨어하우스 재개 또는 일시 중단.
웨어하우스(단일 클러스터 및 다중 클러스터 웨어하우스)에서의 클러스터 재개, 일시 중단 또는 크기 조정.
웨어하우스(다중 클러스터 웨어하우스만 해당)에서의 추가 클러스터 중지 또는 시작.

열¶

열 이름	데이터 타입	설명
TIMESTAMP	TIMESTAMP_LTZ	이벤트가 트리거된 타임스탬프입니다.
WAREHOUSE_ID	NUMBER	계정의 웨어하우스 이름에 해당하는 고유 웨어하우스 ID(Snowflake에서 할당)입니다.
WAREHOUSE_NAME	VARCHAR	계정에 있는 웨어하우스의 이름입니다.
CLUSTER_NUMBER	NUMBER	다중 클러스터 웨어하우스의 특정 클러스터에 대해 이벤트가 트리거된 경우, 이벤트가 트리거된 클러스터의 번호(1부터 시작)입니다. 이벤트가 웨어하우스의 모든 클러스터에 대해 트리거되었거나 단일 클러스터 웨어하우스에 적용할 수 없는 경우, NULL이 표시됩니다.
EVENT_NAME	VARCHAR	이벤트의 이름입니다. 가능한 값 목록은 EVENT_NAME 설명 섹션을 참조하십시오.
EVENT_REASON	VARCHAR	이벤트의 원인입니다. 가능한 값 목록은 EVENT_REASON 설명 섹션을 참조하십시오.
EVENT_STATE	VARCHAR	완료하는 데 시간이 걸릴 수 있는 이벤트 상태: STARTED 또는 COMPLETED.
USER_NAME	VARCHAR	이벤트를 시작한 사용자입니다.
ROLE_NAME	VARCHAR	이벤트가 시작될 때 세션에서 활성 상태였던 역할입니다.
QUERY_ID	VARCHAR	SQL 문의 내부/시스템 생성 식별자입니다.
SIZE	VARCHAR	이벤트 시점에 웨어하우스의 현재 크기입니다. 이 값은 WAREHOUSE_CONSISTENT 이벤트에만 사용할 수 있습니다. 그렇지 않으면 이 값은 NULL입니다.
CLUSTER_COUNT	NUMBER	이벤트 시점에 웨어하우스 클러스터의 수입니다. 이 값은 WAREHOUSE_CONSISTENT 이벤트에만 사용할 수 있습니다. 그렇지 않으면 이 값은 NULL입니다.

EVENT_NAME 설명¶

웨어하우스 관련 이벤트¶

다음 표에서는 웨어하우스 관련 이벤트에 대한 EVENT_NAME 열에 대해 유효한 값을 설명합니다.

EVENT_NAME

설명

CREATE_WAREHOUSE

새 웨어하우스 생성에 의해 트리거되며, 이는 사용자가 수동으로 웨어하우스를 만들 때, 또는 계정이 프로비저닝되고 기본 웨어하우스가 계정에서 자동으로 만들어질 때 발생할 수 있습니다.

클러스터 번호	없음(N/A)
이벤트 상태	COMPLETED 또는 STARTED
이벤트 이유	없음(N/A)

비용 영향: 클러스터가 INITIALLY_SUSPENDED = TRUE로 생성된 경우에는 영향이 없습니다. 그렇지 않은 경우, 모든 컴퓨팅 리소스가 웨어하우스에 프로비저닝되거나 웨어하우스가 문 처리를 시작할 때 측정이 시작됩니다(웨어하우스가 리소스가 완전히 프로비저닝되기 전에 문 처리를 시작하는 경우).

DROP_WAREHOUSE

기존 웨어하우스가 삭제될 때 트리거됩니다. 웨어하우스에서 현재 실행 중인 모든 쿼리가 중지되고 컴퓨팅 리소스가 해제됩니다.

클러스터 번호	없음(N/A)
이벤트 상태	COMPLETED 또는 STARTED
이벤트 이유	없음(N/A)

비용 영향: 현재 실행 중인 모든 쿼리가 완료된 후 웨어하우스의 컴퓨팅 리소스에 대한 측정이 중지됩니다.

ALTER_WAREHOUSE

웨어하우스 크기 조정을 포함하여 기존 웨어하우스의 속성이 변경될 때 트리거됩니다. 웨어하우스 크기가 조정되면 추가 RESIZE_WAREHOUSE 이벤트가 트리거됩니다. 이 이벤트는 RESUME_WAREHOUSE 또는 SUSPEND_WAREHOUSE 이벤트를 트리거할 수도 있습니다.

클러스터 번호	없음(N/A)
이벤트 상태	COMPLETED 또는 STARTED
이벤트 이유	없음(N/A)

비용 영향: ALTER 문에 의해 트리거되는 이벤트에 따라 달라집니다.

RESIZE_WAREHOUSE

웨어하우스의 크기를 변경하여 트리거되며, 이는 웨어하우스의 각 클러스터에서 컴퓨팅 리소스를 늘리거나 줄입니다. 실행 중인 웨어하우스의 경우, 이 이벤트는 웨어하우스의 각 클러스터에 대해 RESIZE_CLUSTER 이벤트도 트리거합니다.

클러스터 번호	없음(N/A)
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_RESIZE

비용 영향: 실행 중인 웨어하우스의 크기를 조정하면 웨어하우스의 각 클러스터에 리소스가 추가되거나 제거됩니다. 새로 추가된 리소스는 프로비저닝되는 시점에 측정이 시작됩니다. 제거된 리소스는 현재 실행 중인 쿼리를 모두 처리한 후 측정을 중지합니다.

일시 중단된 웨어하우스의 크기를 조정해도 웨어하우스에 대한 새 리소스는 프로비저닝되지 않습니다.

RESUME_WAREHOUSE

일시 중단된 웨어하우스가 재개되거나 INITIALLY_SUSPENDED = FALSE로 새 웨어하우스가 만들어질 때 트리거됩니다. 또한, 이 이벤트는 웨어하우스의 각 클러스터에 대해 RESUME_CLUSTER 이벤트를 트리거합니다.

클러스터 번호	없음(모든 클러스터에 적용)
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_AUTORESUME 또는 WAREHOUSE_RESUME

비용 영향: 모든 컴퓨팅 리소스가 웨어하우스에 프로비저닝되면 측정이 시작됩니다.

SUSPEND_WAREHOUSE

실행 중인 웨어하우스가 일시 중단될 때 트리거됩니다. 또한, 이 이벤트는 웨어하우스의 각 클러스터에 대해 SUSPEND_CLUSTER 이벤트를 트리거합니다.

클러스터 번호	없음(모든 클러스터에 적용)
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_AUTOSUSPEND 또는 WAREHOUSE_SUSPEND

비용 영향: 실행 중인 모든 문이 완료된 후 웨어하우스의 컴퓨팅 리소스에 대한 측정이 중지됩니다.

WAREHOUSE_CONSISTENT

웨어하우스 완료에 대한 변경 사항이 보류 중일 때 트리거됩니다. 자세한 내용은 작업이 완료되었음을 나타내는 웨어하우스 이벤트 섹션을 참조하십시오.

클러스터 번호	NULL
이벤트 상태	COMPLETED
이벤트 이유	NULL

비용 영향: 없음. WAREHOUSE_CONSISTENT 이벤트 전에 STARTED 상태로 기록된 웨어하우스 이벤트에 대해 측정이 이루어집니다.

자세한 내용은 이전 행에 설명된 웨어하우스 이벤트의 비용 영향을 참조하십시오.

클러스터 관련 이벤트¶

다음 표에서는 클러스터 관련 이벤트에 대한 EVENT_NAME 열에 대해 유효한 값을 설명합니다.

EVENT_NAME

설명

RESUME_CLUSTER

일시 중단된 클러스터가 재개될 때 트리거됩니다.

클러스터 번호	재개된 클러스터의 번호(단일 클러스터 웨어하우스의 경우 항상 `1`)
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_AUTORESUME 또는 WAREHOUSE_RESUME(단일 클러스터 웨어하우스) MULTICLUSTER_SPINUP(멀티 클러스터 웨어하우스)

비용 영향: 클러스터의 컴퓨팅 리소스가 프로비저닝되면 측정이 시작됩니다.

SUSPEND_CLUSTER

실행 중인 클러스터가 일시 중단될 때 트리거됩니다.

클러스터 번호	일시 중단된 클러스터의 번호(단일 클러스터 웨어하우스의 경우 항상 `1`)
이벤트 상태	STARTED
이벤트 이유:	WAREHOUSE_AUTOSUSPEND 또는 WAREHOUSE_SUSPEND(단일 클러스터 웨어하우스) MULTICLUSTER_SPINDOWN(멀티 클러스터 웨어하우스) RESOURCE_MONITOR_SUSPEND

비용 영향: 현재 실행 중인 모든 쿼리가 완료된 후 클러스터의 컴퓨팅 리소스에 대한 측정이 중지됩니다.

RESIZE_CLUSTER

클러스터 크기가 조정될 때 트리거되며, 이는 일반적으로 웨어하우스 크기 조정의 결과로 일어납니다.

클러스터 번호	크기가 조정된 클러스터의 번호(단일 클러스터 웨어하우스의 경우 항상 `1`)
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_AUTORESUME 또는 WAREHOUSE_RESUME(단일 클러스터 웨어하우스) MULTICLUSTER_SPINDOWN 또는 MULTICLUSTER_SPINUP(다중 클러스터 웨어하우스) WAREHOUSE_RESIZE

비용 영향: 크기 조정으로 인해 컴퓨팅 리소스가 추가되거나 제거되는지 여부에 따라 다릅니다. 새로 추가된 리소스는 프로비저닝되는 시점에 측정이 시작됩니다. 제거된 리소스는 현재 실행 중인 쿼리를 모두 처리한 후 측정을 중지합니다.

SPINUP_CLUSTER

클러스터가 시작될 때 트리거됩니다(다중 클러스터 웨어하우스만 해당). 일반적으로 최소 또는 최대 클러스터 크기가 증가할 때 발생합니다.

클러스터 번호	시작된 클러스터의 수
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_RESIZE (단일 클러스터 웨어하우스) MULTICLUSTER_SPINUP(멀티 클러스터 웨어하우스)

비용 영향: 클러스터의 컴퓨팅 리소스가 프로비저닝되면 측정이 시작됩니다.

SPINDOWN_CLUSTER

실행 중인 클러스터가 종료될 때 트리거됩니다(다중 클러스터 웨어하우스만 해당). 일반적으로 최소 또는 최대 클러스터 크기가 감소할 때 발생합니다.

클러스터 번호	종료된 클러스터의 번호
이벤트 상태	STARTED
이벤트 이유	WAREHOUSE_RESIZE (단일 클러스터 웨어하우스) MULTICLUSTER_SPINDOWN(멀티 클러스터 웨어하우스)

비용 영향: 현재 실행 중인 모든 쿼리가 완료된 후 클러스터의 컴퓨팅 리소스에 대한 측정이 중지됩니다.

EVENT_REASON 설명¶

다음 표에서는 EVENT_REASON 열에 대해 유효한 값을 설명합니다.

EVENT_REASON	설명
WAREHOUSE_AUTORESUME	일시 중단된 웨어하우스가 자동으로 재개되었습니다. 웨어하우스에 대해 AUTO_RESUME이 사용되어 있고 SQL 문이 웨어하우스에 제출되었기 때문입니다.
WAREHOUSE_RESUME	일시 중단된 웨어하우스가 사용자에 의해 수동으로 재개되었습니다.
WAREHOUSE_AUTOSUSPEND	실행 중인 웨어하우스가 자동으로 일시 중단되었습니다. 웨어하우스에 대해 AUTO_SUSPEND가 사용되어 있고 AUTO_SUSPEND의 정의된 비활성 기간이 경과했기 때문입니다.
WAREHOUSE_SUSPEND	실행 중인 웨어하우스가 사용자에 의해 수동으로 일시 중단되었습니다.
WAREHOUSE_RESIZE	웨어하우스 크기가 조정되었습니다.
RESOURCE_MONITOR_SUSPEND	웨어하우스의 리소스 모니터에 대한 크레딧 할당량에 도달하여 웨어하우스가 일시 중단되었습니다.
MULTICLUSTER_SPINUP	다중 클러스터 웨어하우스에서 새로운 클러스터 또는 일시 중단된 클러스터가 프로비저닝되었습니다. 단일 클러스터 웨어하우스에는 적용되지 않습니다.
MULTICLUSTER_SPINDOWN	실행 중인 클러스터가 다중 클러스터 웨어하우스에서 종료되었습니다. 단일 클러스터 웨어하우스에는 적용되지 않습니다.

사용법 노트¶

뷰의 지연 시간은 최대 3시간이 될 수 있습니다.

이벤트는 관련 이벤트를 추가로 트리거하는 경우 뷰에 여러 행을 생성할 수 있습니다.
EVENT_REASON, USER_NAME, ROLE_NAME, QUERY_ID 열의 값은 WAREHOUSE_CONSISTENT 이벤트에 대해 NULL입니다.
WAREHOUSE_CONSISTENT 이벤트는 다른 웨어하우스 이벤트와 동일한 타임스탬프를 공유하므로 순서가 뒤바뀌어 목록에 표시될 수 있습니다.

작업이 완료되었음을 나타내는 웨어하우스 이벤트¶

웨어하우스를 생성하거나, 웨어하우스의 크기나 클러스터 수를 변경하거나, 웨어하우스를 일시 중단하는 이벤트는 원자적 작업이 아닙니다. 즉, 이러한 작업을 완전히 완료하려면 약간의 시간이 필요합니다.

예를 들어, ALTER WAREHOUSE … SUSPEND 문을 사용하여 웨어하우스가 일시 중단되는 경우 현재 웨어하우스에서 실행 중인 모든 쿼리가 완료(또는 시간 초과)되어야 일시 중단될 수 있습니다. 일부 경우에는 여러 웨어하우스 이벤트(예: 크기 조정 및 일시 중단)가 진행 중일 수 있습니다. 모든 웨어하우스 이벤트가 완료되면 웨어하우스는 일관적인 상태가 됩니다.

웨어하우스 이벤트 가 EVENT_STATE 열에 STARTED 상태로 기록된 경우 결코 COMPLETED 상태로 기록되지 않습니다. 대신, STARTED 상태로 기록된 이벤트에는 항상 후속 WAREHOUSE_CONSISTENT 이벤트가 뒤따릅니다. 여러 웨어하우스 이벤트가 STARTED 이벤트 상태로 기록되는 경우 해당 이벤트는 동일한 WAREHOUSE_CONSISTENT 이벤트로 병합됩니다.

웨어하우스 이벤트가 EVENT_STATE 열에서 COMPLETED 상태로 기록된 경우, 보류 중인 다른 이벤트가 STARTED 상태로 기록되지 않는 한 후속 WAREHOUSE_CONSISTENT 이벤트는 발생하지 않습니다.

예¶

지난주 이벤트 기록 보기¶

다음 문을 실행하여 지난주의 웨어하우스 my_wh 에 대한 이벤트 기록을 확인합니다.

SELECT timestamp, warehouse_name, cluster_number,
       event_name, event_reason, event_state,
       size, cluster_count
  FROM SNOWFLAKE.ACCOUNT_USAGE.WAREHOUSE_EVENTS_HISTORY
  WHERE warehouse_name = 'MY_WH'
  AND timestamp > DATEADD('day', -7, CURRENT_TIMESTAMP())
  ORDER BY timestamp DESC;

Copy

이벤트 기록 결과 예¶

보류 중인 변경 사항이 없는 문에 대한 이벤트 기록¶

보류 중인 추가 변경이 없는 경우 ALTER WAREHOUSE 문은 COMPLETED 상태로 기록됩니다. 예를 들어, 다음 문은 웨어하우스 my_wh 에 대한 설명을 업데이트합니다.

ALTER WAREHOUSE my_wh SET
  COMMENT = 'Updated comment for warehouse';

Copy

이 문은 WAREHOUSE_EVENTS_HISTORY 뷰에 다음과 같은 행을 생성합니다.

TIMESTAMP	WAREHOUSE_NAME	EVENT_NAME	EVENT_STATE	SIZE	CLUSTER_COUNT
2024-04-26 16:42:13.513 +0000	MY_WH	ALTER_WAREHOUSE	COMPLETED	NULL	NULL

WAREHOUSE_CONSISTENT 이벤트가 뒤따르는 문에 대한 이벤트 기록¶

ALTER WAREHOUSE 문으로 인해 웨어하우스 크기가 변경되면 추가 이벤트가 뒤따릅니다. 예를 들어, 웨어하우스 my_wh 의 크기를 조정합니다.

ALTER WAREHOUSE my_wh SET
  WAREHOUSE_SIZE = 'SMALL';

Copy

이 문은 WAREHOUSE_EVENTS_HISTORY 뷰에 다음과 같은 행을 생성합니다.

TIMESTAMP	WAREHOUSE_NAME	EVENT_NAME	EVENT_STATE	SIZE	CLUSTER_COUNT
2024-05-29 15:13:05.874 +0000	MY_WH	ALTER_WAREHOUSE	STARTED	NULL	NULL
2024-05-29 15:13:05.874 +0000	MY_WH	RESIZE_WAREHOUSE	STARTED	NULL	NULL
2024-05-29 15:13:06.036 +0000	MY_WH	WAREHOUSE_CONSISTENT	COMPLETED	SMALL	1
2024-05-29 15:13:06.036 +0000	MY_WH	RESIZE_CLUSTER	COMPLETED	NULL	NULL

Snowflake에서 시작된 웨어하우스 이벤트에 대한 이벤트 기록¶

Snowflake가 다중 클러스터 웨어하우스를 재개하면 다음 웨어하우스 이벤트가 기록됩니다.

TIMESTAMP	WAREHOUSE_NAME	EVENT_NAME	EVENT_STATE	SIZE	CLUSTER_COUNT
2024-04-23 17:04:11.618 +0000	MY_WH	SPINUP_CLUSTER	STARTED	NULL	NULL
2024-04-23 17:04:11.657 +0000	MY_WH	RESUME_CLUSTER	STARTED	NULL	NULL
2024-04-23 17:04:11.657 +0000	MY_WH	WAREHOUSE_CONSISTENT	COMPLETED	LARGE	5