Orçamentos personalizados¶

Herança de tag¶

Adicionar uma tag a um orçamento rastreia todos os objetos com essa tag, incluindo os que a herdaram de um objeto pai. Por exemplo, se um banco de dados tem uma tag, as tabelas do banco de dados herdam a tag e são rastreadas por um orçamento. Como o orçamento rastreia o uso com base no par tag/valor, se você substituir o valor da tag no nível da tabela, isso poderá mudar se o orçamento rastreia ou não o uso associado à tabela. Por exemplo, suponha que você tenha um orçamento que rastreie objetos com a tag team = 'eng'. Se o banco de dados tiver a tag team = 'eng', mas uma tabela do banco de dados tiver a tag team = 'IT', o orçamento não vai monitorar os custos associados a essa tabela.

No contexto de orçamentos, as tags não são herdadas de uma conta porque o orçamento da conta é destinado a atender a esse caso de uso.

Para obter mais informações, incluindo como os valores da tag são substituídos, consulte Herança de tag.

Rastreamento de um objeto com vários orçamentos¶

Vários orçamentos podem adicionar o mesmo par tag/valor, o que significa mais uso de crédito do mesmo objeto do que o orçamento pode rastrear. Por exemplo, suponha que você adicione a tag cost_center = 'eng' a ambos budget_1 e budget_2. Como um warehouse com a tag cost_center = 'eng' consome créditos, isso será considerado no limite de crédito de ambos budget_1 e budget_2.

Se tiver várias tags, um objeto também poderá ser rastreado por mais de um orçamento. Por exemplo, suponha que um warehouse tenha duas tags: cost_center = 'finance' e stage = 'dev'. Você pode criar um orçamento que rastreia cost_center = 'finance' e outro que rastreia stage = 'dev'. Os créditos consumidos pelo warehouse contam para o limite de crédito de ambos os orçamentos.

Limitações e considerações¶

Ao usar tags para monitorar objetos, tenha em mente o seguinte:

• Quando você altera uma tag em um objeto, pode levar até seis horas para que a alteração seja refletida nos orçamentos que usam tags.

• Atualmente, os alertas não podem ser monitorados com tags. Você deve adicioná-los individualmente.

• As mudanças nas tags nos primeiros dois dias do mês são refletidas no uso do mês anterior.

Crie uma função personalizada para criar orçamentos¶

Você pode usar uma função personalizada para criar orçamentos personalizados em sua conta. Para obter uma lista completa de privilégios e funções que devem ser concedidos a uma função para criar um orçamento personalizado, consulte Funções e privilégios do Budgets.

O exemplo a seguir cria uma função denominada budget_owner e concede a função e os privilégios necessários para criar orçamentos personalizados no esquema budgets_db.budgets_schema. O exemplo deve ser executado usando a função ACCOUNTADMIN:

USE ROLE ACCOUNTADMIN;
   
CREATE ROLE budget_owner;
  
GRANT USAGE ON DATABASE budgets_db TO ROLE budget_owner;
GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_owner;

GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_owner;

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

Se quiser habilitar uma função diferente do proprietário do orçamento para modificar as configurações de orçamento personalizado, você pode criar uma função personalizada com privilégios de modificação. Para obter mais informações, consulte Criação de uma função personalizada para gerenciar um orçamento personalizado.

Como usar o Snowsight para criar um orçamento personalizado¶

1. Faça login no Snowsight.

2. Selecione Admin » Cost Management.

3. Selecione Budgets.

4. Selecione (adicionar orçamento).

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 + Tag & resources e adicione as tags e os recursos que você quer adicionar ao orçamento personalizado.

   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.

   • Se você estiver adicionando objetos individuais diretamente, só poderá adicionar um objeto a um orçamento personalizado. Se esse for o caso, quando um objeto já estiver incluído em um orçamento personalizado, e você adicionar esse objeto a um segundo orçamento personalizado, o Budgets removerá o objeto do primeiro orçamento personalizado sem nenhum um aviso. Esse comportamento não se aplica ao uso de tags para adicionar objetos aos orçamentos. Um objeto com uma ou mais tags pode ser incluído em vários orçamentos personalizados se você usa tags para adicionar o objeto aos orçamentos.

Após criar e configurar um orçamento personalizado, você pode criar uma função personalizada para permitir que administradores não pertencentes à conta monitorem os recursos e o uso do orçamento. Para obter mais informações, consulte Criação de uma função personalizada para monitorar um orçamento personalizado.

Como usar os comandos SQL para criar um orçamento personalizado¶

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:

   Nota

   A instrução a seguir retorna os orçamentos para os quais você tem privilégios de acesso. Somente um usuário com a função ACCOUNTADMIN pode ver todos os orçamentos na conta.

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

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

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

   Copy

3. Defina o limite de gastos mensais. Por exemplo, defina o limite de gastos para 500 créditos por mês:

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. Configure notificações para o orçamento, de modo que você receba notificações quando for esperado que o uso de crédito exceda os limites de gastos.

   Consulte Notificações sobre orçamentos.

Após criar e configurar um orçamento personalizado, você pode criar uma função personalizada para permitir que administradores não pertencentes à conta monitorem os recursos e o uso do orçamento. Para obter mais informações, consulte Criação de uma função personalizada para monitorar um orçamento personalizado.

Para adicionar objetos ao seu novo orçamento, consulte Adição e remoção de objetos de um orçamento personalizado.

Exemplo de função personalizada¶

Conceda à função personalizada budget_admin a capacidade de modificar o orçamento my_budget no esquema budgets_db.budgets_schema:

• Conceda os privilégios necessários e a função de instância à função personalizada budget_admin para o orçamento my_budget no esquema budgets_db.budgets_schema:

  GRANT USAGE ON DATABASE budgets_db TO ROLE budget_admin;
  
  GRANT USAGE ON SCHEMA budget_db.budgets_schema TO ROLE budget_admin;
  
  GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
  
  GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE budget_admin;
  

  Copy

• Conceda o privilégio APPLYBUDGET aos objetos e às tags que serão adicionados ou removidos de um orçamento personalizado. Essa etapa é necessária para cada objeto ou tag que será adicionado ou removido.

  Por exemplo, para habilitar a função budget_admin para adicionar o banco de dados db1 ao orçamento personalizado my_budget, execute as seguintes instruções:

  GRANT USAGE ON DATABASE db1 TO ROLE budget_admin;
  
  GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
  

  Copy

Uso da Snowsight para adicionar ou remover tags de um orçamento personalizado¶

1. Faça login no Snowsight.

2. Selecione Admin » Cost Management.

3. Selecione Budgets.

4. Selecione o orçamento a ser editado.

5. No painel, selecione (ícone de edição).

6. Selecione + Tags & resources.

7. Expanda Tags e navegue até a tag que quer adicionar.

8. Faça uma das seguintes opções:

   • Se a tag tiver uma lista de valores permitidos, selecione um ou mais valores.

   • Se a tag puder ser definida com qualquer valor, especifique o valor.

9. Selecione Done.

Uso de comandos SQL para adicionar ou remover tags de um orçamento personalizado¶

A função usada para adicionar ou remover uma tag de um orçamento deve ter o privilégio APPLYBUDGET na tag. Para obter mais informações, consulte os exemplos na seção Criação de uma função personalizada para gerenciar um orçamento personalizado.

Para revisar a lista de tags que já estão no orçamento personalizado, chame o método <budget_name>!GET_LINKED_TAGS do orçamento. Por exemplo, para ver a lista de tags no orçamento my_budget no esquema budgets_db.budgets_schema, execute a seguinte instrução:

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_TAGS();

As tags devem ser adicionadas ou removidas de um orçamento por uma referência.

1. Você pode adicionar a tag cost_mgmt_db.tags.cost_center ao orçamento my_budget seguindo as etapas abaixo:

   1. Conceda o privilégio APPLYBUDGET na tag à função budget_admin executando a seguinte instrução:

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. Passe uma referência da tag cost_center ao método de instância ADD_TAG executando a instrução a seguir. O valor da tag é definido como finance.

      CALL budgets_db.budgets_schema.my_budget!ADD_TAG(
         SELECT SYSTEM$REFERENCE('TAG',
            'cost_mgmt_db.tags.cost_center',
            'SESSION',
            'applybudget'),
            'finance');
      

      Copy

      A função SYSTEM$REFERENCE cria uma referência da tag cost_center, com o privilégio APPLYBUDGET concedido na tag. Isso permite que o orçamento monitore os objetos que têm o par tag/valor especificado em sua conta. 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_TAG 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”).

2. Você pode remover a tag cost_center do orçamento my_budget seguindo estas etapas:

   1. Conceda o privilégio APPLYBUDGET no banco de dados à função budget_admin executando a seguinte instrução:

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. Remova a tag passando uma referência ao método de instância REMOVE_TAG:

      CALL budgets_db.budgets_schema.my_budget!REMOVE_TAG(
         SELECT SYSTEM$REFERENCE('TAG',
            'cost_mgmt_db.tags.cost_center',
            'SESSION',
            'applybudget'),
            'finance');
      

      Copy

Como usar o Snowsight para adicionar ou remover objetos de um orçamento personalizado¶

1. Faça login no Snowsight.

2. Selecione Admin » Cost Management.

3. Selecione Budgets.

4. Selecione o orçamento a ser editado.

5. No painel, selecione (ícone de edição).

6. Selecione + Tags & resources e os objetos que você quer adicionar ao orçamento personalizado.

   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.

   • Se você estiver adicionando objetos individuais diretamente, só poderá adicionar um objeto a um orçamento personalizado. Se esse for o caso, quando um objeto já estiver incluído em um orçamento personalizado, e você adicionar esse objeto a um segundo orçamento personalizado, o Budgets removerá o objeto do primeiro orçamento personalizado sem nenhum um aviso. Esse comportamento não se aplica ao uso de tags para adicionar objetos aos orçamentos. Um objeto com uma ou mais tags pode ser incluído em vários orçamentos personalizados se você usa tags para adicionar o objeto aos orçamentos.

7. Selecione Done.

Como usar os comandos SQL para adicionar ou remover objetos de um orçamento personalizado¶

A função usada para adicionar ou remover um objeto de um orçamento deve ter o privilégio APPLYBUDGET sobre o objeto. Para obter mais informações, consulte os exemplos na seção Criação de uma função personalizada para gerenciar um orçamento personalizado.

Para revisar a lista de objetos já no orçamento personalizado, chame o método <budget_name>!GET_LINKED_RESOURCES do orçamento. Por exemplo, para ver a lista de objetos no orçamento my_budget no esquema budgets_db.budgets_schema, execute a seguinte instrução:

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_RESOURCES();

A instrução retorna a seguinte saída:

+-------------+-----------------+-----------+-------------+---------------+
| RESOURCE_ID | NAME            | DOMAIN    | SCHEMA_NAME | DATABASE_NAME |
|-------------+-----------------+-----------+-------------+---------------|
|         326 | DB1             | DATABASE  | NULL        | NULL          |
|         157 | MY_WH           | WAREHOUSE | NULL        | NULL          |
+-------------+-----------------+-----------+-------------+---------------+

Os objetos devem ser adicionados ou removidos de um orçamento por referência.

1. Você pode adicionar a tabela t1 ao orçamento my_budget seguindo os seguintes passos:

   1. Conceda o privilégio APPLYBUDGET na tabela à função budget_admin executando a seguinte instrução:

      GRANT APPLYBUDGET ON TABLE t1 TO ROLE budget_admin;
      

      Copy

   2. Passe uma referência para a tabela t1 ao método de instância ADD_RESOURCE executando a seguinte instrução:

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

      Copy

      A função SYSTEM$REFERENCE cria uma referência para um objeto TABLE, t1, com o privilégio APPLYBUDGET concedido na tabela. Isso permite que o orçamento monitore o objeto especificado em sua conta. 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”).

      Nota

      Se você quiser adicionar um Snowflake Native App a um orçamento, ao chamar SYSTEM$REFERENCE, especifique 'DATABASE' (não 'APPLICATION') para o argumento object_type.

      Para uma lista completa de objetos e privilégios, consulte Tipos de objetos e privilégios suportados para referências.

      Nota

      Se você estiver adicionando objetos individuais diretamente, só poderá adicionar um objeto a um orçamento personalizado. Se esse for o caso, quando um objeto já estiver incluído em um orçamento personalizado, e você adicionar esse objeto a um segundo orçamento personalizado, o Budgets removerá o objeto do primeiro orçamento personalizado sem nenhum um aviso. Esse comportamento não se aplica ao uso de tags para adicionar objetos aos orçamentos. Um objeto com uma ou mais tags pode ser incluído em vários orçamentos personalizados se você usa tags para adicionar o objeto aos orçamentos.

2. Você pode remover o banco de dados db1 do orçamento my_budget seguindo os seguintes passos:

   1. Conceda o privilégio APPLYBUDGET no banco de dados à função budget_admin executando a seguinte instrução:

      GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
      

      Copy

   2. Remova o banco de dados passando uma referência ao método de instância REMOVE_RESOURCE:

      CALL budgets_db.budgets_schema.my_budget!REMOVE_RESOURCE(
         SELECT SYSTEM$REFERENCE('DATABASE', 'db1', 'SESSION', 'applybudget'));
      

      Copy