CREATE ALERT¶

구문¶

CREATE [ OR REPLACE ] ALERT [ IF NOT EXISTS ] <name>
  WAREHOUSE = <warehouse_name>
  SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }'
  COMMENT = '<string_literal>'
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
  IF( EXISTS(
    <condition>
  ))
  THEN
    <action>

베리언트 구문¶

CREATE ALERT … CLONE

동일한 매개 변수 값으로 새 경고를 만듭니다.

CREATE [ OR REPLACE ] ALERT <name> CLONE <source_alert>
  [ ... ]

Copy

자세한 내용은 CREATE <오브젝트> … CLONE 섹션을 참조하십시오.

필수 매개 변수¶

name

경고의 식별자(즉, 이름)를 지정하는 문자열로, 경고가 생성되는 스키마에 대해 고유해야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

WAREHOUSE = warehouse_name

이 경고를 실행하기 위한 컴퓨팅 리소스를 제공하는 가상 웨어하우스를 지정합니다.

SCHEDULE ...

경고의 조건을 주기적으로 평가하기 위한 일정을 지정합니다.

다음 방법 중 하나로 일정을 지정할 수 있습니다.

• USING CRON expr time_zone

  경고의 조건을 주기적으로 평가하기 위한 cron 식과 타임존을 지정합니다. 표준 cron 유틸리티 구문의 서브세트를 지원합니다.

  cron 식은 다음 필드로 구성됩니다.

  # __________ minute (0-59)
  # | ________ hour (0-23)
  # | | ______ day of month (1-31, or L)
  # | | | ____ month (1-12, JAN-DEC)
  # | | | | _ day of week (0-6, SUN-SAT, or L)
  # | | | | |
  # | | | | |
    * * * * *
  

  Copy

  다음 특수 문자가 지원됩니다.

  특수 문자	설명
  *	와일드카드. 지정된 필드에 대해 지정하면 해당 필드에 대해 모든 시간 단위에서 경고가 실행됩니다. 예를 들어 월 필드에 * 를 지정하면 경고가 매달 실행됩니다.
  L	“last(마지막)”를 의미합니다. day-of-month(요일) 필드에 사용하면 해당 월의 “마지막 금요일”(“5L”)과 같은 구문을 지정할 수 있습니다. day-of-month 필드에서는 해당 월의 마지막 요일을 지정합니다.
  /n	주어진 시간 단위의 n 번째 인스턴스를 나타냅니다. 시간의 각 양은 독립적으로 계산됩니다. 예를 들어, 월 필드에 4/3 이 지정된 경우 조건의 평가는 4월, 7월, 10월로 예약됩니다(즉, 해당 연도의 4번째 달부터 3개월마다). 다음 해에도 동일한 일정이 유지됩니다. 즉, 조건은 1월(10월 실행 후 3개월)에 실행되도록 예약되지 않습니다.

  참고

  • cron 식은 현재 지정된 타임존에 대해서만 계산됩니다. 계정에 대한 TIMEZONE 매개 변수 값을 변경하는 것(또는 사용자 또는 세션 수준에서 값을 설정)은 경고의 타임존을 변경하지는 않습니다.

  • cron 식은 경고의 조건 평가를 위한 모든 유효한 시간을 정의합니다. Snowflake는 이 일정에 따라 조건을 평가하려고 시도합니다. 그러나 다음 유효한 실행 시간이 시작되기 전에 이전 실행이 완료되지 않은 경우, 유효한 실행 시간을 건너뜁니다.

  • 특정 일자와 요일이 cron 식에 포함된 경우, 일자 또는 요일 중 하나를 만족하는 날짜에 조건 평가가 예약됩니다. 예를 들어, SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC' 는 해당 월의 10일에서 20일 사이에서 0AM에 평가를 예약하고 해당 날짜 이외의 모든 화요일이나 목요일에도 작업을 예약합니다.

• num MINUTE

  경고 평가 사이에 삽입되는 대기 시간의 간격(분)을 지정합니다. 양의 정수만 허용합니다.

  또한 num M 구문을 지원합니다.

  모호성을 피하기 위해 경고가 재개될 때 기본 간격 시간 이 설정됩니다(ALTER ALERT … RESUME 사용).

  기본 간격 시간은 현재 시계 시간부터 간격 카운터를 시작합니다. 예를 들어 경고가 10 MINUTE 로 생성되고 오전 9:03에 다시 시작될 경우 경고의 조건이 오전 9:13, 오전 9:23 등에 평가됩니다. 당사는 절대 정밀도를 보장하기 위해 최선을 다하지만, 설정된 간격이 발생하기 전에 조건이 평가되지 않는다는 것만 보장합니다(예: 현재 예에서 조건은 오전 9:14에 처음 평가될 수 있지만, 오전 9:12에는 확실히 평가될 수 없음).

  참고

  지원되는 최대값은 11520 (8일)입니다. num MINUTE 값이 더 큰 경고는 조건이 평가된 적 없습니다.

COMMENT = 'string_literal'

경고에 대한 설명을 지정합니다.

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.

IF( EXISTS( condition ))

경고 조건을 나타내는 SQL 문입니다. 다음 명령을 사용할 수 있습니다.

• SELECT

• SHOW <오브젝트>

• CALL

문이 하나 이상의 행을 반환하면 경고에 대한 동작이 실행됩니다.

THEN action

조건이 하나 이상의 행을 반환하는 경우 실행해야 하는 SQL 문입니다.

이메일 알림을 보내려면 SYSTEM$SEND_EMAIL() 저장 프로시저 를 호출하면 됩니다.

액세스 제어 요구 사항¶

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

• 경고는 경고 소유자(즉, 작업에 대한 OWNERSHIP 권한이 있는 역할)에게 부여된 권한을 사용하여 실행됩니다. 경고를 실행하는 데 필요한 최소 권한 목록은 경고 생성 권한 부여하기 섹션을 참조하십시오.

  경고 소유자 역할에 조건과 동작에 대한 SQL 문을 실행하는 데 필요한 권한이 있는지 확인하려면 경고 소유자 역할을 사용하여 이러한 문을 실행한 후에 CREATE ALERT에 지정하는 것이 좋습니다.

• 경고를 생성하면 경고가 기본적으로 일시 중단됩니다.

  경고를 활성화하려면 ALTER ALERT … RESUME 를 실행해야 합니다.

• CREATE ALERT 또는 ALTER ALERT를 실행할 때 다음을 포함하여 조건 및 작업의 문에 대해 일부 유효성 검사가 수행되지 않습니다.

  • 오브젝트 식별자의 확인입니다.

  • 식 데이터 타입의 확인입니다.

  • 함수 호출에서 인자의 수와 유형에 대한 확인입니다.

  조건이나 작업에 대한 SQL 문이 유효하지 않은 식별자, 잘못된 데이터 타입, 잘못된 함수 인자 수 및 유형 등을 지정하는 경우 CREATE ALERT 및 ALTER ALERT 명령은 실패하지 않습니다. 대신 경고 실행 시 오류가 발생합니다.

  기존 경고의 실패 여부를 확인하려면 ALERT_HISTORY 테이블 함수를 사용하십시오.

  이러한 유형의 실패를 방지하려면 알림에 대한 조건과 작업을 지정하기 전에 해당 조건과 작업의 SQL 식과 문을 확인하십시오.

• 메타데이터 관련:

  주의

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

• CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

예¶

경고 만들기 섹션을 참조하십시오.