Monitoramento do uso de crédito com Budgets¶

Orçamento de conta e orçamentos personalizados¶

Para começar a usar orçamentos no Snowflake, ative o orçamento da conta. O orçamento da conta monitora os gastos de todos os objetos suportados na conta. Para receber notificações sobre o orçamento, configure o limite de gastos e especifique endereços de e-mail para receber notificações.

Você também pode criar orçamentos personalizados para monitorar os limites de gastos de um grupo específico de objetos suportados. Você pode criar um orçamento personalizado em qualquer banco de dados e esquema. Assim como o orçamento da conta, você deve definir o limite de gastos e os endereços de e-mail de notificação para receber e-mails de notificação.

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 não serão preenchidos. A previsão de gastos futuros é baseada no uso de crédito apenas nos dias após a ativação do orçamento.

Objetos com suporte¶

A lista de objetos com suporte contribui para o limite de gastos do orçamento da conta. Para um orçamento personalizado, você pode selecionar objetos específicos para monitorar.

Um orçamento pode monitorar os seguintes objetos:

• Tabelas

• Exibições materializadas

• Esquemas

• Bancos de dados

• Warehouses

• Canais

• Tarefas

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:

• Definir um limite de gastos para o orçamento.

• Configurar notificações por e-mail para o orçamento.

A seguir, um exemplo de um e-mail de notificação:

Você pode desativar as notificações por e-mail para um orçamento chamando o método SET_NOTIFICATION_MUTE_FLAG.

Funções e privilégios necessários para criar orçamentos¶

Você pode usar uma função personalizada para criar orçamentos personalizados em sua conta. Conceda a seguinte função de banco de dados e privilégio à função personalizada:

• A função de banco de dados SNOWFLAKE SNOWFLAKE.BUDGET_CREATOR.

• O privilégio CREATE SNOWFLAKE.CORE.BUDGET no esquema no qual o orçamento será criado.

Por exemplo, crie uma função budget_admin e conceda a função e os privilégios necessários para criar orçamentos personalizados no esquema budgets_db.budgets_schema:

CREATE ROLE budget_admin;

GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_admin;

GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_admin;

GRANT CREATE SNOWFLAKE.CORE.BUDGET ON SCHEMA budgets_db.budgets_schema
  TO ROLE budget_admin;

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 monitorar o orçamento da conta.

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_ADMIN TO ROLE budget_admin;

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_VIEWER TO ROLE budget_monitor;

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:

GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
  TO ROLE budget_admin;

Exploração dos custos¶

Você pode visualizar os custos de tarefas sem servidor usando Snowsight ou Exibição SERVERLESS_TASK_HISTORY do Account Usage. Para obter mais informações sobre como visualizar os custos com base no tipo de serviço, consulte Exploração do custo de computação.

Você pode visualizar os custos de armazenamento usando Snowsight ou consultando as exibições Account Usage e Organization Usage. Para obter mais informações sobre como visualizar os custos de armazenamento, consulte Exploração do custo de armazenamento.

Ativação do orçamento da conta¶

Ative o orçamento da conta, defina o limite de gastos da conta e forneça os endereços de e-mail para receber notificações quando o uso de crédito exceder o limite de gastos.

Você pode ativar o orçamento da conta usando Snowsight ou SQL.

Criação de um orçamento personalizado usando Snowsight¶

1. Entre em Snowsight.

2. Select Admin » Cost Management

3. Selecione Budgets.

4. No canto superior direito do painel, selecione (adicionar Budget).

   Nota

   Se o ícone Adicionar Budget não for exibido, você deverá primeiro ativar o orçamento da conta.

5. Insira um Budget name.

6. Selecione o banco de dados e o esquema no qual deseja criar seu orçamento.

7. Digite o Spending limit.

8. Especifique os endereços de e-mail para receber notificações.

   Nota

   Cada endereço de e-mail adicionado para notificações de orçamento deve ser verificado. A configuração do e-mail de notificação falhará se algum endereço de e-mail da lista não for verificado.

9. Selecione Resources to monitor.

   • Para adicionar um banco de dados, expanda Databases para selecionar um banco de dados.

   • Para adicionar objetos em um esquema, expanda o esquema para listar os objetos disponíveis. Expanda a categoria do objeto (por exemplo, Tables ou Tasks) para selecionar objetos.

   • Para adicionar um warehouse, expanda Warehouses e selecione um warehouse.

   Nota

   Quando você seleciona um banco de dados ou esquema, todos os objetos suportados (por exemplo, tabelas) contidos no banco de dados ou esquema também são adicionados ao orçamento.

Quando você adiciona endereços de e-mail para notificações usando Snowsight, o Snowflake cria ou atualiza uma integração de notificação por e-mail chamada default_budget_notification_integration em um processo em segundo plano. Se a integração de notificação existir, o Snowflake adicionará quaisquer novos endereços de e-mail inseridos aos endereços de e-mail existentes na lista.

Se a integração de notificação não existir, o Snowflake a cria e concede o privilégio USAGE. Para obter mais informações, consulte as etapas descritas na seção de orçamento da conta.

Criação de um orçamento personalizado usando SQL¶

Crie um orçamento personalizado e defina o limite de gastos e os endereços de e-mail de notificação.

1. Revise os orçamentos existentes em sua conta:

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. Crie o orçamento my_budget em budgets_db.budgets_schema usando o comando CREATE SNOWFLAKE.CORE.BUDGET:

   USE SCHEMA budgets_db.budgets_schema;
   
   CREATE SNOWFLAKE.CORE.BUDGET my_budget();
   

   Copy

3. Defina o limite de gastos para 500 créditos por mês:

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. Defina a integração de notificações e os endereços de e-mail:

   Nota

   Se você ainda não tiver criado um e-mail NOTIFICATION INTEGRATION, consulte as etapas na seção de orçamento da conta para criar um.

   CALL my_budget!SET_EMAIL_NOTIFICATIONS('budgets_notification_integration',
                                          'costadmin@example.com');
   

   Copy

5. Para adicionar objetos ao seu orçamento personalizado, você deve passar uma referência ao método ADD_RESOURCE do orçamento. Por exemplo, para adicionar uma tabela denominada t1 ao orçamento denominado my_budget:

   CALL budgets_db.budgets_schema.my_budget!ADD_RESOURCE(
      SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'applybudget'));
   

   Copy

   A instrução SYSTEM$REFERENCE cria uma referência a um objeto TABLE, t1, com o privilégio APPLYBUDGET concedido na tabela. O terceiro parâmetro da função especifica o escopo da referência; neste caso, “SESSION” cria uma referência com escopo de sessão. As referências passadas ao método ADD_RESOURCE para um orçamento podem ser criadas com qualquer escopo de referência transitório (ou seja, o terceiro parâmetro pode ser “SESSION” ou “CALL”).

6. Conceda a função de instância ADMIN à sua função budget_admin personalizada:

   GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
   

   Copy

Você não pode ativar o orçamento da conta¶

Existem vários motivos pelos quais você pode não conseguir ativar o orçamento da sua conta:

Unknown user-defined function SNOWFLAKE.LOCAL.ACTIVATE

FAILURE: Uncaught exception of type 'BUDGET_ALREADY_ACTIVATED' on line X at position X

CALL SNOWFLAKE.LOCAL.ACCOUNT_ROOT_BUDGET!GET_CONFIG();

-20000 (P0001): Uncaught exception of type 'NO_PERMISSION_TO_ACTIVATE_BUDGET' on line X at position X

Você não pode criar um orçamento personalizado¶

Existem vários motivos pelos quais você pode não conseguir criar um orçamento personalizado.

FAILURE: SQL access control error: Insufficient privileges to operate on class 'BUDGET'

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

Você não pode ativar um orçamento personalizado¶

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

Você não pode chamar métodos no orçamento da conta¶

Há vários motivos pelos quais a chamada de um método no orçamento da conta pode falhar.

-20000 (P0001): Uncaught exception of type 'FUNCTION_NOT_SUPPORTED_FOR_ACCOUNT_ROOT_BUDGET' on line 11 at position 18

-20000 (P0001): Uncaught exception of type 'ACCOUNT_ROOT_BUDGET_NOT_ACTIVATED' on line X at position X

O recurso do Budgets não está disponível para sua conta¶

FAILURE: SQL compilation error: Class 'SNOWFLAKE.CORE.BUDGET' does not exist or not authorized.

000002 (0A000): Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 : Unsupported feature 'TOK_RESOURCE_GROUP'.