Monitorar o uso de crédito com orçamentos¶

Um orçamento define um limite mensal de gastos nos custos de computação para uma conta Snowflake ou um grupo personalizado de objetos Snowflake. Quando o limite de gastos é projetado para ser excedido, uma notificação é enviada. É possível configurar o orçamento para enviar essa notificação para uma lista de endereços de e-mail, uma fila fornecida por um serviço de nuvem (Amazon SNS, Azure Event Grid ou Google Cloud PubSub) ou um webhook para um sistema de terceiros (por exemplo, Slack, Microsoft Teams ou PagerDuty).

Orçamento de conta e orçamentos personalizados¶

O orçamento da conta monitora os gastos de todo o uso de crédito na conta.

É possível criar um orçamento personalizado para monitorar os limites de gastos de um grupo específico de objetos compatíveis.

Para ambos os tipos de orçamento, é necessário configurar o limite de gastos e especificar como deseja receber notificações.

Para começar a usar orçamentos no Snowflake, ative o orçamento da conta.

Limite de gastos e intervalo de tempo¶

O limite de gastos é expresso em créditos Snowflake e é usado apenas para fins de alertas e notificações. O limite de gastos é definido para o intervalo de tempo de um mês do calendário.

O intervalo de tempo começa às 12:00AM UTC do primeiro dia do mês e termina às 11:59PM UTC do último dia do mês. Se um orçamento for criado após o primeiro dia do mês, o primeiro intervalo de monitoramento será o período até o último dia do mês atual e será redefinido no primeiro dia do mês seguinte.

Se você ativar o orçamento da conta após o primeiro dia do mês, os dados a partir do início do mês serão preenchidos e usados para determinar se você excederá o limite de gastos do mês.

Se você criar um orçamento personalizado após o primeiro dia do mês, os dados históricos do mês serão preenchidos apenas para os recursos que foram adicionados ao orçamento usando uma tag. Os dados de recursos adicionados individualmente não serão preenchidos.

Nota

Se você criar um orçamento personalizado e adicionar recursos individualmente ao orçamento em vez de usar uma tag, considere o seguinte:

A previsão de gastos futuros desses recursos se baseia no uso de créditos apenas para os dias após a ativação do orçamento.
Você pode exceder seu orçamento no primeiro mês. Como os dados dos recursos não são preenchidos, a previsão pode estar incorreta. Os meses subsequentes preverão corretamente o uso de crédito com base no histórico de gastos.

Ajuste do intervalo de atualização do orçamento¶

Um orçamento não pode calcular se o consumo atingiu um limite de gastos até que seja atualizado com os dados de consumo mais recentes. O período entre o consumo e o recebimento das informações sobre esse consumo pelo orçamento é chamado de intervalo de atualização do orçamento.

Por padrão, o intervalo de atualização do orçamento é de até 6,5 horas. Você pode reduzir o intervalo de atualização do orçamento para uma hora, o que pode ser útil quando você precisa monitorar os gastos com mais cuidado. É possível reduzir temporariamente o intervalo de atualização do orçamento para monitorar o consumo de perto e, em seguida, redefini-lo para o padrão para economizar custos.

Definir o intervalo de atualização para uma hora aumenta o custo de computação do orçamento em um fator de 12. Por exemplo, se um orçamento consome um crédito por mês quando o intervalo de atualização é de 6,5 horas, o orçamento consome 12 créditos por mês quando o período de atualização é de uma hora. Para determinar o custo de computação atual dos seus orçamentos, consulte Análise dos custos de computação.

Para ajustar o intervalo de atualização do orçamento, chame o método SET_REFRESH_TIER.
Para recuperar o intervalo de atualização atual, chame o método GET_REFRESH_TIER.

Serviços com suporte¶

Os orçamentos monitoram o uso de créditos para os seguintes serviços. Use a tabela para determinar se os orçamentos personalizados oferecem suporte ao serviço e qual objeto está associado a ele.

Nota

O suporte ao orçamento da conta para recursos sem servidor depende da disponibilidade dos tipos de serviço na exibição Account Usage Exibição METERING_HISTORY.

Serviço	Orçamento de conta	Orçamento personalizado	Objeto
AI_SERVICES	✔
AUTO_CLUSTERING	✔	✔	Tabela
COPY_FILES	✔	✔	Banco de dados
DATA_QUALITY_MONITORING	✔	✔	Tabela
HYBRID_TABLE_REQUESTS	✔
MATERIALIZED_VIEW	✔	✔	Exibição materializada
PIPE	✔	✔	Canal
QUERY_ACCELERATION	✔	✔	Warehouse
REPLICATION	✔	✔	Banco de dados, grupo de replicação
SEARCH_OPTIMIZATION	✔	✔	Tabela
SERVERLESS_ALERTS	✔	✔	Alerta
SERVERLESS_TASK	✔	✔	Tarefa
SNOWPARK_CONTAINER_SERVICES	✔	✔	Pool de computação
SNOWPIPE_STREAMING	✔	✔	Tabela
WAREHOUSE_METERING	✔	✔	Warehouse

Notificações de Budgets¶

Um orçamento envia uma notificação de alerta diária quando os gastos atuais estão prestes a exceder o limite de gastos com base na previsão de série temporal.

Para receber notificações de alerta automáticas, você deve fazer o seguinte como parte da ativação do orçamento da conta ou da criação de um orçamento personalizado:

Definir um limite de gastos para o orçamento.
Especifique como deseja receber notificações sobre o orçamento.

Para obter mais informações, consulte Notificações sobre orçamentos.

Funções e privilégios do Budgets¶

Para habilitar uma função personalizada em sua conta para trabalhar com orçamentos, você pode conceder as seguintes funções e privilégios.

Nota

O Snowflake fornece funções de aplicativo e funções de banco de dados que controlam o acesso a todos os recursos relacionados a custos, inclusive orçamentos. Para obter informações sobre como conceder essas funções a uma função personalizada em vez de trabalhar com funções e privilégios específicos do orçamento, consulte Controle de acesso para gerenciamento de custos.

Funções de aplicativo para gerenciar o orçamento da conta¶

Você pode conceder as seguintes funções de aplicativo a uma função personalizada em sua conta para modificar ou gerenciar o orçamento da conta.

Função do aplicativo	Descrição
BUDGET_VIEWER	Permite que uma função visualize os dados de uso do orçamento e liste os recursos no orçamento.
BUDGET_ADMIN	Permite que uma função ative ou desative o orçamento da conta e modifique as propriedades de um orçamento, incluindo o limite de gastos, as integrações de notificação a serem usadas, a lista de endereços de e-mail para receber notificações e a configuração de notificações sem som.

Além da função de aplicativo, há outros privilégios necessários que devem ser concedidos para habilitar uma função personalizada para monitorar ou gerenciar o orçamento da conta. Para obter mais informações, consulte Funções e privilégios necessários.

Funções de instância para gerenciar orçamentos personalizados¶

Cada orçamento personalizado possui funções de instância que você pode conceder a outras funções para visualizar ou modificar o orçamento:

Função de instância	Descrição
VIEWER	Permite que uma função visualize dados de uso do orçamento.
ADMIN	Permite que uma função modifique as propriedades de um orçamento, incluindo o limite de gastos, as integrações de notificação a serem usadas, a lista de endereços de e-mail para receber notificações, a configuração de notificações sem som e os objetos no grupo.

Além da função de instância, há outros privilégios necessários que devem ser concedidos para permitir que uma função personalizada crie, monitore ou modifique um orçamento personalizado. Para obter mais informações, consulte Funções e privilégios necessários.

Funções e privilégios necessários¶

Além das funções de aplicativo ou instância, os seguintes privilégios devem ser concedidos a uma função personalizada para monitorar ou gerenciar orçamentos:

Privilégio ou função	Tipo de orçamento	Criar	Gerenciar	Monitorar	Notas
USAGE_VIEWER	Ambos	✔	✔	✔	Conceda a função de banco de dados do Snowflake USAGE_VIEWER à função personalizada.
USAGE	Personalizado	✔	✔	✔	Concede o privilégio USAGE no banco de dados que contém o orçamento personalizado.
USAGE	Personalizado	✔	✔	✔	Concede o privilégio USAGE no esquema que contém o orçamento personalizado.
SNOWFLAKE.BUDGET_CREATOR	Personalizado	✔			Concede esta função de banco de dados à função personalizada para permitir que ela crie orçamentos personalizados.
CREATE SNOWFLAKE.CORE.BUDGET	Personalizado	✔			Concede este privilégio ao esquema com orçamento personalizado.
APPLYBUDGET	Personalizado		✔		Deve ser concedido em cada objeto a ser adicionado ou removido de um orçamento personalizado.
USAGE	Personalizado		✔		Para adicionar ou remover objetos de esquema de um orçamento personalizado, esse privilégio deve ser concedido no banco de dados e no esquema com o objeto.

Consulte as seções a seguir para obter mais informações e exemplos.

Limitações¶

A seguir estão as limitações para Budgets:

As instâncias da classe BUDGET não podem ser replicadas para contas de destino.
Uma conta pode conter no máximo 100 orçamentos personalizados.
Atualmente, o Budgets não oferece suporte ao monitoramento de custos para Tabelas híbridas.
Os seguintes parâmetros de nível de conta devem ser desmarcados ou definidos com o valor padrão:
- AUTOCOMMIT deve estar desativado ou definido como TRUE.
  
  Se esse parâmetro for definido como FALSE, a ativação de um orçamento poderá falhar ou o uso poderá não ser rastreado corretamente.
- TIMESTAMP_INPUT_FORMAT e DATE_INPUT_FORMAT deve estar desativados ou definidos como AUTO.
  
  Se esses parâmetros não estiverem definidos como AUTO, o uso poderá não ser rastreado corretamente.
Antes de ativar os orçamentos, verifique os valores desses parâmetros executando o comando SHOW PARAMETERS:
```
SHOW PARAMETERS LIKE 'AUTOCOMMIT' IN ACCOUNT;
```
Copy
```
SHOW PARAMETERS LIKE 'TIMESTAMP_INPUT_FORMAT' IN ACCOUNT;
```
Copy
```
SHOW PARAMETERS LIKE 'DATE_INPUT_FORMAT' IN ACCOUNT;
```
Copy
Nota

É necessário definir esses parâmetros no nível da conta. A configuração dos parâmetros em um nível inferior (por exemplo, no nível da sessão) não afeta a ativação de orçamentos ou o rastreamento do uso.