Categorias:: Information Schema , Funções de tabela

WAREHOUSE_METERING_HISTORY¶

Esta função de tabela pode ser usada em consultas para retornar o uso de crédito por hora para um único warehouse (ou para todos os warehouses virtuais em sua conta) dentro de um intervalo de datas especificado.

Nota

This function is generally deprecated in favor of the ACCOUNT_USAGE.WAREHOUSE_METERING_HISTORY view, which provides a more complete data set and supports longer date ranges.

Nota

This function does not include credit usage for adaptive warehouses. To view adaptive warehouse usage, use the ACCOUNT_USAGE.WAREHOUSE_METERING_HISTORY view.

Consulte também:: WAREHOUSE_LOAD_HISTORY

Sintaxe¶

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

Argumentos¶

Obrigatório:

DATE_RANGE_START => constant_expr: A data de início, nos últimos 6 meses, para a qual o uso do warehouse é devolvido.

Opcional:

DATE_RANGE_END => constant_expr

A data de fim, nos últimos 6 meses, para a qual o uso do warehouse é devolvido.

Padrão: CURRENT_DATE é usado.

WAREHOUSE_NAME => 'string'

O nome do warehouse para o qual se recupera o uso de crédito. 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: todos os warehouses executados durante o intervalo de datas especificado.

Notas de uso¶

Retorna resultados apenas para a função ACCOUNTADMIN ou qualquer função que tenha sido explicitamente concedido o privilégio global MONITOR USAGE.
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.
A ordem e estrutura dos argumentos depende de se as palavras-chave do argumento (por exemplo, DATE_RANGE_START) estão incluídas:
- As palavras-chave não são necessárias se os argumentos forem especificados em ordem.
- Se as palavras-chave do argumento forem incluídas, os argumentos podem ser especificados em qualquer ordem.

Saída¶

A função retorna as seguintes colunas, ordenadas por WAREHOUSE_NAME e START_TIME:


Nome da coluna	Tipo de dados	Descrição
START_TIME	TIMESTAMP_LTZ	O início da hora em que ocorreu o uso deste warehouse.
END_TIME	TIMESTAMP_LTZ	O fim da hora em que esse uso do warehouse ocorreu.
WAREHOUSE_NAME	VARCHAR	Nome do warehouse.
CREDITS_USED	NUMBER	Número de créditos faturados para este warehouse nesta hora.
CREDITS_USED_COMPUTE	NUMBER	Número de créditos utilizados para o warehouse na hora.
CREDITS_USED_CLOUD_SERVICES	NUMBER	Número de créditos usados para serviços de nuvem em uma hora.

Exemplos¶

Recuperar o uso do warehouse por hora nos últimos 10 dias para todos os warehouses executados durante este período:

select *
from table(information_schema.warehouse_metering_history(dateadd('days',-10,current_date())));

Recuperar o uso do warehouse por hora para o warehouse testingwh em uma data especificada:

select *
from table(information_schema.warehouse_metering_history('2017-10-23', '2017-10-23', 'testingwh'));