Esquema:: ORGANIZATION_USAGE

Exibição WAREHOUSE_EVENTS_HISTORY¶

Importante

Essa exibição só está disponível na conta da organização. Para obter mais informações, consulte Exibições premium na conta da organização.

Essa exibição do Organization Usage pode ser usada para retornar os eventos que foram acionados para os warehouses de cluster único e de vários clusters em sua conta.

Os eventos com suporte incluem:

Criar, descartar ou alterar um warehouse, incluindo o redimensionamento do warehouse.
Retomar ou suspender um warehouse.
Retomar, suspender ou redimensionar um cluster em um warehouse (warehouses monocluster e multicluster).
Parar ou iniciar clusters adicionais em um warehouse (somente warehouses multicluster).

Colunas¶

Colunas em nível de organização

Nome da coluna	Tipo de dados	Descrição
ORGANIZATION_NAME	VARCHAR	Nome da organização.
ACCOUNT_LOCATOR	VARCHAR	Identificador gerado pelo sistema para a conta.
ACCOUNT_NAME	VARCHAR	Identificador definido pelo usuário para a conta.

Colunas adicionais

Nome da coluna	Tipo de dados	Descrição
TIMESTAMP	TIMESTAMP_LTZ	O carimbo de data/hora em que o evento é acionado.
WAREHOUSE_ID	NUMBER	A ID única do warehouse (atribuída pelo Snowflake) que corresponde ao nome do warehouse em sua conta.
WAREHOUSE_NAME	VARCHAR	O nome do warehouse em sua conta.
CLUSTER_NUMBER	NUMBER	Se um evento foi acionado para um cluster específico em um warehouse multicluster, o número do cluster (começando por 1) para o qual o evento foi acionado; se o evento foi acionado para todos os clusters no warehouse ou não é aplicável para um warehouse monocluster, NULL será exibido.
EVENT_NAME	VARCHAR	Nome do evento. Para ver a lista de valores possíveis, consulte abaixo.
EVENT_REASON	VARCHAR	A causa do evento. Para ver a lista de valores possíveis, consulte abaixo.
EVENT_STATE	VARCHAR	Estado de um evento que pode levar tempo para ser concluído: STARTED ou COMPLETED.
USER_NAME	VARCHAR	Usuário que iniciou o evento.
ROLE_NAME	VARCHAR	Função que estava ativa na sessão no momento em que o evento foi iniciado.
QUERY_ID	VARCHAR	Identificador interno/gerado pelo sistema para a instrução SQL.
SIZE	VARCHAR	Tamanho atual do warehouse no momento do evento. Este valor está disponível apenas para eventos WAREHOUSE_CONSISTENT. Caso contrário, este valor será NULL.
CLUSTER_COUNT	NUMBER	Número de clusters de warehouses no momento do evento. Este valor está disponível apenas para eventos WAREHOUSE_CONSISTENT. Caso contrário, este valor será NULL.
WAREHOUSE_TYPE	VARCHAR	`STANDARD` ou `SNOWPARK-OPTIMIZED`. Este valor está disponível apenas para eventos WAREHOUSE_CONSISTENT. Caso contrário, este valor será NULL.
RESOURCE_CONSTRAINT	VARCHAR	Um de: . - `STANDARD_GEN_1` . - `STANDARD_GEN_2` . - `MEMORY_1X` . - `MEMORY_1X_x86` . - `MEMORY_16X` . - `MEMORY_16X_x86` . - `MEMORY_64X` . - `MEMORY_64X_x86` . Esse valor só está disponível para eventos WAREHOUSE_CONSISTENT. Caso contrário, este valor será NULL. O NULL também é válido para warehouses padrão criados antes do lançamento do recurso STANDARD_GEN_2.

Descrições EVENT_NAME¶

As seções a seguir descrevem os valores válidos para a coluna EVENT_NAME para eventos relacionados ao warehouse e ao cluster.

Eventos relacionados a warehouses¶

A tabela a seguir descreve os valores válidos para a coluna EVENT_NAME para eventos relacionados ao warehouse:

EVENT_NAME

Descrição

CREATE_WAREHOUSE

Acionado pela criação de um novo warehouse, que pode ocorrer quando um usuário cria manualmente um warehouse ou quando uma conta é provisionada e o warehouse padrão é criado automaticamente na conta.

Número do cluster	Nenhum (N/A)
Estado do evento	COMPLETED ou STARTED
Motivo do evento	Nenhum (N/A)

Impacto de custo: Nenhum se o cluster for criado com INITIALLY_SUSPENDED = TRUE. Caso contrário, a medição começa quando todos os recursos de computação são provisionados para o warehouse ou o warehouse começa a processar instruções (se o warehouse começa a processar instruções antes que os recursos sejam totalmente provisionados).

DROP_WAREHOUSE

Acionado quando um warehouse existente é descartado; todas as consultas em execução no warehouse são interrompidas e os recursos de computação são lançados.

Número do cluster	Nenhum (N/A)
Estado do evento	COMPLETED ou STARTED
Motivo do evento	Nenhum (N/A)

Impacto no custo: A medição dos recursos de computação do warehouse é interrompida após a conclusão de todas as consultas em execução.

ALTER_WAREHOUSE

Acionado quando as propriedades de um warehouse existente são alteradas, incluindo o redimensionamento do warehouse. Se o warehouse for redimensionado, eventos adicionais RESIZE_WAREHOUSE são acionados. Este evento também pode acionar os eventos RESUME_WAREHOUSE ou SUSPEND_WAREHOUSE.

Número do cluster	Nenhum (N/A)
Estado do evento	COMPLETED ou STARTED
Motivo do evento	Nenhum (N/A)

Impacto de custo: Depende do(s) evento(s) que é/são acionado(s) pela instrução ALTER.

RESIZE_WAREHOUSE

Acionado pela mudança do tamanho de um warehouse, o que aumenta ou diminui os recursos de computação em cada cluster do warehouse. Para um warehouse em execução, este evento também aciona um evento RESIZE_CLUSTER para cada cluster no warehouse.

Número do cluster	Nenhum (N/A)
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_RESIZE

Impacto de custo: Redimensionar um warehouse em execução adiciona ou remove recursos de computação em cada cluster do warehouse. Os recursos recém-adicionados começam a ser medidos quando são provisionados. Os recursos removidos param de ser medidos após terminarem de processar quaisquer consultas em execução.

O redimensionamento de um warehouse suspenso não prevê nenhum novo recurso para o warehouse.

RESUME_WAREHOUSE

Acionado quando um warehouse suspenso é retomado ou um novo warehouse é criado com INITIALLY_SUSPENDED = FALSE. Este evento também aciona um evento RESUME_CLUSTER para cada cluster no warehouse.

Número do cluster	Nenhum (aplica-se a todos os clusters)
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_AUTORESUME ou WAREHOUSE_RESUME

Impacto de custo: A medição começa depois que todos os recursos de computação são provisionados para o warehouse.

SUSPEND_WAREHOUSE

Acionado quando um warehouse em funcionamento é suspenso. Este evento também aciona um evento SUSPEND_CLUSTER para cada cluster no warehouse.

Número do cluster	Nenhum (aplica-se a todos os clusters)
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_AUTOSUSPEND ou WAREHOUSE_SUSPEND

Impacto no custo: A medição dos recursos de computação do warehouse é interrompida após a conclusão de todas as instruções em execução.

WAREHOUSE_CONSISTENT

Acionado quando alterações pendente em um warehouse são concluídas. Para obter mais informações, consulte Notas de uso.

Número do cluster	NULL
Estado do evento	COMPLETED
Motivo do evento	NULL

Impacto de custo: Nenhum. A medição ocorre para o evento do warehouse que é registrado com o estado STARTED anterior ao evento WAREHOUSE_CONSISTENT.

Para obter mais informações, consulte o impacto de custo dos eventos de warehouse descritos nas linhas anteriores.

Eventos relacionados a clusters:¶

A tabela a seguir descreve os valores válidos para a coluna EVENT_NAME para eventos relacionados ao cluster:

EVENT_NAME

Descrição

RESUME_CLUSTER

Acionado quando um cluster suspenso é retomado.

Número do cluster	Número do cluster retomado (sempre `1` para um warehouse de cluster único)
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_AUTORESUME ou WAREHOUSE_RESUME (warehouse de cluster único) MULTICLUSTER_SPINUP (warehouse multicluster)

Impacto no custo: A medição começa nos recursos de computação do cluster depois que eles são provisionados.

SUSPEND_CLUSTER

Acionado quando um cluster em execução é suspenso.

Número do cluster	Número do cluster suspenso (sempre `1` para um warehouse de cluster único)
Estado do evento	STARTED
Motivo do evento:	WAREHOUSE_AUTOSUSPEND ou WAREHOUSE_SUSPEND (warehouse de cluster único) MULTICLUSTER_SPINDOWN (warehouse multicluster) RESOURCE_MONITOR_SUSPEND

Impacto no custo: A medição dos recursos de computação do cluster é interrompida após a conclusão de todas as consultas em execução.

RESIZE_CLUSTER

Acionado quando um cluster é redimensionado, geralmente como resultado do redimensionamento de um warehouse.

Número do cluster	Número do cluster redimensionado (sempre `1` para um warehouse de cluster único)
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_AUTORESUME ou WAREHOUSE_RESUME (warehouse de cluster único) MULTICLUSTER_SPINDOWN ou MULTICLUSTER_SPINUP (warehouse multicluster) WAREHOUSE_RESIZE

Impacto no custo: Depende se os recursos de computação são adicionados ou removidos devido ao redimensionamento. Os recursos recém-adicionados começam a ser medidos quando são provisionados. Os recursos removidos param de ser medidos após terminarem de processar quaisquer consultas em execução.

SPINUP_CLUSTER

Acionado quando um cluster é iniciado (somente warehouse multicluster); geralmente acontece quando o tamanho mínimo ou máximo do cluster é aumentado.

Número do cluster	Número do cluster que foi iniciado
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_RESIZE (warehouse monocluster) MULTICLUSTER_SPINUP (warehouse multicluster)

Impacto no custo: A medição começa nos recursos de computação do cluster depois que eles são provisionados.

SPINDOWN_CLUSTER

Acionado quando um cluster em execução é desligado (somente warehouse multicluster); geralmente acontece quando o tamanho mínimo ou máximo do cluster é reduzido.

Número do cluster	Número do cluster que foi encerrado
Estado do evento	STARTED
Motivo do evento	WAREHOUSE_RESIZE (warehouse monocluster) MULTICLUSTER_SPINDOWN (warehouse multicluster)

Impacto no custo: A medição dos recursos de computação do cluster é interrompida após a conclusão de todas as consultas em execução.

Descrições EVENT_REASON¶

A tabela a seguir descreve os valores válidos para a coluna EVENT_REASON:

EVENT_REASON	Descrição
WAREHOUSE_AUTORESUME	Um warehouse suspenso foi retomado automaticamente porque AUTO_RESUME está habilitado para o warehouse e uma instrução SQL foi enviada ao warehouse.
WAREHOUSE_RESUME	Um warehouse suspenso foi retomado manualmente por um usuário.
WAREHOUSE_AUTOSUSPEND	Um warehouse em funcionamento foi suspenso automaticamente porque AUTO_SUSPEND está habilitado para o warehouse e o período definido de inatividade para AUTO_SUSPEND já passou.
WAREHOUSE_SUSPEND	Um warehouse em execução foi suspenso manualmente por um usuário.
WAREHOUSE_RESIZE	Um warehouse foi redimensionado.
RESOURCE_MONITOR_SUSPEND	Um warehouse foi suspenso porque a cota de crédito para o monitor de recursos do warehouse foi atingida.
MULTICLUSTER_SPINUP	Um cluster novo ou suspenso foi provisionado em um warehouse multicluster; não aplicável a warehouses de cluster único.
MULTICLUSTER_SPINDOWN	Um cluster em funcionamento foi fechado em um warehouse multicluster; não aplicável a warehouses monocluster.

Notas de uso¶

A latência da exibição pode ser de até 24 horas.

Um evento pode produzir várias linhas na exibição se acionar eventos adicionais relacionados.
O valor para as colunas EVENT_REASON, USER_NAME, ROLE_NAME e QUERY_ID é NULL para um evento WAREHOUSE_CONSISTENT.
O evento WAREHOUSE_CONSISTENT pode compartilhar o mesmo carimbo de data/hora com outro evento de warehouse e ser listado fora de ordem.

Evento de warehouse que indica que uma operação foi concluída¶

Eventos que criam um warehouse, alteram o tamanho do warehouse ou o número de clusters ou suspendem um warehouse não são operações atômicas. Isso significa que é necessário um pequeno período de tempo para que essas operações sejam totalmente concluídas.

Por exemplo, se um warehouse for suspenso usando uma instrução ALTER WAREHOUSE … SUSPEND, todas as consultas que estão sendo executadas no warehouse devem ser concluídas (ou atingir o tempo limite) antes que possam ser suspensas. Em alguns casos, vários eventos de warehouse podem estar em andamento (por exemplo, redimensionar e suspender). Quando todos os eventos de warehouse forem concluídos, o warehouse estará em um estado consistente.

Se um evento de warehouse for registrado em log com o estado STARTED na coluna EVENT_STATE, ele nunca será registrado com um estado COMPLETED. Em vez disso, um evento registrado com o estado STARTED é sempre seguido por um subsequente evento WAREHOUSE_CONSISTENT. Se vários eventos de warehouse forem registrados com o estado do evento STARTED, esses eventos se fundem no mesmo evento WAREHOUSE_CONSISTENT.

Se um evento de warehouse for registrado com o estado COMPLETED na coluna EVENT_STATE, nenhum evento WAREHOUSE_CONSISTENT subsequente ocorrerá, a menos que outro evento pendente seja registrado com um estado STARTED.

Exemplos¶

Como consultar o histórico de eventos da semana anterior¶

Veja o histórico de eventos de warehouse my_wh da semana anterior executando a seguinte instrução:

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

Copy

Exemplo de resultados do histórico de eventos¶

Histórico de eventos para uma instrução sem alterações pendente¶

Uma instrução ALTER WAREHOUSE é registrada em log com o estado COMPLETED quando não há alterações adicionais pendentes. Por exemplo, a seguinte instrução atualiza o comentário para o warehouse my_wh:

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

Copy

Esta instrução resulta na seguinte linha na exibição 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

Histórico de eventos para uma instrução que é seguida por um evento WAREHOUSE_CONSISTENT¶

Quando uma instrução ALTER WAREHOUSE altera o tamanho do warehouse, eventos adicionais ocorrem. Por exemplo, redimensionar o warehouse my_wh:

ALTER WAREHOUSE my_wh SET
  WAREHOUSE_SIZE = 'SMALL';

Copy

Esta instrução resulta nas seguintes linhas na exibição 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

Histórico de eventos para um evento de warehouse iniciado pelo Snowflake¶

Quando o Snowflake retoma um warehouse multicluster, os seguintes eventos de warehouse são registrados:

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