ALTER RESOURCE MONITOR¶

Sintaxe¶

ALTER RESOURCE MONITOR [ IF EXISTS ] <name> [ SET { [ CREDIT_QUOTA = <num> ]
                                                    [ FREQUENCY = { MONTHLY | DAILY | WEEKLY | YEARLY | NEVER } ]
                                                    [ START_TIMESTAMP = { <timestamp> | IMMEDIATELY } ]
                                                    [ END_TIMESTAMP = <timestamp> ]
                                                    [ NOTIFY_USERS = ( <user_name> [ , <user_name> , ... ] ) ] } ]
                                            [ TRIGGERS triggerDefinition [ triggerDefinition ... ] ]

Onde:

triggerDefinition ::=
   ON <threshold> PERCENT DO { SUSPEND | SUSPEND_IMMEDIATE | NOTIFY }

Copy

Parâmetros¶

name

Especifica o identificador do monitor de recursos a ser alterado. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

SET ...

CREDIT_QUOTA = num

Especifica o número de créditos alocados ao monitor de recursos por intervalo de frequência. Quando a utilização total de todos os warehouses atribuídos ao monitor atinge este número do intervalo de frequência atual, o monitor de recursos é considerado como tendo 100% da cota.

Se um valor não for especificado para um monitor de recursos, o monitor não tem cota e nunca alcançará 100% de uso dentro do intervalo especificado.

FREQUENCY = MONTHLY | DAILY | WEEKLY | YEARLY | NEVER

O intervalo de frequência no qual o uso de crédito é redefinido como 0.

Se você especificar NEVER para a frequência, o uso de crédito para o warehouse não é reinicializado.

START_TIMESTAMP = timestamp | IMMEDIATELY

A data e hora em que o monitor de recursos começa a monitorar o uso de crédito para os warehouses designados.

Se você especificar IMMEDIATELY para o carimbo de data/hora de início, é usado o carimbo de data/hora atual.

Se você especificar uma data sem hora, a hora atual é utilizada.

Se você definir uma hora sem especificar um fuso horário, UTC será usado como fuso horário padrão.

END_TIMESTAMP = timestamp

A data e a hora em que o monitor de recursos suspende os warehouses designados.

NOTIFY_USERS = ( user_name [ , user_name , ... ] )

Especifica a lista de usuários a receber notificações por e-mail nos monitores de recursos. Se um identificador de usuário incluir espaços ou caracteres especiais ou for sensível a maiúsculas e minúsculas, então o identificador deve ser delimitado por aspas duplas (por exemplo “Mary Smith”). Consulte Requisitos para identificadores para obter mais detalhes.

O identificador do usuário, user_name, é o valor da coluna name da saída de SHOW USERS.

Cada usuário listado deve ter um endereço de e-mail verificado. Para instruções sobre a verificação de endereços de e-mail na interface da web, consulte:

• Para Classic Console: Verificação de seu endereço de e-mail no console clássico.

• Para Snowsight: Verificação do endereço de e-mail.

Notificações por e-mail para usuários não administradores não substituem as notificações por e-mail para administradores. Qualquer administrador de conta que tenha ativado notificações por e-mail continuará a receber notificações por e-mail.

Nota

• As seguintes limitações se aplicam aos usuários não administradores:

  • Os usuários não administradores são notificados por e-mail, mas não podem ver as notificações na Classic Console.

  • Os usuários não administradores não podem criar monitores de recursos.

  • As notificações são limitadas a monitores de recursos em warehouses individuais; usuários não administradores não podem receber notificações sobre monitores de recursos em nível de conta.

  • Os usuários não administradores não podem designar outros usuários para serem notificados.

TRIGGERS ... (também conhecido como ações)

Especifica um ou mais acionadores para o monitor de recursos. Cada definição de acionador consiste em:

• ON threshold PERCENT (porcentagem de uso; valores maiores que 100 são suportados)

• DO SUSPEND | SUSPEND_IMMEDIATE | NOTIFY (ação a ser realizada quando o limite é atingido).

Para obter mais detalhes, consulte CREATE RESOURCE MONITOR.

Notas de uso¶

• Se um acionador SUSPEND ou SUSPEND_IMMEDIATE estiver ativo para um monitor de recursos e o limite de acionamento tiver sido atingido para o intervalo de frequência especificado, impedindo assim que todos os warehouses designados sejam iniciados/retomados, você pode usar este comando para aumentar a cota de crédito acima do limite de acionamento ou substituir o acionador por um novo acionador com um limite mais alto.

  Uma vez que a cota de crédito ou limite de acionamento do monitor de recursos tenha sido aumentado, os warehouses designados podem ser iniciados ou retomados.

• O parâmetro TRIGGERS não é aditivo (ou seja, remove todos os acionadores existentes para o monitor de recursos e os substitui pelos acionadores especificados).

  Como resultado, para fazer adições aos acionadores existentes, é necessário especificar os novos acionadores e replicar os acionadores existentes.

• Se os parâmetros frequency e start_timestamp forem definidos em um monitor de recursos, o dia da redefinição do uso de crédito é calculado com base nesses parâmetros. A hora de redefinição 0 do uso de crédito é 12:00h AM UTC, independentemente da hora especificada em start_timestamp.

• Se você especificar um end_timestamp, o monitoramento terminará na data e hora especificadas e todos os warehouses atribuídos serão suspensos nessa data e hora, mesmo que a cota de crédito não tenha sido atingida.

  Quando isso ocorre, é enviada uma notificação informando que o monitor de recursos atingiu uma porcentagem de sua cota e acionou uma ação imediata de suspensão. A porcentagem da cota reflete o número de créditos usados no intervalo atual até a data de término e pode não ser um limite especificado.

• Se houver usuários não administradores na lista de notificação, as seguintes observações serão aplicadas:

  • Se algum usuário não tiver um e-mail verificado, a instrução SQL falhará.

  • Se qualquer usuário na lista de notificação mudar seu endereço de e-mail e não verificar o novo endereço de e-mail, a notificação silenciosamente falhará.

  • A lista de notificação é limitada a um número máximo de 5 usuários não administradores.

  • Os administradores de conta podem visualizar a lista de notificação de usuários não administradores na saída de SHOW RESOURCE MONITORS na coluna notify_user.

• Em relação aos metadados:

  Atenção

  Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos¶

Especificar uma nova cota de crédito para o monitor de recursos limiter e substituir os acionadores existentes para o monitor por um novo conjunto de acionadores:

ALTER RESOURCE MONITOR limiter
  SET CREDIT_QUOTA=2000
  TRIGGERS ON 80 PERCENT DO NOTIFY
           ON 100 PERCENT DO SUSPEND_IMMEDIATE;

Copy

Alterar um monitor de recursos para enviar notificações a três usuários quando 80% da cota de crédito for atingida. Neste exemplo, o user_name para dois dos usuários inclui um espaço e, portanto, é delimitado por aspas duplas:

ALTER RESOURCE MONITOR limiter
  SET CREDIT_QUOTA = 2000
      NOTIFY_USERS = (JDOE, "Jane Smith", "John Doe")
  TRIGGERS ON 80 PERCENT DO NOTIFY
           ON 100 PERCENT DO SUSPEND_IMMEDIATE

Copy