<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

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.