<budget_name>!GET_SERVICE_TYPE_USAGE¶
Visualize o uso de crédito de um orçamento por tipo de serviço.
- Consulte também:
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>
)
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()
);
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. |