- Categorias:
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
Esta função retorna o uso de crédito nos últimos 6 meses.
- Consulte também:
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 |
TEXT |
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'));