<budget_name>!GET_SERVICE_TYPE_USAGE

Visualize o uso de crédito de um orçamento por tipo de serviço.

Consulte também:

<budget_name>!GET_SPENDING_HISTORY

Sintaxe

<budget_name>!GET_SERVICE_TYPE_USAGE( SERVICE_TYPE => '<service_type>' ,
                                      TIME_DEPART => '<time_interval>' ,
                                      USER_TIMEZONE => '<timezone>' ,
                                      TIME_LOWER_BOUND => <constant_expr> ,
                                      TIME_UPPER_BOUND => <constant_expr>
                                    )
Copy

Argumentos

SERVICE_TYPE => service_type

O tipo de serviço usado para limitar resultados.

Valores válidos:

Tipo de serviço que está consumindo créditos, que pode ser um dos seguintes:

  • AUTO_CLUSTERING

  • HYBRID_TABLE_REQUESTS

  • MATERIALIZED_VIEW

  • PIPE

  • QUERY_ACCELERATION

  • SEARCH_OPTIMIZATION

  • SERVERLESS_TASK

  • SNOWPIPE_STREAMING

  • WAREHOUSE_METERING

  • WAREHOUSE_METERING_READER

TIME_DEPART => time_interval

Intervalo de tempo usado para delinear registros de uso. Cada linha exibe o uso do serviço pelo intervalo de tempo especificado.

Valores válidos:

  • HOUR, hora

  • DAY, dia

  • WEEK, semana

USER_TIMEZONE => timezone

Cadeia de caracteres especificando o fuso horário do usuário. A medição do orçamento é baseada no fuso horário UTC.

TIME_LOWER_BOUND => constant_expr

O início do intervalo de tempo durante o qual ocorreu o gasto.

TIME_UPPER_BOUND => constant_expr

O fim do intervalo de tempo durante o qual ocorreu o gasto.

Retornos

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_TZ

Data e hora em que ocorreu o uso.

ENTITY_ID

NUMBER

Identificador interno do objeto no orçamento.

NAME

VARCHAR

Nome do objeto medido.

CREDITS_USED

FLOAT

Número de créditos utilizados. Esta é a soma de CREDITS_COMPUTE e CREDITS_CLOUD.

CREDITS_COMPUTE

FLOAT

Número de créditos de computação usados.

CREDITS_CLOUD

FLOAT

Número de créditos de serviço de nuvem usados.

Requisitos de controle de acesso

  • Os seguintes privilégios e funções mínimos são necessários para visualizar resultados de orçamentos personalizados:

    • Uma função com qualquer função de instância para a instância de orçamento.

    • Uma função que recebeu o privilégio USAGE no banco de dados e no esquema que contém a instância de orçamento.

  • A função a seguir é necessária para visualizar os resultados do orçamento da conta:

    Uma função com qualquer função de aplicativo para o orçamento da conta.

Notas de uso

Para timezone, você pode especificar um nome de fuso horário ou um nome de link do lançamento 2021a do Banco de Dados de Fusos Horários IANA (por exemplo, America/Los_Angeles, Europe/London, UTC, Etc/GMT etc.).

Nota

  • Os nomes de fuso horário diferenciam maiúsculas de minúsculas e precisam ser colocados entre aspas simples (por exemplo, 'UTC').

  • O Snowflake não oferece suporte à maioria das abreviações de fuso horário (por exemplo, PDT, EST etc.) porque uma determinada abreviação pode se referir a um dos vários fusos horários diferentes. Por exemplo, CST pode se referir ao Horário Padrão Central na América do Norte (UTC-6), ao Horário Padrão de Cuba (UTC-5) e ao Horário Padrão da China (UTC8).

Exemplos

Visualize os créditos diários gastos em cada warehouse na última semana para o orçamento da conta:

CALL snowflake.local.account_root_budget!GET_SERVICE_TYPE_USAGE(
   SERVICE_TYPE => 'WAREHOUSE_METERING',
   TIME_DEPART => 'day',
   USER_TIMEZONE => 'UTC',
   TIME_LOWER_BOUND => dateadd('day', -7, current_timestamp()),
   TIME_UPPER_BOUND => current_timestamp()
);
Copy

Mensagens de erro

Os cenários a seguir podem ajudar você a solucionar problemas que podem ocorrer.

Erro

001044 (42P13): SQL compilation error: error line 0 at position -1
Invalid argument types for function 'GET_SERVICE_TYPE_USAGE':
(VARCHAR(X), VARCHAR(X), VARCHAR(X), VARCHAR(X))

Causa

Você chamou o método com argumentos inválidos ou com o número errado de argumentos.

Solução

Verifique se os argumentos usados para chamar o método são válidos e se você incluiu todos os argumentos necessários.

Erro

002151 (22023): Uncaught exception of type 'STATEMENT_ERROR' on line 16
at position 23 : SQL compilation error: [:TIME_DEPART] is not a valid
date/time component for function DATE_TRUNC.

Causa

O argumento TIME_DEPART é uma cadeia de caracteres inválida.

Solução

Use um dos valores válidos listados acima.

Erro

100094 (22000): Uncaught exception of type 'STATEMENT_ERROR' on line 16
at position 23 : Unknown timezone: '<invalid_timezone>'

Causa

O argumento USER_TIMEZONE é uma cadeia de caracteres inválida.

Solução

Use uma cadeia de caracteres de fuso horário válida. Para obter mais informações, consulte as Notas de uso acima.