使用资源监视器¶

资源监视器属性¶

资源监视器是 Snowflake 中的一类对象，包含以下属性：

资源监视器的分配¶

可以在账户级别设置单个监视器，以控制账户中所有仓库的 Credit 使用量。

此外，可以将一个或多个仓库分配到资源监视器，从而控制所分配的每个仓库的 Credit 使用量。但请注意，仓库只能分配给账户级别以下的个别资源监视器。

在下图展示的场景中，在账户级别设置了一个资源监视器，并将各个仓库分配给另外两个资源监视器：

根据此图：

• 整个账户的 Credit 配额是在相应时间间隔（月、周等）期间为 5000，由资源监视器 1 控制；如果在此时间间隔内达到此配额，则会对全部五个仓库强制执行为资源监视器定义的操作（暂停、立即暂停 等）。

• 仓库 3 在此时间间隔内最多可以使用 1000 个 Credit。

• 在此时间间隔内，仓库 4 和仓库 5 最多可以使用总计 2500 个 Credit。

请注意，如果先达到账户的配额，则仓库 3、4、5 实际消耗的 Credit 可能会小于其配额。

仓库暂停与恢复¶

资源监视器的已用 Credit 体现了在指定时间间隔内，所分配的全部仓库以及在同一时间间隔内用于支持这些仓库的云服务所使用的 Credit 总和。如果监视器定义了 暂停 或 立即暂停 操作，并且所用 Credit 达到该操作的阈值，则分配给该监视器的任何仓库都将暂停，并且除非满足以下条件之一，否则无法恢复:

• 下一个时间间隔（如有）的起始时间取决于监视器的起始日期。

• 监视器的 Credit 配额提高。

• 暂停操作的 Credit 阈值提高。

• 仓库不再分配给该监视器。

• 监视器被丢弃。

仓库级别的资源监视器可以监控云服务的 Credit 使用量，但不能暂停其使用。在虚拟仓库暂停后，针对该仓库运行的后续查询仍可能会导致额外的云服务费用。有关云服务的 Credit 使用量的更多信息，请参阅 云服务 Credit 使用量。

资源监视器通知¶

当资源监视器达到 操作 阈值时，它会生成类似于下面这样的通知：

Resource Monitor MY_ACCOUNT_MONITOR has reached 50% of its MONTHLY
quota of 500 credits which has triggered a <action> action.

<action> 是以下操作之一：

• NOTIFY

• SUSPEND

• SUSPEND_IMMEDIATE

通知行为取决于资源监视器的 类型，以及是否为个别用户 启用了 通知。通知的发送方式如下：

• 对于 仓库 监视器，将向以下用户发送通知：

  • 已启用资源监视器通知的所有账户管理员。

  • 资源监视器通知列表中的非管理员用户。

• 对于 账户 监视器，将向以下用户发送通知：

  • 具有资源监视器的 OWNERSHIP 权限的账户管理员（如已启用通知）。

  • All account administrators who have enabled notifications using Snowsight.

  备注

  非管理员用户不能添加到 账户 监视器的通知列表中。

适用于资源监视器的 DDL¶

Snowflake 提供以下 DDL 命令，用于创建和使用/管理资源监视器：

• CREATE RESOURCE MONITOR

• ALTER RESOURCE MONITOR

• SHOW RESOURCE MONITORS

• DROP RESOURCE MONITOR

此外，以下 DDL 命令可用于将资源监视器分配给仓库，并查看仓库是否已分配给监视器：

• CREATE WAREHOUSE 或 ALTER WAREHOUSE

• SHOW WAREHOUSES

资源监视器的访问控制权限¶

默认情况下，资源监视器只能由账户管理员创建，因此只能由其查看和维护。

但是，已获授特定资源监视器以下权限的角色可按需使用 SQL，来查看和修改资源监视器：

• MONITOR

• MODIFY

有关更多信息，请参阅 访问控制权限 和 GRANT <privileges> ... TO ROLE。

Note that only account administrators can view and manage resource monitors via the Snowsight.

启用通知接收¶

您必须首先在 Web 界面中启用通知并验证您的电子邮件，然后才能接收来自资源监视器的任何通知。

Snowsight:

若要启用通知，请按照下列步骤操作：

1. 如果您尚未验证电子邮件地址，请进行验证。有关如何验证电子邮件地址的说明，请参阅 验证电子邮件地址。

2. 选择您的用户名，然后选择 Profile

3. 对于 Notifications，选择 Enable notifications from resource monitors。

   备注

   • 如果您尚未验证电子邮件地址，则在验证电子邮件之前，Notifications 选项不可用。

   • 在 Notifications 中，Enable notifications from resource monitors 选项仅在以下情况下适用于具有 ACCOUNTADMIN 角色的用户：

     • 如果为账户分配了资源监视器，且账户管理员具有账户监视器的 OWNERSHIP 权限。

     • 如果账户中有仓库监视器。所有账户管理员都可以接收针对仓库监视器的通知。

创建资源监视器¶

资源监视器可以通过 Web 界面或 SQL 创建；但只有账户管理员（即具有 ACCOUNTADMIN 角色的用户）才能创建资源监视器。

A resource monitor can't be assigned more than 500 warehouses.

修改资源监视器¶

您可以修改现有资源监视器的以下属性：

• 增加或减少监视器的 Credit。

• 为监视器自定义计划（频率、开始时间戳和结束时间戳）。

• 添加或移除操作，或者修改现有操作的阈值百分比。

• 如果监视器正在监控您的账户，请将其改为监视单个仓库。

• 如果监视器正在监控单个仓库：

  • 从列表中添加或移除仓库。

  • 将其改为监控您的账户。

可通过 Web 界面或 SQL 修改资源监视器。

Snowsight:

1. Sign in to Snowsight.

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

3. 选择 Resource Monitors，然后选择一个资源监视器。

4. 选择右上角的 More 菜单 (...)。选择 Edit。

SQL:

• 要更改配额、自定义计划或添加/移除/修改操作，请执行 ALTER RESOURCE MONITOR 语句。

  例如，要将资源监视器的 Credit 配额 limit1 上调至 3000，请执行以下语句：

  ALTER RESOURCE MONITOR limit1 SET CREDIT_QUOTA=3000;
  

  Copy

  有关更多示例，请参阅 示例。

• 要更改监视器类型，请执行 ALTER WAREHOUSE 或 ALTER ACCOUNT 语句。

  例如，要更改当前监控仓库的资源监视器 my_rm 以监控账户 my_account，请执行以下步骤：

  1. 查找所有仓库资源监视器 my_rm 正在监控的所有仓库。检查 my_rm 的 resource_monitor 列：

     SHOW WAREHOUSES;
     

     Copy

     返回以下结果：

     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     | name   | state     | type     | size    | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on                    | resumed_on                    | updated_on                    | owner        | comment | resource_monitor | actives | pendings | failed | suspended | uuid       | budget | owner_role_type |
     |--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------|
     | MY_WH1 | STARTED   | STANDARD | X-Small |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:37:36.223 -0800 | 2024-01-17 14:37:36.325 -0800 | 2024-01-17 14:47:49.854 -0800 | MY_ROLE      |         | null             |       0 |        0 |      0 |         1 | 1222706972 | NULL   | ROLE            |
     | MY_WH2 | SUSPENDED | STANDARD | X-Small |       0 |      0 | N          | Y          |          600 | true        |           |              |           |       | 2023-12-20 13:50:50.972 -0800 | 2024-01-17 14:28:39.170 -0800 | 2024-01-17 14:37:57.560 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         1 | 1222706948 | NULL   | ROLE            |
     | MY_WH3 | SUSPENDED | STANDARD | Small   |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:26:26.911 -0800 | 2024-01-17 14:33:39.260 -0800 | 2024-01-17 14:38:31.192 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         2 | 1222706960 | NULL   | ROLE            |
     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     

     资源监视器 my_rm 正在监控 my_wh2 和 my_wh3 这两个仓库。

  2. 通过执行以下语句，移除两个仓库的资源监视器：

     ALTER WAREHOUSE my_wh2 UNSET RESOURCE_MONITOR;
     
     ALTER WAREHOUSE my_wh3 UNSET RESOURCE_MONITOR;
     

     Copy

  3. 通过执行以下语句，更改资源监视器以监控账户：

     ALTER ACCOUNT my_account SET RESOURCE_MONITOR = my_rm;
     

     Copy

向非管理员用户发送资源监视器通知¶

非管理员用户只能接收 仓库监视器 的电子邮件通知。每个非管理员用户都必须有一个经验证的电子邮件地址。您可以使用 CREATE RESOURCE MONITOR 或 ALTER RESOURCE MONITOR 命令，向仓库监视器添加最多五名非管理员用户。

例如，要将用户 user1 和 user2 添加至仓库监视器 my_warehouse_rm，请执行以下语句：

ALTER RESOURCE MONITOR my_warehouse_rm
  SET NOTIFY_USERS = (USER1, USER2);

有关更多信息，请参阅 ALTER RESOURCE MONITOR 主题中的 NOTIFY_USERS 参数 和 使用说明。

要在使用 SQL 创建资源监视器时，将非管理员用户添加到资源监视器的通知列表中，请参阅 CREATE RESOURCE MONITOR。

为账户设置资源监视器¶

可通过 Web 界面或 SQL 为您的账户设置资源监视器。

Snowsight:

在创建资源监视器时，您可将监视器类型设置为账户。有关更多信息，请参阅 创建资源监视器。

SQL:

在 SQL 中，此任务分两步执行：

1. 使用 CREATE RESOURCE MONITOR 命令来创建资源监视器（如果尚不存在）。

   如果资源监视器确实存在，要更改仓库级别资源监视器以监控账户，请参阅 “修改资源监视器”部分中的示例。

2. 使用 ALTER ACCOUNT 命令，将您创建的资源监视器设置为您账户的监视器。

   例如，要将账户资源监视器设置为 my_account_rm，请执行以下语句：

   USE ROLE ACCOUNTADMIN;
   
   CREATE RESOURCE MONITOR my_account_rm WITH CREDIT_QUOTA=10000
     TRIGGERS ON 100 PERCENT DO SUSPEND;
   
   ALTER ACCOUNT SET RESOURCE_MONITOR = my_account_rm;
   

   Copy

要将现有资源监视器的监视器类型从仓库监视器更改为账户监视器，请参阅 “修改资源监视器”部分中的示例。

要查看是否已为账户设置资源监视器，请使用 Web 界面或 SHOW RESOURCE MONITORS 命令。资源监视器的 LEVEL 列显示它是为账户设置的，还是为单独的仓库设置的。

将仓库分配给资源监视器¶

可通过 Web 界面或 SQL 将仓库分配给现有资源监视器。

Snowsight:

1. Sign in to Snowsight.

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

3. 选择 Resource Monitors，然后选择一个资源监视器。

4. 选择右上角的 More 菜单 (...)。选择 Edit。

5. 如果 Monitor Type 是 Account，请选择 Warehouse。

6. 选择 Warehouse，以选择要监控的仓库。

SQL:

使用 ALTER WAREHOUSE 命令，为资源监视器分配一个仓库。

例如，若要使用资源监视器 my_rm 监控仓库 my_wh，请执行以下语句：

ALTER WAREHOUSE my_wh SET RESOURCE_MONITOR = my_rm;

Copy

查看资源监视器¶

可通过 Web 界面或 SQL 查看资源监视器。

Snowsight:

1. Sign in to Snowsight.

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

3. 选择 Resource Monitors，查看您已获授 MODIFY 或 MONITOR 权限的角色对应的资源监视器列表。账户管理员用户可以查看所有资源监视器。

4. 选择一个资源监视器即可查看有关资源监视器设置、当前 Credit 使用量以及具有资源监视器权限的角色列表的详细信息。

5. Select Account » Resource Monitors.

SQL:

使用 ACCOUNTADMIN 角色或已获授资源监视器 MONITOR 或 MODIFY 权限的角色，执行一条 SHOW RESOURCE MONITORS 语句。

此外，无论使用任何角色，您都可以执行 SHOW WAREHOUSES 语句，来查看该角色拥有的仓库（或者该角色已获授 USAGE 权限的仓库）。输出包括仓库分配到的资源监视器（如有）。

复制资源监视器¶

可以使用 复制或故障转移组 将资源监视器从源账户复制到目标账户。有关更多信息，请参阅 资源监视器复制。