Categorias:

Information Schema , Funções de tabela

WAREHOUSE_LOAD_HISTORY

Esta função de tabela pode ser usada para consultar o histórico de atividades (definido como “carga de consulta”) para um único warehouse dentro de um intervalo de datas especificado.

Nota

Esta função retorna a atividade do warehouse nos últimos 14 dias.

Nota

Especificar um valor de data que esteja dentro de um minuto do carimbo de data/hora atual pode produzir resultados imprecisos.

Consulte também:

WAREHOUSE_METERING_HISTORY

Sintaxe

WAREHOUSE_LOAD_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, WAREHOUSE_NAME => '<string>' ] )
Copy

Argumentos

Todos os argumentos são opcionais.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

O intervalo de datas, nos últimos 14 dias, para o qual se deve recuperar os dados do histórico de carregamento do warehouse:

  • Se uma data final não for especificada, então CURRENT_DATE é usada como o fim do intervalo.

  • Se uma data de início não for especificada, então o intervalo começa 10 minutos antes do início de DATE_RANGE_END (ou seja, o padrão é mostrar os 10 minutos anteriores do histórico de carregamento). Por exemplo, se DATE_RANGE_END for CURRENT_DATE, então o padrão DATE_RANGE_START é 11:50 PM no dia anterior.

Se o intervalo estiver fora dos últimos 15 dias, um erro é retornado.

Nota

Se o período selecionado for inferior a 8 horas, o carregamento é mostrado em intervalos de 5 segundos; caso contrário, são usados intervalos de 5 minutos.

WAREHOUSE_NAME => 'string'

O nome do warehouse para o qual se recupera o histórico de carregamento de uso. Observe que o nome do warehouse deve ser delimitado por aspas simples. Além disso, se o nome do warehouse contiver quaisquer espaços, letras maiúsculas e minúsculas misturadas ou caracteres especiais, o nome deve ser delimitado por aspas duplas dentro das aspas simples (por exemplo, '"My Warehouse"' vs 'mywarehouse').

Padrão: CURRENT_WAREHOUSE

Notas de uso

  • Para obter resultados desta função, uma das seguintes funções ou privilégios é necessária:

    • A função ACCOUNTADMIN pode obter resultados desta função, pois possui todas as permissões de conta globais.

    • Uma função com o privilégio global MONITOR USAGE no ACCOUNT pode consultar esta função para quaisquer warehouses da conta.

    • Uma função com o privilégio MONITOR no WAREHOUSE pode consultar esta função para o warehouse no qual ela tem permissões.

    • Uma função com o privilégio OWNERSHIP no WAREHOUSE tem todas as permissões no warehouse, incluindo MONITOR.

    Para obter mais detalhes, consulte Privilégios de controle de acesso.

  • Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

Saída

Nota

Para as colunas de saída desta função, o valor da carga de consulta é a relação do tempo total de execução (em segundos) de todas as consultas em um estado específico em um intervalo pelo tempo total (em segundos) desse intervalo.

Por exemplo, se 276 segundos for o tempo total para 4 consultas em um intervalo de 5 minutos (300 segundos), então o valor de carga da consulta será 276 / 300 = 0,92.

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_LTZ

O início do intervalo especificado (no fuso horário UTC) em que ocorreu o uso do warehouse.

END_TIME

TIMESTAMP_LTZ

O fim do intervalo especificado (no fuso horário UTC) em que ocorreu o uso do warehouse.

WAREHOUSE_NAME

TEXT

Nome do warehouse.

AVG_RUNNING

NUMBER(38,2)

Consulte o valor do carregamento para consultas executadas.

AVG_QUEUED_LOAD

NUMBER(38,2)

Consulte o valor de carregamento para consultas em fila porque o warehouse estava sobrecarregado.

AVG_QUEUED_PROVISIONING

NUMBER(38,2)

Consulte o valor de carregamento para consultas em fila porque o warehouse estava sendo provisionado.

AVG_BLOCKED

NUMBER(38,2)

Consulte o valor do carregamento para consultas bloqueadas por um bloqueio de transação.

Exemplos

Recuperar o histórico de carregamento da última hora, em intervalos de 5 segundos, para o warehouse atualmente em uso para sua sessão:

use warehouse mywarehouse;

select *
from table(information_schema.warehouse_load_history(date_range_start=>dateadd('hour',-1,current_timestamp())));
Copy

Recuperar o histórico de carregamento dos últimos 14 dias, em intervalos de 5 minutos, para o warehouse atualmente em uso para sua sessão:

use warehouse mywarehouse;

select *
from table(information_schema.warehouse_load_history(date_range_start=>dateadd('day',-14,current_date()), date_range_end=>current_date()));
Copy
Linguagem: Português