自定义预算¶

标签继承¶

向预算中添加标签会跟踪所有带有该标签的对象，包括从父对象继承该标签的对象。例如，如果数据库有标签，则数据库中的表将继承该标签，并将由预算进行跟踪。由于预算基于标签/值对跟踪使用情况，因此如果您在表级别上覆盖标签的值，则预算跟踪与表相关的使用情况可能会发生变化。例如，假设您的预算用于跟踪带有标签 team = 'eng' 的对象。如果数据库有标签 team = 'eng'，但数据库中的表有标签 team = 'IT'，则预算不会监控与该表相关的成本。

在预算的上下文中，标签不是从账户继承的，因为账户预算旨在履行该用例。

有关更多信息，包括如何覆盖标签值，请参阅 标签继承。

跟踪具有多个预算的对象¶

多个预算可以添加相同的标签/值对，这意味着超过预算的预算可以跟踪同一对象的 Credit 使用量。例如，假设您将标签 cost_center = 'eng' 添加到 budget_1 和 budget_2 中。由于带有标签的仓库 cost_center = 'eng' 会消耗 Credit，它将计入 budget_1 和 budget_2 的 Credit 限制。

如果一个对象有多个标签，也可以通过多个预算来跟踪该对象。例如，假设一个仓库有两个标签：cost_center = 'finance' 和 stage = 'dev'。您可以创建一个可以跟踪 cost_center = 'finance' 的预算，以及一个可以跟踪 stage = 'dev' 的预算。仓库消耗的 Credit 将计入两个预算的 Credit 限制。

限制和注意事项¶

使用标签监控对象时，请记住以下几点：

• 当您更改对象的标签时，更改最多可能需要六个小时才能反映在使用标签的预算中。

• Currently, alerts cannot be monitored with tags. You must add them individually.

• 当月前两天内标签的变更会反映在前一个月的使用量中。

创建自定义角色以创建预算¶

您可以使用自定义角色在账户中创建预算。有关创建自定义预算必须授予角色的权限和角色的完整列表，请参阅 Budgets 角色和权限。

以下示例创建一个名为 budget_owner 的角色，并授予所需的角色和权限，以在架构 budgets_db.budgets_schema 中创建自定义预算。该示例必须使用 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;

如果要启用预算所有者以外的角色来修改自定义预算的设置，则可以创建具有修改权限的自定义角色。有关更多信息，请参阅 创建自定义角色以管理自定义预算。

使用 Snowsight 创建自定义预算¶

1. Sign in to Snowsight.

2. In the navigation menu, select Admin » Cost management.

3. Select the Budgets tab.

4. Select + Budget.

5. 在 Basic Information 页面上，完成以下步骤：

   1. 从 Location to store 下拉列表中，选择要在其中创建预算的数据库和架构名称。

   2. 在 Name 字段中，指定自定义预算的名称。

   3. 在 Budget (credits per month) 字段中，指定预算的支出限额。

   4. 若要缩短 预算刷新间隔 以便更严密地监控支出，请选择 Enable low latency budget。

   5. 在 Threshold 字段中，指定预算限额的百分比。当 Snowflake 确定支出将超过预算限额的这一百分比时，系统会发送通知。

   6. In the Notify field, enter email addresses to receive notification emails.

      备注

      添加以用于接收预算通知的每个电子邮件地址都必须 经过验证。如果列表中的电子邮件地址 未 经过验证，则通知电子邮件设置会失败。

   7. Select Next.

6. On the Budget scope page, add the objects that you want to add to the custom budget.

   • 如果您正在 使用标签 来跟踪对象的消耗情况，请完成以下步骤：

     1. Select the Tags on resources drop-down list.

     2. 找到相应的标签，将其展开并选择一个或多个值。

     3. 选择 Done。

   • 如果要将单个对象添加到预算中，请完成以下步骤：

     1. Select the Resources drop-down list.

     2. 选择一个或多个对象。

     3. 选择 Done。

        备注

        If you are directly adding individual objects, you can only add an object to one custom budget. In this case, if an object is currently included in one custom budget and you add that object to a second custom budget, Budgets removes the object from the first custom budget without issuing a warning.

        此行为不适用于使用标签将对象添加到预算中；如果您使用标签将对象添加到预算中，则具有一个或多个标签的对象可以包含在多个自定义预算中。

7. Select Create.

创建和设置自定义预算后，您可以创建自定义角色，使非账户管理员能够监控预算资源和使用情况。有关更多信息，请参阅 创建自定义角色以监控自定义预算。

使用 SQL 命令创建自定义预算¶

创建自定义预算，然后设置支出限额和通知电子邮件地址。

1. 查看账户中的现有预算：

   备注

   以下语句会返回您具有访问权限的预算。只有具有 ACCOUNTADMIN 角色的用户才能查看账户中的所有预算。

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. 使用 CREATE BUDGET 命令在 budgets_db.budgets_schema 中创建预算 my_budget

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

   Copy

3. 设置每月支出限额。例如，将支出限额设置为每月 500 个 Credit：

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. 设置预算通知，以便在 Credit 使用量预计超过支出限额时接收通知。

   请参阅 预算通知。

创建和设置自定义预算后，您可以创建自定义角色，使非账户管理员能够监控预算资源和使用情况。有关更多信息，请参阅 创建自定义角色以监控自定义预算。

要将对象添加到新预算，请参阅 从自定义预算中添加或移除对象。

自定义角色示例¶

授予自定义角色 budget_admin 在架构 budgets_db.budgets_schema 中监控和修改预算 my_budget 的能力：

• 为架构 budgets_db.budgets_schema 中预算 my_budget 的自定义角色 budget_admin 授予所需的权限和实例角色：

  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

• 向要在其中添加或移除自定义预算的对象和标签授予 APPLYBUDGET 权限。添加或移除每个对象或标签都需要执行此步骤。

  例如，要启用角色 budget_admin，以将数据库 db1 添加到自定义预算 my_budget，请执行以下语句：

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

  Copy

使用 Snowsight 从自定义预算中添加或移除标签¶

1. Sign in to Snowsight.

2. In the navigation menu, select Admin » Cost management.

3. 选择 Budgets。

4. 选择要编辑的预算。

5. 在仪表板中，选择 |sf-pencil-icon|（编辑图标）。

6. 选择 + Tags & resources。

7. 展开 Tags 并导航到要添加的标签。

8. 执行下列操作之一：

   • 如果标签包含 允许值列表，请选择一个或多个值。

   • 如果可以将标签设置为任何值，请指定该值。

9. 选择 Done。

使用 SQL 命令从自定义预算中添加或移除标签¶

用于从预算中添加或移除标签的角色必须具有该标签的 APPLYBUDGET 权限。有关更多信息，请参阅 创建自定义角色以管理自定义预算 部分中的示例。

要查看已在自定义预算中的标签列表，请调用预算的 <budget_name>!GET_LINKED_TAGS 方法。例如，要查看 budgets_db.budgets_schema 架构中预算 my_budget 中的标签列表，请执行以下语句：

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_TAGS();

标签必须通过 引用 添加到预算或从其中移除。

1. 您可以按照以下步骤操作，将标签 cost_mgmt_db.tags.cost_center 添加到预算 my_budget：

   1. 通过执行以下语句将标签的 APPLYBUDGET 权限授予角色 budget_admin：

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. 通过执行以下语句，将对标签 cost_center 的引用传递给 ADD_TAG 实例方法：标签的值设置为 finance。

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

      Copy

      SYSTEM$REFERENCE 函数创建对 cost_center 标签的引用，授予对标签的 APPLYBUDGET 权限。这使预算能够监控在您的账户中具有指定标签/值对的对象。函数的第三个参数指定引用的作用域，在本例中，“SESSION”创建具有会话作用域的引用。传递给预算的 ADD_TAG 方法的引用可以使用任意瞬态引用作用域（也就是说，第三个参数可以是“SESSION”或“CALL”）创建。

2. 您可以按照以下步骤操作，从预算 my_budget 中移除标签 cost_center：

   1. 通过执行以下语句将数据库的 APPLYBUDGET 权限授予角色 budget_admin：

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. 通过向 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

使用 Snowsight 从自定义预算中添加或移除对象¶

1. Sign in to Snowsight.

2. In the navigation menu, select Admin » Cost management.

3. 选择 Budgets。

4. 选择要编辑的预算。

5. 在仪表板中，选择 |sf-pencil-icon|（编辑图标）。

6. 选择 + Tags & resources，然后选择要添加到自定义预算的对象。

   备注

   • 当您选择数据库或架构时，数据库或架构中包含的所有 受支持对象 （例如，表）也会添加到预算中。

   • If you are directly adding individual objects, you can only add an object to one custom budget. In this case, if an object is currently included in one custom budget and you add that object to a second custom budget, Budgets removes the object from the first custom budget without issuing a warning.

     此行为不适用于使用标签将对象添加到预算中；如果您使用标签将对象添加到预算中，则具有一个或多个标签的对象可以包含在多个自定义预算中。

7. 选择 Done。

使用 SQL 命令从自定义预算中添加或移除对象¶

用于从预算中添加或移除对象的角色必须具有该对象的 APPLYBUDGET 权限。有关更多信息，请参阅 创建自定义角色以管理自定义预算 部分中的示例。

要查看已在自定义预算中的对象列表，请调用预算的 <budget_name>!GET_LINKED_RESOURCES 方法。例如，要查看 budgets_db.budgets_schema 架构中预算 my_budget 中的对象列表，请执行以下语句：

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_RESOURCES();

该语句返回以下输出：

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

对象必须通过 引用 添加到预算或从其中移除。

1. 您可以按照以下步骤操作，将表 t1 添加到预算 my_budget：

   1. 通过执行以下语句将表的 APPLYBUDGET 权限授予角色 budget_admin：

      GRANT APPLYBUDGET ON TABLE t1 TO ROLE budget_admin;
      

      Copy

   2. 通过执行以下语句，将对表 t1 的引用传递给 ADD_RESOURCE 实例方法：

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

      Copy

      SYSTEM$REFERENCE 函数创建对 TABLE 对象 t1 的引用，授予对表的 APPLYBUDGET 权限。这使预算能够监控您的账户中的指定对象。函数的第三个参数指定引用的作用域，在本例中，“SESSION”创建具有会话作用域的引用。传递给预算的 ADD_RESOURCE 方法的引用可以使用任意瞬态引用作用域（也就是说，第三个参数可以是“SESSION”或“CALL”）创建。

      备注

      如果您想在预算中添加 Snowflake Native App，当您调用 SYSTEM$REFERENCE 时，请为 object_type 实参指定 'DATABASE'``（而不是 ``'APPLICATION'）。

      有关对象和权限的完整列表，请参阅 支持的引用对象类型和权限。

      备注

      If you are directly adding individual objects, you can only add an object to one custom budget. In this case, if an object is currently included in one custom budget and you add that object to a second custom budget, Budgets removes the object from the first custom budget without issuing a warning.

      此行为不适用于使用标签将对象添加到预算中；如果您使用标签将对象添加到预算中，则具有一个或多个标签的对象可以包含在多个自定义预算中。

2. 您可以按照以下步骤操作，从预算 my_budget 中移除数据库 db1：

   1. 通过执行以下语句将数据库的 APPLYBUDGET 权限授予角色 budget_admin：

      GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
      

      Copy

   2. 通过向 REMOVE_RESOURCE 实例方法传递引用来移除数据库：

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

      Copy