ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA

Retorna o consumo diário de uma conta específica ou de toda a organização e identifica se esse consumo é considerado uma anomalia de custo.

Sintaxe

SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '<start_date>',
  '<end_date>',
  <account_name> )
Copy

Argumentos

'start_date'

Especifica o início do período para o qual os dados de consumo são retornados.

Tipo de dados: DATE

'end_date'

Especifica o fim do período para o qual os dados de consumo são retornados.

Tipo de dados: DATE

account_name

Especifica uma expressão que determina a(s) conta(s) para a(s) qual(is) os dados de consumo são retornados. Você pode especificar os seguintes valores:

  • 'account_name': retorna os dados da conta especificada. Você deve especificar o nome da conta, não o localizador da conta.

  • CURRENT_ACCOUNT_NAME(): retorna os dados da conta atual.

  • NULL: retorna dados de toda a organização, não de uma conta específica.

Retornos

Retorna uma tabela com as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

USAGE_DATE

DATE

Dia em UTC em que o consumo ocorreu.

CONSUMPTION

NUMBER

Quantidade de consumo medida em CURRENCY_TYPE.

FORECASTED_CONSUMPTION

NUMBER

Consumo previsto com base no algoritmo de detecção de anomalias, medido em CURRENCY_TYPE.

UPPER_BOUND

NUMBER

Nível mais alto de consumo previsto com base no algoritmo de detecção de anomalias, medido em CURRENCY_TYPE. Os níveis de consumo acima desse valor são considerados uma anomalia.

LOWER_BOUND

NUMBER

Nível mais baixo de consumo previsto com base no algoritmo de detecção de anomalias, medido em CURRENCY_TYPE. Os níveis de consumo abaixo desse valor são considerados uma anomalia.

IS_ANOMALY

BOOLEAN

Se for verdadeiro, o consumo foi identificado como uma anomalia de custo porque saiu do intervalo dos limites superior e inferior.

CURRENCY_TYPE

VARCHAR

Unidade de medida para o consumo. Para obter informações sobre por que a unidade de medida é créditos ou uma moeda, consulte Unidade de medida para dados de custo.

ANOMALY_ID

VARCHAR

Identificador gerado pelo sistema.

Requisitos de controle de acesso

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

  • Função ACCOUNTADMIN

  • Função GLOBALORGADMIN

Notas de uso

Para retornar dados de uma conta diferente ou de toda a organização, você deve executar esse método na conta da organização ou em uma conta habilitada para ORGADMIN.

Exemplo

Identifique anomalias no nível da organização com base no consumo entre 1º de janeiro de 2024 e 31 de março de 2024:

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '2024-01-01', '2024-03-31', NULL);
Copy

Identifique as anomalias na conta atual com base no consumo entre 1º de janeiro de 2024 e 31 de março de 2024:

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '2024-01-01', '2024-03-31', current_account_name());
Copy

Identifique anomalias na conta prod_acct1 com base no consumo entre 1º de janeiro de 2024 e 31 de março de 2024:

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '2024-01-01', '2024-03-31', 'prod_acct1');
Copy