<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

Para obter mais informações, consulte Funções e privilégios do Budgets.

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).

  • Chamar esse método não retorna o objeto. Por isso, você não pode usar o encadeamento de métodos para chamar outro método no valor de retorno deste método. Em vez disso, chame cada método em uma instrução SQL separada.

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

Para solucionar problemas que podem ocorrer quando você chama esse método, consulte Você não pode chamar com sucesso o método GET_SERVICE_TYPE_USAGE.

Linguagem: Português