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

Esta função retorna o uso de crédito nos últimos 6 meses.

Consulte também:

WAREHOUSE_LOAD_HISTORY

Sintaxe

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

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())));
Copy

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'));
Copy