WAREHOUSE_EVENTS_HISTORY 视图¶
此 Account Usage 视图可用于返回在过去 365 天（1 年）内账户中的单集群和多集群仓库触发的事件。
支持的事件包括：
创建、弃用或修改仓库，包括调整仓库大小。
恢复或暂停仓库。
恢复、暂停或调整仓库（单集群和多集群仓库）中的集群大小。
停止或启动仓库（仅限多集群仓库）中的其他集群。
列¶
列名称 |
数据类型 |
描述 |
|---|---|---|
TIMESTAMP |
TIMESTAMP_LTZ |
触发事件的时间戳。 |
WAREHOUSE_ID |
NUMBER |
与账户中的仓库名称相对应的唯一仓库 ID（由 Snowflake 分配）。 |
WAREHOUSE_NAME |
TEXT |
账户中仓库的名称。 |
CLUSTER_NUMBER |
NUMBER |
如果事件是针对多集群仓库中的特定集群触发的，则会显示事件触发时针对的集群的编号（从 1 开始计数）；如果该事件是针对仓库中的所有集群触发的，或者不适用于单集群仓库，则显示 NULL。 |
EVENT_NAME |
TEXT |
事件的名称。有关可能值的列表，请参阅 EVENT_NAME 描述 （本主题内容）。 |
EVENT_REASON |
TEXT |
事件的原因。有关可能值的列表，请参阅 EVENT_REASON 描述 （本主题内容）。 |
EVENT_STATE |
TEXT |
需要时间才能完成或可以取消的事件的状态：STARTED、COMPLETED、PARTIALLY_COMPLETED。 |
USER_NAME [1] |
TEXT |
发起事件的用户。 |
ROLE_NAME [1] |
TEXT |
事件发起时在会话中处于活动状态的角色。 |
QUERY_ID [1] |
TEXT |
内部/系统生成的 SQL 语句标识符。 |
[1] 这些字段仅显示从 2021 年 4 月 1 日起执行的查询的数据。
使用说明¶
视图的延迟时间最长可达 3 小时。
每个事件都可能在视图中生成多行，原因如下：
事件通常会触发其他相关事件。
事件可能需要一段时间才能完成，也可能被取消；如果发生这种情况，EVENT_STATE 列会指明该事件是已开始、已完成还是已取消。
EVENT_REASON 描述¶
- WAREHOUSE_AUTORESUME:
由于为仓库启用了 AUTO_RESUME 并且向仓库提交了 SQL 语句，暂停的仓库已自动恢复。
- WAREHOUSE_RESUME:
用户手动恢复了暂停的仓库。
- WAREHOUSE_AUTOSUSPEND:
正在运行的仓库被自动暂停，因为已为该仓库启用 AUTO_SUSPEND，并且 AUTO_SUSPEND 已超过定义的非活动时间段。
- WAREHOUSE_SUSPEND:
用户手动暂停了正在运行的仓库。
- WAREHOUSE_RESIZE:
仓库大小已调整。
- RESOURCE_MONITOR_SUSPEND:
由于已达到仓库资源监视器的 Credit 配额，仓库被暂停。
- MULTICLUSTER_SPINUP:
在多集群仓库中预置了新的/暂停的集群；不适用于单集群仓库。
- MULTICLUSTER_SPINDOWN:
多集群仓库中正在运行的集群已关闭；不适用于单集群仓库。
EVENT_NAME 描述¶
仓库相关事件：
- CREATE_WAREHOUSE:
通过创建新仓库触发，这可能发生在用户手动创建仓库时，或者预置账户并在账户中自动创建默认仓库时。
集群数量：无（不适用）
事件状态：COMPLETED
事件原因：无（不适用）
计费影响：如果创建集群时 INITIALLY_SUSPENDED = TRUE，则此事件没有计费活动；否则，当为仓库预置所有计算资源或仓库开始处理语句时（如果仓库在资源完全预置之前开始处理语句），计量将开始。
- DROP_WAREHOUSE:
当现有仓库被弃用时触发；仓库中所有正在运行的语句都将停止并释放计算资源。
集群数量：无（不适用）
事件状态：COMPLETED
事件原因：无（不适用）
计费影响：所有正在运行的语句完成后，对仓库的计算资源计量会停止。
- ALTER_WAREHOUSE:
当现有仓库的属性发生变化（包括调整仓库大小）时触发。如果调整仓库大小，则会触发其他 RESIZE_WAREHOUSE 事件。此事件也可以触发 RESUME_WAREHOUSE 或 SUSPEND_WAREHOUSE 事件。
集群数量：无（不适用）
事件状态：COMPLETED
事件原因：无（不适用）
计费影响：计费影响取决于触发的事件。
- RESIZE_WAREHOUSE:
通过更改仓库的大小触发，这会增加或减少仓库中每个集群中的计算资源。对于正在运行的仓库，此事件还会触发仓库中每个集群的 RESIZE_CLUSTER 事件。
集群数量：无（适用于所有集群）
事件状态：STARTED、COMPLETED 或 PARTIALLY_COMPLETED
事件原因：WAREHOUSE_RESIZE
计费影响：调整正在运行的仓库大小会增加或移除仓库中每个集群中的计算资源；新增的资源在预置后开始计量，而移除的资源在完成处理任何运行语句后停止计量。调整暂停仓库的大小不会为仓库预置任何新的资源。
- RESUME_WAREHOUSE:
当恢复暂停的仓库或在创建新仓库时 INITIALLY_SUSPENDED = FALSE 时触发。此事件还会触发仓库中每个集群的 RESUME_CLUSTER 事件。
集群数量：无（适用于所有集群）
事件状态：STARTED、COMPLETED 或 PARTIALLY_COMPLETED
事件原因：WAREHOUSE_AUTORESUME 或 WAREHOUSE_RESUME
计费影响：为仓库预置所有计算资源后，计量就会开始。
- SUSPEND_WAREHOUSE:
当正在运行的仓库暂停时触发。此事件还会触发仓库中每个集群的 SUSPEND_CLUSTER 事件。
集群数量：无（适用于所有集群）
事件状态：STARTED、COMPLETED 或 PARTIALLY_COMPLETED
事件原因：WAREHOUSE_AUTOSUSPEND 或 WAREHOUSE_SUSPEND
计费影响：所有正在运行的语句完成后，对仓库的计算资源计量会停止。
与集群相关的事件：
- RESUME_CLUSTER:
当暂停的集群恢复时触发。
集群数量：已恢复的集群的数量（对于单集群仓库始终为
1）事件状态：COMPLETED
事件原因：
WAREHOUSE_AUTORESUME 或 WAREHOUSE_RESUME（单集群仓库）
MULTICLUSTER_SPINUP（多集群仓库）
计费影响：集群的计算资源预置完成后，开始计量。
- SUSPEND_CLUSTER:
当正在运行的集群暂停时触发。
集群数量：已暂停集群的数量（对于单集群仓库始终为
1）事件状态：COMPLETED
事件原因：
WAREHOUSE_AUTOSUSPEND 或 WAREHOUSE_SUSPEND（单集群仓库）
MULTICLUSTER_SPINDOWN（多集群仓库）
RESOURCE_MONITOR_SUSPEND（所有仓库）
计费影响：所有正在运行的语句完成后，对集群计算资源的计量将停止。
- RESIZE_CLUSTER:
在调整集群大小时触发，通常是调整仓库大小的结果。
集群数量：调整大小后的集群的数量（对于单集群仓库始终为
1）事件状态：COMPLETED
事件原因：
WAREHOUSE_AUTORESUME 或 WAREHOUSE_RESUME（单集群仓库）
MULTICLUSTER_SPINDOWN 或 MULTICLUSTER_SPINUP（多集群仓库）
WAREHOUSE_RESIZE（所有仓库）
计费影响：取决于计算资源是由于调整大小而被添加还是移除：
添加的计算资源在预置后开始计量。
所有正在运行的语句完成后，将停止对移除的计算资源进行计量。
- SPINUP_CLUSTER:
当集群启动时触发（仅限多集群仓库）；通常发生在最小/最大集群大小增加时。
集群数量：已启动的集群的数量
事件状态：STARTED、COMPLETED 或 PARTIALLY_COMPLETED
事件原因：MULTICLUSTER_SPINUP 或 WAREHOUSE_RESIZE
计费影响：集群的计算资源预置完成后，开始对其进行计量。
- SPINDOWN_CLUSTER:
当正在运行的集群关闭时触发（仅限多集群仓库）；通常发生在最小/最大集群大小减小时。
集群数量：已关闭的集群的数量
事件状态：STARTED、COMPLETED 或 PARTIALLY_COMPLETED
事件原因：MULTICLUSTER_SPINDOWN 或 WAREHOUSE_RESIZE
计费影响：所有正在运行的语句完成后，对集群计算资源的计量将停止。