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 monitor pode ser atribuído a um ou mais warehouses, controlando assim o uso de créditos 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.

Criação de um monitor de recursos com um cronograma padrão¶

Para criar um monitor de recursos que utilize o cronograma padrão (ou seja, inicia o monitoramento imediatamente e reinicia no primeiro dia de cada mês civil):

Classic Console

1. Use a função ACCOUNTADMIN do sistema.

2. Clique em Account » Resource Monitors » Create Resource Monitor.

3. Digite um nome e uma cota.

4. Especifique se o monitor de recursos será usado para monitorar sua conta ou warehouses individuais.

5. Insira um limite para pelo menos uma das ações de suspensão. Você também pode especificar até cinco ações de notificação que simplesmente enviam alertas sem suspender nenhum warehouse.

SQL

No SQL, esta tarefa é executada em duas etapas:

1. Execute um comando CREATE RESOURCE MONITOR, mas não especifique nenhuma propriedade de agendamento.

2. Execute um comando ALTER WAREHOUSE para atribuir warehouses ao monitor de recursos ou um comando ALTER ACCOUNT para definir o monitor de recursos para a conta.

Por exemplo:

• Para criar um monitor que começa a monitorar imediatamente, reinicia no início de cada mês e suspende o warehouse atribuído quando os créditos usados atingem 100% da cota de crédito:

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
    TRIGGERS ON 100 PERCENT DO SUSPEND;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  Copy

  A ação SUSPEND aguarda as consultas atualmente em execução terminarem antes de suspender o warehouse. Isto significa que uma consulta começou antes que o disparador fosse concluído e o warehouse consumisse créditos, mesmo depois que a cota foi atingida.

• Para criar um monitor que seja semelhante ao primeiro exemplo, mas que suspenda em 90% e suspenda imediatamente em 100% para evitar que todos os warehouses da conta consumam créditos após a cota ter sido atingida:

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
    TRIGGERS ON 90 PERCENT DO SUSPEND
             ON 100 PERCENT DO SUSPEND_IMMEDIATE;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  Copy

  Neste exemplo, uma notificação é gerada e os warehouses atribuídos são suspensos quando 90% de uso é alcançado, o que impede os warehouses de executar quaisquer novas consultas, mas permite que as consultas atualmente em execução sejam concluídas. Se os warehouses atribuídos atingirem 100% de uso, uma notificação é gerada e os warehouses são suspensos imediatamente, cancelando todas as consultas atualmente em execução.

• Para criar um monitor que seja semelhante ao primeiro exemplo, mas que permita que o warehouse atribuído exceda a cota em 10% e também inclua duas ações de notificação para alertar os administradores de conta uma vez que os créditos utilizados tenham atingido a metade e os três quartos da cota:

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
     TRIGGERS ON 50 PERCENT DO NOTIFY
              ON 75 PERCENT DO NOTIFY
              ON 100 PERCENT DO SUSPEND
              ON 110 PERCENT DO SUSPEND_IMMEDIATE;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  Copy

  Neste exemplo:

  • Quando 50% e 75% de uso são atingidos, uma notificação de alerta é enviada a todos os administradores de conta que ativaram as notificações, mas nenhuma outra ação é executada.

  • Quando 100% de uso é atingido, o warehouse atribuído é suspenso.

  • Se o warehouse ainda estiver funcionando quando 110% de uso for atingido, ele é suspenso imediatamente.

Criação de um monitor de recursos com um cronograma personalizado¶

Para criar um monitor de recursos que utilize um cronograma diferente do padrão:

Classic Console

1. Use a função ACCOUNTADMIN do sistema.

2. Clique em Account » Resource Monitors » Create Resource Monitor.

3. Digite um nome e uma cota.

4. Especifique se o monitor de recursos será usado para monitorar sua conta ou warehouses individuais.

5. No campo Schedule, clique no link Customize e especifique uma ou mais das seguintes propriedades, conforme desejado:

   • Redefinir créditos usados com base na frequência especificada.

   • Começar a monitorar o uso do crédito imediatamente ou em uma data e hora posterior.

   • Suspender warehouses na data e hora final especificada, independentemente de o limite da cota de crédito ter sido atingido.

6. Insira um limite para pelo menos uma das ações de suspensão. Você também pode especificar até cinco ações de notificação que simplesmente enviam alertas sem suspender nenhum warehouse.

SQL

Execute um comando CREATE RESOURCE MONITOR, com uma ou mais das seguintes propriedades de agendamento:

• FREQUENCY

• START_TIMESTAMP

• END_TIMESTAMP

Por exemplo:

• Para criar um monitor de recursos em nível de conta que começa imediatamente (com base no carimbo de data/hora atual), reinicia mensalmente no mesmo dia, não tem data ou hora final e suspende o warehouse atribuído quando os créditos utilizados alcançarem 100% da cota:

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
      FREQUENCY = MONTHLY
      START_TIMESTAMP = IMMEDIATELY
      TRIGGERS ON 100 PERCENT DO SUSPEND;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  Copy

• Para criar um monitor de recursos que começa em uma data e hora específica no futuro, reinicia semanalmente no mesmo dia, não tem data ou hora final e realiza duas ações diferentes de suspensão em limiares diferentes em dois warehouses atribuídos:

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=2000
      FREQUENCY = WEEKLY
      START_TIMESTAMP = '2019-03-04 00:00 PST'
      TRIGGERS ON 80 PERCENT DO SUSPEND
               ON 100 PERCENT DO SUSPEND_IMMEDIATE;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  
  ALTER WAREHOUSE wh2 SET RESOURCE_MONITOR = limit1;
  

  Copy