Como trabalhar com monitores de recursos¶

Propriedades do monitor de recursos¶

Um monitor de recursos é um objeto de primeira classe no Snowflake, que consiste nas seguintes propriedades.

Atribuição de monitores de recursos¶

Um único monitor pode ser definido no nível de conta para controlar o uso de créditos para todos os warehouses em sua conta.

Além disso, um ou mais warehouses podem ser atribuídos a um monitor de recursos, controlando assim o uso de crédito para cada warehouse atribuído. Observe, entretanto, que um warehouse só pode ser atribuído a um único monitor de recursos abaixo do nível da conta.

O diagrama a seguir ilustra um cenário no qual um monitor de recursos é definido no nível de conta e warehouses individuais são atribuídos a dois outros monitores de recursos:

Com base neste diagrama:

• A cota de crédito para toda a conta é 5000 para o intervalo (mês, semana, etc.), como controlado pelo Monitor de recursos 1; se essa cota for atingida dentro do intervalo, as ações definidas para o monitor de recursos (Suspender, Suspender imediatamente, etc.) são aplicadas para todos os cinco warehouses.

• O warehouse 3 pode consumir um máximo de 1000 créditos dentro do intervalo.

• Os warehouses 4 e 5 podem consumir um total máximo combinado de 2500 créditos dentro do intervalo.

Observe que os créditos reais consumidos pelos warehouses 3, 4, e 5 podem ser menores que suas cotas se a cota para a conta for atingida primeiro.

Suspensão e retomada do warehouse¶

Os créditos usados para um monitor de recursos refletem a soma dos créditos consumidos por todos os warehouses designados dentro do intervalo especificado, juntamente com os serviços de nuvem usados para oferecer suporte a esses warehouses durante o mesmo intervalo. Se um monitor tiver uma ação Suspender ou Suspender imediatamente definida e seus créditos utilizados atingirem o limite para a ação, quaisquer warehouses atribuídos ao monitor são suspensos e não podem ser retomados até que uma das seguintes condições seja satisfeita:

• O próximo intervalo, se houver, começa como ditado pela data de início do monitor.

• A cota de crédito para o monitor é aumentada.

• O limite de crédito para a ação de suspensão é aumentado.

• Os warehouses não estão mais atribuídos ao monitor.

• O monitor é descartado.

Notificações do monitor de recursos¶

Quando um monitor de recursos atinge o limite para uma ação, ele gera uma das seguintes notificações, com base na ação executada:

• Os warehouses atribuídos serão suspensos após a conclusão de todas as consultas em andamento.

• Todas as consultas em andamento nos warehouses atribuídos serão canceladas e os warehouses suspensos imediatamente.

• Foi atingido um limite, mas nenhuma ação foi realizada.

A notificação é enviada a todos os administradores de conta que permitiram o recebimento de notificações e a usuários não administradores na lista de notificação para um monitor de warehouse. Usuários não administradores não podem ser adicionados à lista de notificações de um monitor de conta.

DDL para monitores de recursos¶

O Snowflake fornece os seguintes comandos DDL para criar e usar/gerenciar monitores de recursos:

• CREATE RESOURCE MONITOR

• ALTER RESOURCE MONITOR

• SHOW RESOURCE MONITORS

• DROP RESOURCE MONITOR

Além disso, os seguintes comandos DDL podem ser usados para atribuir um monitor de recursos a um warehouse e ver se um warehouse está atribuído a um monitor:

• CREATE WAREHOUSE ou ALTER WAREHOUSE

• SHOW WAREHOUSES

Privilégios de controle de acesso para monitores de recursos¶

Por padrão, os monitores de recursos só podem ser criados por administradores de conta e, portanto, só podem ser vistos e mantidos por eles.

Entretanto, as funções que receberam os seguintes privilégios para monitores de recursos específicos podem visualizar e modificar o monitor de recursos conforme necessário usando SQL:

• MONITOR

• MODIFY

Para obter mais informações, consulte Privilégios de controle de acesso e GRANT <privilégios>.

Observe que somente administradores de conta podem visualizar e gerenciar monitores de recursos através da Classic Console.

Ativação do recebimento de notificações¶

Antes de poder receber notificações de monitores de recursos, você deve ativar as notificações na interface da web e verificar seu e-mail.

Snowsight:

Para ativar notificações, siga estas etapas:

1. Verifique seu endereço de e-mail, caso ainda não tenha feito isso. Para obter instruções sobre como verificar seu endereço de e-mail, consulte Verificação de seu endereço de e-mail.

2. Selecione seu nome de usuário e selecione Profile

3. Para Notifications, selecione Enable notifications from resource monitors.

   Nota

   • Se você não tiver verificado seu endereço de e-mail, a opção Notifications não estará disponível até que você verifique seu e-mail.

   • Em Notifications, a opção Enable notifications from resource monitors está disponível apenas para usuários com a função ACCOUNTADMIN.

Classic Console:

Para ativar notificações, siga estas etapas:

1. Verifique seu endereço de e-mail, caso ainda não tenha feito isso. Para obter instruções sobre como verificar seu endereço de e-mail, consulte Verificação de seu endereço de e-mail no console clássico.

2. Selecione o menu suspenso ao lado do seu nome no canto superior direito e selecione Preferences » Notifications.

3. Selecione uma das opções.

Criação de monitores de recursos¶

Monitores de recursos podem ser criados através da interface da Web ou de SQL; entretanto, somente administradores de conta (ou seja, usuários com a função ACCOUNTADMIN) podem criar monitores de recursos.

Modificação de um monitor de recursos¶

Você pode modificar as seguintes propriedades para um monitor de recursos existente:

• Aumente ou diminua a cota de crédito para o monitor.

• Personalize o cronograma (frequência, horário de início e fim do carimbo de data/hora) para o monitor.

• Adicione ou remova ações, ou modifique as porcentagens de limite para as ações existentes.

• Se o monitor estiver monitorando sua conta, converta-o para monitorar warehouses individuais.

• Se o monitor estiver monitorando warehouses individuais:

  • Adicionar ou remover warehouses da lista.

  • Converta-o para monitorar sua conta.

Os monitores de recursos podem ser modificados através da interface da Web ou SQL.

Snowsight:

Nota

Você não pode usar Snowsight para alterar o tipo de monitor de recursos de um warehouse para uma conta. Em vez disso, use SQL. Consulte o exemplo na seção SQL.

1. Entre em Snowsight e navegue até Admin » Cost Management.

2. Selecione Resource Monitors e selecione um monitor de recursos.

3. Selecione o menu More (…) no canto superior direito. Selecione Edit.

Classic Console:

1. Selecione Account » Resource Monitors.

2. Selecione um monitor de recursos.

3. Selecione Edit.

SQL:

• Para alterar a cota, personalizar a programação ou adicionar/remover/modificar ações, execute uma instrução ALTER RESOURCE MONITOR.

  Por exemplo, para aumentar a cota de crédito do monitor de recursos limit1 para 3000, execute a seguinte instrução:

  ALTER RESOURCE MONITOR limit1 SET CREDIT_QUOTA=3000;
  

  Copy

  Para obter mais exemplos, consulte Exemplos.

• Para alterar o tipo de monitor, execute uma instrução ALTER WAREHOUSE ou ALTER ACCOUNT.

  Por exemplo, para alterar o monitor de recursos my_rm que atualmente monitora warehouses para monitorar a conta my_account, execute as seguintes etapas:

  1. Encontre todos os warehouses que o monitor de recursos my_rm está monitorando. Verifique a coluna resource_monitor para my_rm:

     SHOW WAREHOUSES;
     

     Copy

     Retorna os seguintes resultados:

     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     | 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            |
     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     

     O monitor de recursos my_rm está monitorando dois warehouses my_wh2 e my_wh3.

  2. Remova o monitor de recursos de ambos os warehouses executando as seguintes instruções:

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

     Copy

  3. Altere o monitor de recursos para monitorar a conta executando a seguinte instrução:

     ALTER ACCOUNT my_account SET RESOURCE_MONITOR = my_rm;
     

     Copy

Envio de notificações do monitor de recursos para usuários não administradores¶

Usuários não administradores podem receber notificações por e-mail para monitores de recursos que monitoram warehouses. Cada usuário não administrador deve ter um endereço de e-mail verificado. É possível adicionar até cinco usuários não administradores a um monitor do warehouse usando o comando CREATE RESOURCE MONITOR ou ALTER RESOURCE MONITOR.

Por exemplo, para adicionar usuários user1 e user2 ao monitor do warehouse my_warehouse_rm, execute a seguinte instrução:

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

Para obter mais informações, consulte os parâmetros NOTIFY_USERS e Notas de uso no tópico ALTER RESOURCE MONITOR.

Para adicionar usuários não administradores à lista de notificações de um monitor de recursos ao criar um monitor de recursos usando SQL, consulte CREATE RESOURCE MONITOR.

Configuração de um monitor de recursos para sua conta¶

Um monitor de recursos pode ser definido para sua conta através da interface da Web ou SQL.

Snowsight:

Você pode definir o tipo de monitor como conta ao criar um monitor de recursos. Para obter mais informações, consulte Criação de monitores de recursos.

Você não pode usar Snowsight para alterar o tipo de monitor de recursos de um warehouse para uma conta. Em vez disso, use SQL. Consulte o exemplo na seção SQL.

Classic Console:

Você pode definir o tipo de monitor como Account ao criar ou modificar um monitor de recursos:

• Para obter mais informações sobre a criação de monitores de recursos, consulte Criação de monitores de recursos.

• Para obter mais informações sobre a modificação de monitores de recursos, consulte Modificação de um monitor de recursos.

SQL:

No SQL, esta tarefa é executada em duas etapas:

1. Use o comando CREATE RESOURCE MONITOR para criar o monitor de recursos (se ele ainda não existir).

   Se o monitor de recursos existir, para alterar um monitor de recursos no nível do warehouse para monitorar uma conta, consulte o exemplo na seção Modificação de um monitor de recursos.

2. Use o comando ALTER ACCOUNT para definir o monitor de recursos que você criou como o monitor para sua conta.

   Por exemplo, para definir o monitor de recursos da conta como my_account_rm, execute as seguintes instruções:

   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

Para alterar o tipo de monitor de um monitor de recursos existente de um monitor de warehouse para um monitor de conta, consulte o exemplo na seção Modificação de um monitor de recursos.

Para ver se um monitor de recursos está definido para sua conta, use a interface da Web ou o comando SHOW RESOURCE MONITORS. A coluna LEVEL para um monitor de recursos mostra se ele está definido para sua conta ou para warehouses individuais.

Atribuição de warehouses a um monitor de recursos¶

Os warehouses podem ser atribuídos a um monitor de recursos existente através da interface da Web ou SQL.

Snowsight:

1. Entre em Snowsight e navegue até Admin » Cost Management.

2. Selecione Resource Monitors e selecione um monitor de recursos.

3. Selecione o menu More (…) no canto superior direito. Selecione Edit.

4. Se Monitor Type for Account, selecione Warehouse.

5. Selecione Warehouse para escolher os warehouses a serem monitorados.

Classic Console:

1. Selecione Account » Resource Monitors.

2. Selecione um monitor de recursos.

3. Selecione Edit.

4. Se o monitor ainda não tiver warehouses atribuídos, selecione Monitor Level e, em seguida, selecione Warehouse.

5. Selecione Warehouse e escolha os warehouses a serem monitorados.

SQL:

Use o comando ALTER WAREHOUSE para atribuir um warehouse a um monitor de recursos.

Por exemplo, para monitorar o warehouse my_wh com o monitor de recursos my_rm, execute a seguinte instrução:

ALTER WAREHOUSE my_wh SET RESOURCE_MONITOR = my_rm;

Copy

Visualização de monitores de recursos¶

Os monitores de recursos podem ser visualizados na interface da Web ou SQL.

Snowsight:

1. Entre em Snowsight e navegue até Admin » Cost Management.

2. Selecione Resource Monitors para ver uma lista de monitores de recursos para os quais sua função recebeu o privilégio MODIFY ou MONITOR. Os usuários administradores de conta podem ver todos os monitores de recursos.

3. Selecione um monitor de recursos para visualizar informações detalhadas sobre configurações do monitor de recursos, uso atual de crédito e uma lista de funções com privilégios no monitor de recursos.

Classic Console:

Nota

Somente usuários com a função ACCOUNTADMIN podem visualizar os monitores de recursos usando Classic Console.

1. Selecione Account » Resource Monitors.

SQL:

Usando a função ACCOUNTADMIN ou uma função com o privilégio MONITOR ou MODIFY no monitor de recursos, execute uma instrução SHOW RESOURCE MONITORS.

Além disso, usando qualquer função, você pode executar uma instrução SHOW WAREHOUSES para visualizar os warehouses de propriedade da função (ou para os quais a função recebeu o privilégio USAGE). A saída inclui o monitor de recursos, se houver, para o qual o warehouse está atribuído.

Replicação de monitores de recursos¶

Os monitores de recursos podem ser replicados de uma conta de origem para contas de destino usando um grupo de replicação ou failover. Para obter mais informações, consulte Replicação de monitores de recursos.