ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE

Retorna o consumo por hora na conta atual em um dia específico, discriminado por tipo de serviço. Opcionalmente, você pode limitar os resultados aos tipos de serviço que estão consumindo mais créditos naquele dia.

Sintaxe

SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE(
  '<date>',
  <number_of_types> )

Argumentos

'date'

Especifica o dia para o qual você deseja retornar os dados de consumo.

Tipo de dados: DATE

number_of_types

Especifica o número de tipos de serviço a serem retornados, classificados pelo consumo total no dia especificado.

Para retornar todos os tipos de serviço que consumiram créditos no dia especificado, especifique NULL.

Tipo de dados: NUMBER

Saída

Retorna uma tabela com as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

HOUR

NUMBER

Um número entre 0 e 23 (inclusive) que especifica a hora do dia em que o consumo ocorreu.

SERVICE_TYPE

VARCHAR

O tipo de serviço que consumiu os créditos (por exemplo, AI_SERVICES).

CREDITS

NUMBER

O número de créditos consumidos pelo tipo de serviço durante a hora especificada.

Requisitos de controle de acesso

Os usuários com qualquer uma das seguintes funções podem chamar esse método:

  • Função do sistema ACCOUNTADMIN

  • Função do sistema GLOBALORGADMIN

  • Função de aplicativo SNOWFLAKE.APP_USAGE_ADMIN

  • Função de aplicativo SNOWFLAKE.APP_USAGE_VIEWER

Notas de uso

  • Um dia é definido por um período de 24 horas em UTC. Isso pode ser diferente do fuso horário local do usuário.

  • Esse método retorna dados de consumo para a conta atual. Ele não pode ser usado para retornar dados de outras contas ou de toda a organização.

  • Esse método retorna os créditos consumidos para a conta (não a moeda).

  • Os principais tipos de serviço são determinados pelo consumo total ao longo de todo o dia. Após a identificação dos principais tipos de serviço, o método retorna o consumo por hora para cada um desses tipos de serviço.

Exemplos

Retorne os dois tipos de serviço que consumiram mais créditos em 15 de janeiro de 2026. A saída inclui o consumo por hora para cada tipo de serviço.

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE(
  '2026-01-15', 2);

Retorne o consumo por hora em 15 de janeiro de 2026 para todos os tipos de serviço que tiveram consumo naquele dia:

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE(
  '2026-01-15',
  NULL);