ALTER RESOURCE MONITOR

기존 리소스 모니터 의 속성과 트리거를 수정합니다. 이 명령을 사용하여 크레딧 할당량을 증가 또는 감소하거나, 예약 정보를 변경하거나, 리소스 모니터에 대한 트리거를 변경/교체합니다.

참고 항목:

CREATE RESOURCE MONITOR , DROP RESOURCE MONITOR , SHOW RESOURCE MONITORS , ALTER WAREHOUSE , ALTER ACCOUNT

구문

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 ... ] ]
Copy

여기서:

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

매개 변수

name

변경할 리소스 모니터의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

SET ...
CREDIT_QUOTA = num

빈도 간격당 리소스 모니터에 할당된 크레딧 수를 지정합니다. 모니터에 할당된 모든 웨어하우스의 총 사용량이 현재 빈도 간격에 대해 이 수에 도달할 때 리소스 모니터가 할당량의 100% 상태인 것으로 간주됩니다.

리소스 모니터에 대한 값을 지정하지 않으면 모니터에 할당량이 없으며 지정된 간격 내에 100% 사용량에 도달하지 않습니다.

FREQUENCY = MONTHLY | DAILY | WEEKLY | YEARLY | NEVER

크레딧 사용이 0 으로 재설정되는 빈도 간격입니다.

빈도에 NEVER 를 지정하면 웨어하우스의 크레딧 사용이 재설정되지 않습니다.

START_TIMESTAMP = timestamp | IMMEDIATELY

리소스 모니터가 할당된 웨어하우스에 대한 크레딧 사용을 모니터링하기 시작하는 날짜와 시간입니다.

시작 타임스탬프에 대해 IMMEDIATELY 를 지정하면 현재 타임스탬프가 사용됩니다.

시간 없이 날짜를 지정하면 현재 시간이 사용됩니다.

타임존을 지정하지 않고 시간을 설정하면, UTC가 기본 타임존으로 사용됩니다.

END_TIMESTAMP = timestamp

리소스 모니터가 할당된 웨어하우스를 일시 중단하는 날짜와 시간입니다.

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

리소스 모니터에서 이메일 알림을 수신할 사용자 목록을 지정합니다. 사용자 식별자가 공백 또는 특수 문자를 포함하거나 대소문자를 구분하는 경우 식별자는 큰따옴표로 묶어야 합니다(예: “Mary Smith”). 자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

사용자 식별자 user_nameSHOW USERS 의 출력에서 name 열의 값입니다.

나열된 각 사용자는 확인된 이메일 주소를 가지고 있어야 합니다. 웹 인터페이스에서 이메일 주소 확인에 대한 지침은 다음을 참조하십시오.

관리자가 아닌 사용자에 대한 이메일 알림은 관리자에 대한 이메일 알림을 대체하지 않습니다. 이메일 알림을 활성화한 모든 계정 관리자가 계속해서 이메일 알림을 받게 됩니다.

참고

  • 관리자가 아닌 사용자에게는 다음 제한 사항이 적용됩니다.

    • 관리자가 아닌 사용자는 이메일 알림을 받지만 Classic Console 에서는 알림을 볼 수 없습니다.

    • 관리자가 아닌 사용자는 리소스 모니터를 만들 수 없습니다.

    • 알림은 개별 웨어하우스의 리소스 모니터로 제한됩니다. 관리자가 아닌 사용자는 계정 수준 리소스 모니터에 대한 알림을 받을 수 없습니다.

    • 관리자가 아닌 사용자는 알림을 받을 다른 사용자를 지정할 수 없습니다.

TRIGGERS ... (일명 액션)

리소스 모니터에 대한 하나 이상의 트리거를 지정합니다. 각 트리거 정의는 다음으로 구성됩니다.

  • ON threshold PERCENT (사용률. 100 보다 큰 값이 지원됨)

  • DO SUSPEND | SUSPEND_IMMEDIATE | NOTIFY (임계값 도달 시 수행할 작업)

자세한 내용은 CREATE RESOURCE MONITOR 섹션을 참조하십시오.

사용법 노트

  • SUSPEND 또는 SUSPEND_IMMEDIATE 트리거가 리소스 모니터에 대해 활성 상태이고 지정된 빈도 간격에 대한 트리거 임계값에 도달한 경우 할당된 모든 웨어하우스가 시작/다시 시작되지 않도록 함으로써, 이 명령을 사용해 크레딧 할당량을 트리거 임계값 이상으로 늘리거나 트리거를 임계값이 더 높은 새 트리거로 바꿀 수 있습니다.

    리소스 모니터에 대한 크레딧 할당량 또는 트리거 임계값을 늘리면 할당된 웨어하우스를 시작하거나 다시 시작할 수 있습니다.

  • TRIGGERS 매개 변수는 추가적인 것이 아닙니다 (즉, 리소스 모니터에 대한 기존의 모든 트리거를 제거하고 지정된 트리거로 바꿈).

    따라서 기존 트리거에 추가하려면 새 트리거를 지정하고, 또한 기존 트리거도 복제해야 합니다.

  • frequencystart_timestamp 매개 변수가 리소스 모니터에 설정되어 있으면 해당 매개 변수를 기반으로 크레딧 사용량 재설정 날짜가 계산됩니다. 크레딧 사용량이 0 으로 재설정되는 시간은 start_timestamp 에 지정된 시간과 관계없이 오전 12:00 UTC입니다.

  • end_timestamp 를 지정하면 지정된 날짜와 시간에 모니터링이 종료되고 크레딧 할당량에 도달하지 않은 경우에도 해당 날짜와 시간에 할당된 모든 웨어하우스가 일시 중단됩니다.

    이 문제가 발생하면 리소스 모니터가 해당 할당량의 일정 비율에 도달했으며 즉시 일시 중단 작업을 트리거했음을 알리는 알림이 전송됩니다. 할당량의 백분율은 현재 간격에서 종료 날짜까지 사용된 크레딧 수를 반영하며 사용자가 지정한 임계값이 아닐 수도 있습니다.

  • 알림 목록에 관리자가 아닌 사용자가 있는 경우 다음 참고 사항이 적용됩니다.

    • 사용자에게 확인된 이메일이 없으면 SQL 문이 실패합니다.

    • 알림 목록에서 사용자가 이메일 주소를 변경하고 새 이메일 주소를 확인하지 않으면 알림이 자동으로 실패합니다.

    • 알림 목록은 최대 5명의 관리자 아닌 사용자로 제한됩니다.

    • 계정 관리자는 notify_user 열에서 SHOW RESOURCE MONITORS 의 출력에서 관리자가 아닌 사용자의 알림 목록을 볼 수 있습니다.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

리소스 모니터 limiter 에 대한 새 크레딧 할당량을 지정하고 모니터에 대한 기존 트리거를 새 트리거 세트로 바꿉니다.

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

크레딧 할당량의 80%에 도달하면 세 명의 사용자에게 알림을 보내도록 리소스 모니터를 변경합니다. 이 예제에서는 사용자 중 두 명에 대한 user_name 이 공백을 포함하므로 큰따옴표로 묶습니다.

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